mangopay 3.0.25.pre.alpha.pre.20 → 3.0.25

data/lib/mangopay/authorization_token.rb

@@ -1,88 +1,88 @@
-module MangoPay
-  module AuthorizationToken
-
-    # See http://docs.mangopay.com/api-references/authenticating/
-    class Manager
-
-      class << self
-        def storage
-          @@storage ||= StaticStorage.new
-        end
-
-        def storage= (storage)
-          @@storage = storage
-        end
-
-        def get_token
-          token = storage.get
-          env_key = get_environment_key_for_token
-          if token.nil? || token['timestamp'].nil? || token['timestamp'] <= Time.now || token['environment_key'] != env_key
-            token = MangoPay.request(:post, "/#{MangoPay.version_code}/oauth/token", {}, {}, {}, Proc.new do |req|
-              cfg = MangoPay.configuration
-              req.basic_auth cfg.client_id, cfg.client_passphrase
-              req.body = 'grant_type=client_credentials'
-            end)
-            token['timestamp'] = Time.now + (token['expires_in'].to_i - 10)
-            token['environment_key'] = env_key
-            storage.store token
-          end
-          token
-        end
-
-        def get_environment_key_for_token
-          cfg = MangoPay.configuration
-          key = "#{cfg.root_url}|#{cfg.client_id}|#{cfg.client_passphrase}"
-          key = Digest::MD5.hexdigest(key)
-          key
-        end
-      end
-    end
-
-    class StaticStorage
-      def get
-        @@token ||= nil
-      end
-
-      def store(token)
-        @@token = token
-      end
-    end
-
-    class FileStorage
-      require 'yaml'
-      @temp_dir
-
-      def initialize(temp_dir = nil)
-        @temp_dir = temp_dir || MangoPay.configuration.temp_dir
-        if !@temp_dir
-          raise "Path to temporary folder is not defined"
-        end
-      end
-
-      def get
-        begin
-          f = File.open(file_path, File::RDONLY)
-          f.flock(File::LOCK_SH)
-          txt = f.read
-          f.close
-          YAML.load(txt) || nil
-        rescue Errno::ENOENT
-          nil
-        end
-      end
-
-      def store(token)
-        File.open(file_path, File::RDWR|File::CREAT, 0644) do |f|
-          f.flock(File::LOCK_EX)
-          f.truncate(0)
-          f.rewind
-          f.puts(YAML.dump(token))
-        end
-      end
-
-      def file_path
-        File.join(@temp_dir, "MangoPay.AuthorizationToken.FileStore.tmp")
-      end
-    end
-  end
-end
+module MangoPay
+  module AuthorizationToken
+
+    # See http://docs.mangopay.com/api-references/authenticating/
+    class Manager
+
+      class << self
+        def storage
+          @@storage ||= StaticStorage.new
+        end
+
+        def storage= (storage)
+          @@storage = storage
+        end
+
+        def get_token
+          token = storage.get
+          env_key = get_environment_key_for_token
+          if token.nil? || token['timestamp'].nil? || token['timestamp'] <= Time.now || token['environment_key'] != env_key
+            token = MangoPay.request(:post, "/#{MangoPay.version_code}/oauth/token", {}, {}, {}, Proc.new do |req|
+              cfg = MangoPay.configuration
+              req.basic_auth cfg.client_id, cfg.client_passphrase
+              req.body = 'grant_type=client_credentials'
+            end)
+            token['timestamp'] = Time.now + (token['expires_in'].to_i - 10)
+            token['environment_key'] = env_key
+            storage.store token
+          end
+          token
+        end
+
+        def get_environment_key_for_token
+          cfg = MangoPay.configuration
+          key = "#{cfg.root_url}|#{cfg.client_id}|#{cfg.client_passphrase}"
+          key = Digest::MD5.hexdigest(key)
+          key
+        end
+      end
+    end
+
+    class StaticStorage
+      def get
+        @@token ||= nil
+      end
+
+      def store(token)
+        @@token = token
+      end
+    end
+
+    class FileStorage
+      require 'yaml'
+      @temp_dir
+
+      def initialize(temp_dir = nil)
+        @temp_dir = temp_dir || MangoPay.configuration.temp_dir
+        if !@temp_dir
+          raise "Path to temporary folder is not defined"
+        end
+      end
+
+      def get
+        begin
+          f = File.open(file_path, File::RDONLY)
+          f.flock(File::LOCK_SH)
+          txt = f.read
+          f.close
+          YAML.load(txt) || nil
+        rescue Errno::ENOENT
+          nil
+        end
+      end
+
+      def store(token)
+        File.open(file_path, File::RDWR|File::CREAT, 0644) do |f|
+          f.flock(File::LOCK_EX)
+          f.truncate(0)
+          f.rewind
+          f.puts(YAML.dump(token))
+        end
+      end
+
+      def file_path
+        File.join(@temp_dir, "MangoPay.AuthorizationToken.FileStore.tmp")
+      end
+    end
+  end
+end

data/lib/mangopay/bank_account.rb

@@ -1,38 +1,38 @@
-module MangoPay
-
-  # See http://docs.mangopay.com/api-references/bank-accounts/
-  class BankAccount < Resource
-    include HTTPCalls::Fetch
-    class << self
-      def create(user_id, params, idempotency_key = nil)
-        type = params.fetch(:Type) { |no_symbol_key| params.fetch('Type') }
-        MangoPay.request(:post, "#{url(user_id)}/#{type}", params, {}, idempotency_key)
-      end
-
-      # Fetches:
-      # - list of bank accounts belonging to the given +user_id+
-      # - or single bank account belonging to the given +user_id+ with the given +bank_account_id+.
-      #
-      # In case of list query, optional +filters+ is a hash accepting pagination and sorting params
-      # (+page+, +per_page+, +sort+; see MangoPay::HTTPCalls::Fetch::ClassMethods#fetch)
-      #
-      def fetch(user_id, bank_account_id_or_filters={})
-        bank_account_id, filters = HTTPCalls::Fetch.parse_id_or_filters(bank_account_id_or_filters)
-        MangoPay.request(:get, url(user_id, bank_account_id), {}, filters)
-      end
-
-      # see https://docs.mangopay.com/endpoints/v2.01/bank-accounts#e306_disactivate-a-bank-account
-      def update(user_id, bank_account_id, params = {})
-        MangoPay.request(:put, url(user_id, bank_account_id), params)
-      end
-
-      def url(user_id, bank_account_id = nil)
-        if bank_account_id
-          "#{MangoPay.api_path}/users/#{CGI.escape(user_id.to_s)}/bankaccounts/#{CGI.escape(bank_account_id.to_s)}"
-        else
-          "#{MangoPay.api_path}/users/#{CGI.escape(user_id.to_s)}/bankaccounts"
-        end
-      end
-    end
-  end
-end
+module MangoPay
+
+  # See http://docs.mangopay.com/api-references/bank-accounts/
+  class BankAccount < Resource
+    include HTTPCalls::Fetch
+    class << self
+      def create(user_id, params, idempotency_key = nil)
+        type = params.fetch(:Type) { |no_symbol_key| params.fetch('Type') }
+        MangoPay.request(:post, "#{url(user_id)}/#{type}", params, {}, idempotency_key)
+      end
+
+      # Fetches:
+      # - list of bank accounts belonging to the given +user_id+
+      # - or single bank account belonging to the given +user_id+ with the given +bank_account_id+.
+      #
+      # In case of list query, optional +filters+ is a hash accepting pagination and sorting params
+      # (+page+, +per_page+, +sort+; see MangoPay::HTTPCalls::Fetch::ClassMethods#fetch)
+      #
+      def fetch(user_id, bank_account_id_or_filters={})
+        bank_account_id, filters = HTTPCalls::Fetch.parse_id_or_filters(bank_account_id_or_filters)
+        MangoPay.request(:get, url(user_id, bank_account_id), {}, filters)
+      end
+
+      # see https://docs.mangopay.com/endpoints/v2.01/bank-accounts#e306_disactivate-a-bank-account
+      def update(user_id, bank_account_id, params = {})
+        MangoPay.request(:put, url(user_id, bank_account_id), params)
+      end
+
+      def url(user_id, bank_account_id = nil)
+        if bank_account_id
+          "#{MangoPay.api_path}/users/#{CGI.escape(user_id.to_s)}/bankaccounts/#{CGI.escape(bank_account_id.to_s)}"
+        else
+          "#{MangoPay.api_path}/users/#{CGI.escape(user_id.to_s)}/bankaccounts"
+        end
+      end
+    end
+  end
+end

data/lib/mangopay/card.rb

@@ -1,8 +1,8 @@
-module MangoPay
-
-  # See http://docs.mangopay.com/api-references/card/
-  class Card < Resource
-    include HTTPCalls::Fetch
-    include HTTPCalls::Update
-  end
-end
+module MangoPay
+
+  # See http://docs.mangopay.com/api-references/card/
+  class Card < Resource
+    include HTTPCalls::Fetch
+    include HTTPCalls::Update
+  end
+end

data/lib/mangopay/card_registration.rb

@@ -1,9 +1,9 @@
-module MangoPay
-
-  # See http://docs.mangopay.com/api-references/card-registration/
-  class CardRegistration < Resource
-    include HTTPCalls::Create
-    include HTTPCalls::Update
-    include HTTPCalls::Fetch
-  end
-end
+module MangoPay
+
+  # See http://docs.mangopay.com/api-references/card-registration/
+  class CardRegistration < Resource
+    include HTTPCalls::Create
+    include HTTPCalls::Update
+    include HTTPCalls::Fetch
+  end
+end

data/lib/mangopay/client.rb

@@ -1,74 +1,74 @@
-require 'base64'
-
-module MangoPay
-  class Client < Resource
-
-    class << self
-
-      # see https://docs.mangopay.com/api-references/client-details/
-      def fetch()
-        MangoPay.request(:get, url())
-      end
-
-      # see https://docs.mangopay.com/api-references/client-details/
-      def update(params)
-        MangoPay.request(:put, url(), params)
-      end
-
-      # see https://docs.mangopay.com/api-references/client-details/
-      def upload_logo(file_content_base64, file_path = nil)
-        if file_content_base64.nil? && !file_path.nil?
-          bts = File.open(file_path, 'rb') { |f| f.read }
-          file_content_base64 = Base64.encode64(bts)
-        end
-        # normally it returns 204 HTTP code on success
-        begin
-          MangoPay.request(:put, url() + '/logo', {'File' => file_content_base64})
-        rescue ResponseError => ex
-          raise ex unless ex.code == '204'
-        end
-      end
-
-      # Fetch all your client wallets;
-      # +funds_type+ may be:
-      #   - nil: all wallets
-      #   - 'fees': fees wallets
-      #   - 'credit': credit wallets
-      # see https://docs.mangopay.com/api-references/client-wallets/
-      def fetch_wallets(funds_type = nil)
-        MangoPay.request(:get, url() + "/wallets/#{funds_type}")
-      end
-
-      # Fetch one of your client wallets (fees or credit) with a particular currency;
-      # +funds_type+ may be:
-      #   - nil: all wallets
-      #   - 'fees': fees wallets
-      #   - 'credit': credit wallets
-      # +currency_iso_code+ is currncy ISO code
-      # see https://docs.mangopay.com/api-references/client-wallets/
-      def fetch_wallet(funds_type, currency_iso_code)
-        MangoPay.request(:get, url() + "/wallets/#{funds_type}/#{currency_iso_code}")
-      end
-
-      # Fetch transactions for all your client wallets.
-      # Optional +filters+ hash: see MangoPay::Transaction.fetch
-      # See https://docs.mangopay.com/api-references/client-wallets/
-      def fetch_wallets_transactions(filters = {})
-        MangoPay.request(:get, url() + "/transactions", {}, filters)
-      end
-
-      # Fetch transactions for one of your client wallets (fees or credit) with a particular currency;
-      # +funds_type+ may be:
-      #   - nil: all wallets
-      #   - 'fees': fees wallets
-      #   - 'credit': credit wallets
-      # +currency_iso_code+ is currncy ISO code
-      # Optional +filters+ hash: see MangoPay::Transaction.fetch
-      # See https://docs.mangopay.com/api-references/client-wallets/
-      def fetch_wallet_transactions(funds_type, currency_iso_code, filters = {})
-        MangoPay.request(:get, url() + "/wallets/#{funds_type}/#{currency_iso_code}/transactions", {}, filters)
-      end
-
-    end
-  end
-end
+require 'base64'
+
+module MangoPay
+  class Client < Resource
+
+    class << self
+
+      # see https://docs.mangopay.com/api-references/client-details/
+      def fetch()
+        MangoPay.request(:get, url())
+      end
+
+      # see https://docs.mangopay.com/api-references/client-details/
+      def update(params)
+        MangoPay.request(:put, url(), params)
+      end
+
+      # see https://docs.mangopay.com/api-references/client-details/
+      def upload_logo(file_content_base64, file_path = nil)
+        if file_content_base64.nil? && !file_path.nil?
+          bts = File.open(file_path, 'rb') { |f| f.read }
+          file_content_base64 = Base64.encode64(bts)
+        end
+        # normally it returns 204 HTTP code on success
+        begin
+          MangoPay.request(:put, url() + '/logo', {'File' => file_content_base64})
+        rescue ResponseError => ex
+          raise ex unless ex.code == '204'
+        end
+      end
+
+      # Fetch all your client wallets;
+      # +funds_type+ may be:
+      #   - nil: all wallets
+      #   - 'fees': fees wallets
+      #   - 'credit': credit wallets
+      # see https://docs.mangopay.com/api-references/client-wallets/
+      def fetch_wallets(funds_type = nil)
+        MangoPay.request(:get, url() + "/wallets/#{funds_type}")
+      end
+
+      # Fetch one of your client wallets (fees or credit) with a particular currency;
+      # +funds_type+ may be:
+      #   - nil: all wallets
+      #   - 'fees': fees wallets
+      #   - 'credit': credit wallets
+      # +currency_iso_code+ is currncy ISO code
+      # see https://docs.mangopay.com/api-references/client-wallets/
+      def fetch_wallet(funds_type, currency_iso_code)
+        MangoPay.request(:get, url() + "/wallets/#{funds_type}/#{currency_iso_code}")
+      end
+
+      # Fetch transactions for all your client wallets.
+      # Optional +filters+ hash: see MangoPay::Transaction.fetch
+      # See https://docs.mangopay.com/api-references/client-wallets/
+      def fetch_wallets_transactions(filters = {})
+        MangoPay.request(:get, url() + "/transactions", {}, filters)
+      end
+
+      # Fetch transactions for one of your client wallets (fees or credit) with a particular currency;
+      # +funds_type+ may be:
+      #   - nil: all wallets
+      #   - 'fees': fees wallets
+      #   - 'credit': credit wallets
+      # +currency_iso_code+ is currncy ISO code
+      # Optional +filters+ hash: see MangoPay::Transaction.fetch
+      # See https://docs.mangopay.com/api-references/client-wallets/
+      def fetch_wallet_transactions(funds_type, currency_iso_code, filters = {})
+        MangoPay.request(:get, url() + "/wallets/#{funds_type}/#{currency_iso_code}/transactions", {}, filters)
+      end
+
+    end
+  end
+end

data/lib/mangopay/dispute.rb

@@ -1,130 +1,130 @@
-require 'base64'
-
-module MangoPay
-
-  # See https://docs.mangopay.com/api-references/disputes/disputes/
-  class Dispute < Resource
-    include HTTPCalls::Fetch
-    include HTTPCalls::Update
-    class << self
-
-      def close(dispute_id)
-        url = url(dispute_id) + "/close/"
-        MangoPay.request(:put, url)
-      end
-
-      # +contested_funds+: Money hash
-      # see 'Contest' section @ https://docs.mangopay.com/api-references/disputes/disputes/
-      def contest(dispute_id, contested_funds)
-        url = url(dispute_id) + "/submit/"
-        MangoPay.request(:put, url, {ContestedFunds: contested_funds})
-      end
-
-      def resubmit(dispute_id)
-        url = url(dispute_id) + "/submit/"
-        MangoPay.request(:put, url)
-      end
-
-      def transactions(dispute_id, filters = {})
-        url = url(dispute_id) + "/transactions/"
-        MangoPay.request(:get, url, {}, filters)
-      end
-
-      def fetch_for_user(user_id, filters = {})
-        url = "#{MangoPay.api_path}/users/#{user_id}/disputes"
-        MangoPay.request(:get, url, {}, filters)
-      end
-
-      def fetch_for_wallet(wallet_id, filters = {})
-        url = "#{MangoPay.api_path}/wallets/#{wallet_id}/disputes"
-        MangoPay.request(:get, url, {}, filters)
-      end
-      
-      #####################################################
-      # repudiations / settlement transfers
-      #####################################################
-
-      # see https://docs.mangopay.com/api-references/disputes/repudiations/
-      def fetch_repudiation(repudiation_id)
-        url = "#{MangoPay.api_path}/repudiations/#{repudiation_id}"
-        MangoPay.request(:get, url)
-      end
-
-      # +params+: hash; see https://docs.mangopay.com/api-references/disputes/settlement-transfers/
-      def create_settlement_transfer(repudiation_id, params, idempotency_key = nil)
-        url = "#{MangoPay.api_path}/repudiations/#{repudiation_id}/settlementtransfer/"
-        MangoPay.request(:post, url, params, {}, idempotency_key)
-      end
-
-      # see https://docs.mangopay.com/api-references/disputes/settlement-transfers/
-      def fetch_settlement_transfer(transfer_id)
-        url = "#{MangoPay.api_path}/settlements/#{transfer_id}"
-        MangoPay.request(:get, url)
-      end
-      
-      #####################################################
-      # documents
-      #####################################################
-
-      # +params+: hash; see https://docs.mangopay.com/api-references/disputes/dispute-documents/
-      def create_document(dispute_id, params, idempotency_key = nil)
-        url = url(dispute_id) + "/documents/"
-        MangoPay.request(:post, url, params, {}, idempotency_key)
-      end
-
-      def fetch_document(document_id)
-        url = "#{MangoPay.api_path}/dispute-documents/#{document_id}"
-        MangoPay.request(:get, url)
-      end
-
-      # +params+: hash; see 'Edit' section @ https://docs.mangopay.com/api-references/disputes/dispute-documents/
-      def update_document(dispute_id, document_id, params)
-        url = url(dispute_id) + "/documents/#{document_id}"
-        MangoPay.request(:put, url, params)
-      end
-
-      # Fetches list of dispute documents:
-      # - for the particular dispute if +dispute_id+ is provided (not nil)
-      # - or for all disputes otherwise.
-      # 
-      # Optional +filters+ is a hash accepting following keys:
-      # - +page+, +per_page+, +sort+: pagination and sorting params (see MangoPay::HTTPCalls::Fetch::ClassMethods#fetch)
-      # - filters such as +Type+ (e.g. 'REFUND_PROOF') and +Status+ (e.g. 'VALIDATED')
-      # - +BeforeDate+ (timestamp): filters documents with CreationDate _before_ this date
-      # - +AfterDate+ (timestamp): filters documents with CreationDate _after_ this date
-      # 
-      # See https://docs.mangopay.com/api-references/disputes/dispute-documents/
-      #
-      def fetch_documents(dispute_id = nil, filters = {})
-        url = (dispute_id) ? url(dispute_id) + "/documents/" : "#{MangoPay.api_path}/dispute-documents/"
-        MangoPay.request(:get, url, {}, filters)
-      end
-
-      # Adds the file page (attachment) to the given document.
-      # 
-      # See https://docs.mangopay.com/api-references/disputes/dispute-document-pages/ :
-      # - Document have to be in 'CREATED' Status
-      # - You can create as many pages as needed
-      # - Change Status to 'VALIDATION_ASKED' to submit dispute documents
-      # 
-      # The file_content_base64 param may be:
-      # - Base64 encoded file content
-      # - or nil: in this case pass the file path in the next param
-      #
-      def create_document_page(dispute_id, document_id, file_content_base64, file_path = nil, idempotency_key = nil)
-        if file_content_base64.nil? && !file_path.nil?
-          bts = File.open(file_path, 'rb') { |f| f.read }
-          file_content_base64 = Base64.encode64(bts)
-        end
-        # normally it returns 204 HTTP code on success
-        begin
-          url = url(dispute_id) + "/documents/#{document_id}/pages"
-          MangoPay.request(:post, url, {'File' => file_content_base64}, {}, idempotency_key)
-        rescue ResponseError => ex
-          raise ex unless ex.code == '204'
-        end
-      end
-
-    end
-  end
-end
+require 'base64'
+
+module MangoPay
+
+  # See https://docs.mangopay.com/api-references/disputes/disputes/
+  class Dispute < Resource
+    include HTTPCalls::Fetch
+    include HTTPCalls::Update
+    class << self
+
+      def close(dispute_id)
+        url = url(dispute_id) + "/close/"
+        MangoPay.request(:put, url)
+      end
+
+      # +contested_funds+: Money hash
+      # see 'Contest' section @ https://docs.mangopay.com/api-references/disputes/disputes/
+      def contest(dispute_id, contested_funds)
+        url = url(dispute_id) + "/submit/"
+        MangoPay.request(:put, url, {ContestedFunds: contested_funds})
+      end
+
+      def resubmit(dispute_id)
+        url = url(dispute_id) + "/submit/"
+        MangoPay.request(:put, url)
+      end
+
+      def transactions(dispute_id, filters = {})
+        url = url(dispute_id) + "/transactions/"
+        MangoPay.request(:get, url, {}, filters)
+      end
+
+      def fetch_for_user(user_id, filters = {})
+        url = "#{MangoPay.api_path}/users/#{user_id}/disputes"
+        MangoPay.request(:get, url, {}, filters)
+      end
+
+      def fetch_for_wallet(wallet_id, filters = {})
+        url = "#{MangoPay.api_path}/wallets/#{wallet_id}/disputes"
+        MangoPay.request(:get, url, {}, filters)
+      end
+      
+      #####################################################
+      # repudiations / settlement transfers
+      #####################################################
+
+      # see https://docs.mangopay.com/api-references/disputes/repudiations/
+      def fetch_repudiation(repudiation_id)
+        url = "#{MangoPay.api_path}/repudiations/#{repudiation_id}"
+        MangoPay.request(:get, url)
+      end
+
+      # +params+: hash; see https://docs.mangopay.com/api-references/disputes/settlement-transfers/
+      def create_settlement_transfer(repudiation_id, params, idempotency_key = nil)
+        url = "#{MangoPay.api_path}/repudiations/#{repudiation_id}/settlementtransfer/"
+        MangoPay.request(:post, url, params, {}, idempotency_key)
+      end
+
+      # see https://docs.mangopay.com/api-references/disputes/settlement-transfers/
+      def fetch_settlement_transfer(transfer_id)
+        url = "#{MangoPay.api_path}/settlements/#{transfer_id}"
+        MangoPay.request(:get, url)
+      end
+      
+      #####################################################
+      # documents
+      #####################################################
+
+      # +params+: hash; see https://docs.mangopay.com/api-references/disputes/dispute-documents/
+      def create_document(dispute_id, params, idempotency_key = nil)
+        url = url(dispute_id) + "/documents/"
+        MangoPay.request(:post, url, params, {}, idempotency_key)
+      end
+
+      def fetch_document(document_id)
+        url = "#{MangoPay.api_path}/dispute-documents/#{document_id}"
+        MangoPay.request(:get, url)
+      end
+
+      # +params+: hash; see 'Edit' section @ https://docs.mangopay.com/api-references/disputes/dispute-documents/
+      def update_document(dispute_id, document_id, params)
+        url = url(dispute_id) + "/documents/#{document_id}"
+        MangoPay.request(:put, url, params)
+      end
+
+      # Fetches list of dispute documents:
+      # - for the particular dispute if +dispute_id+ is provided (not nil)
+      # - or for all disputes otherwise.
+      # 
+      # Optional +filters+ is a hash accepting following keys:
+      # - +page+, +per_page+, +sort+: pagination and sorting params (see MangoPay::HTTPCalls::Fetch::ClassMethods#fetch)
+      # - filters such as +Type+ (e.g. 'REFUND_PROOF') and +Status+ (e.g. 'VALIDATED')
+      # - +BeforeDate+ (timestamp): filters documents with CreationDate _before_ this date
+      # - +AfterDate+ (timestamp): filters documents with CreationDate _after_ this date
+      # 
+      # See https://docs.mangopay.com/api-references/disputes/dispute-documents/
+      #
+      def fetch_documents(dispute_id = nil, filters = {})
+        url = (dispute_id) ? url(dispute_id) + "/documents/" : "#{MangoPay.api_path}/dispute-documents/"
+        MangoPay.request(:get, url, {}, filters)
+      end
+
+      # Adds the file page (attachment) to the given document.
+      # 
+      # See https://docs.mangopay.com/api-references/disputes/dispute-document-pages/ :
+      # - Document have to be in 'CREATED' Status
+      # - You can create as many pages as needed
+      # - Change Status to 'VALIDATION_ASKED' to submit dispute documents
+      # 
+      # The file_content_base64 param may be:
+      # - Base64 encoded file content
+      # - or nil: in this case pass the file path in the next param
+      #
+      def create_document_page(dispute_id, document_id, file_content_base64, file_path = nil, idempotency_key = nil)
+        if file_content_base64.nil? && !file_path.nil?
+          bts = File.open(file_path, 'rb') { |f| f.read }
+          file_content_base64 = Base64.encode64(bts)
+        end
+        # normally it returns 204 HTTP code on success
+        begin
+          url = url(dispute_id) + "/documents/#{document_id}/pages"
+          MangoPay.request(:post, url, {'File' => file_content_base64}, {}, idempotency_key)
+        rescue ResponseError => ex
+          raise ex unless ex.code == '204'
+        end
+      end
+
+    end
+  end
+end