mangopay4-ruby-sdk 3.44.0

data/lib/mangopay/report_v2.rb

@@ -0,0 +1,21 @@
+module MangoPay
+
+  # See https://docs.mangopay.com/endpoints/v2.01/reporting
+  class ReportV2 < Resource
+
+    class << self
+      def create(params, idempotency_key = nil)
+        MangoPay.request(:post, "#{MangoPay.api_path}/reporting/reports", params, {}, idempotency_key)
+      end
+
+      def get(id)
+        MangoPay.request(:get, "#{MangoPay.api_path}/reporting/reports/#{id}")
+      end
+
+      def get_all(params = nil)
+        MangoPay.request(:get, "#{MangoPay.api_path}/reporting/reports", params)
+      end
+
+    end
+  end
+end

data/lib/mangopay/resource.rb

@@ -0,0 +1,21 @@
+module MangoPay
+  # @abstract
+  class Resource
+    class << self
+      def class_name
+        name.split('::').last
+      end
+
+      def url(id = nil)
+        if self == Resource
+          raise NotImplementedError.new('Resource is an abstract class. Do not use it directly.')
+        end
+        if id
+          "#{MangoPay.api_path}/#{CGI.escape(class_name.downcase)}s/#{CGI.escape(id.to_s)}"
+        else
+          "#{MangoPay.api_path}/#{CGI.escape(class_name.downcase)}s"
+        end
+      end
+    end
+  end
+end

data/lib/mangopay/settlement.rb

@@ -0,0 +1,21 @@
+module MangoPay
+
+  class Settlement < Resource
+    class << self
+      def upload(file, idempotency_key = nil)
+        url = "#{MangoPay.api_path_v3}/payins/intents/settlements"
+        MangoPay.request_multipart(:post, url, file, 'settlement_file.csv', idempotency_key)
+      end
+
+      def get(settlement_id)
+        url = "#{MangoPay.api_path_v3}/payins/intents/settlements/#{settlement_id}"
+        MangoPay.request(:get, url)
+      end
+
+      def update(settlement_id, file, idempotency_key = nil)
+        url = "#{MangoPay.api_path_v3}/payins/intents/settlements/#{settlement_id}"
+        MangoPay.request_multipart(:put, url, file, 'settlement_file.csv', idempotency_key)
+      end
+    end
+  end
+end

data/lib/mangopay/transaction.rb

@@ -0,0 +1,24 @@
+module MangoPay
+  class Transaction < Resource
+    class << self
+      # Fetches list of transactions belonging to the given +wallet_id+.
+      # See also transactions for user: MangoPay::User#transactions
+      #
+      # Optional +filters+ is a hash accepting following keys:
+      # - +page+, +per_page+, +sort+: pagination and sorting params (see MangoPay::HTTPCalls::Fetch::ClassMethods#fetch)
+      # - +Status+: TransactionStatus {CREATED, SUCCEEDED, FAILED}
+      # - +Type+: TransactionType {PAYIN, PAYOUT, TRANSFER}
+      # - +Nature+: TransactionNature {NORMAL, REFUND, REPUDIATION}
+      # - +BeforeDate+ (timestamp): filters transactions with CreationDate _before_ this date
+      # - +AfterDate+ (timestamp): filters transactions with CreationDate _after_ this date
+      # See https://docs.mangopay.com/api-references/sort-lists/
+      def fetch(wallet_id, filters={}, headers = nil)
+        MangoPay.request(:get, url(wallet_id), {}, filters, headers)
+      end
+
+      def url(wallet_id)
+        "#{MangoPay.api_path}/wallets/#{CGI.escape(wallet_id.to_s)}/transactions"
+      end
+    end
+  end
+end

data/lib/mangopay/transfer.rb

@@ -0,0 +1,20 @@
+module MangoPay
+
+  # See http://docs.mangopay.com/api-references/transfers/
+  class Transfer < Resource
+    include HTTPCalls::Create
+    include HTTPCalls::Fetch
+    include HTTPCalls::Refund
+
+    # Fetches list of refunds belonging to given +transfer_id+.
+    #
+    # Optional +filters+ is a hash accepting following keys:
+    # - +page+, +per_page+, +sort+: pagination and sorting params (see MangoPay::HTTPCalls::Fetch::ClassMethods#fetch)
+    # - +Status+: TransactionStatus {CREATED, SUCCEEDED, FAILED}
+    # - +ResultCode+: string representing the transaction result
+    def self.refunds(transfer_id, filters = {})
+      url = url(transfer_id) + '/refunds'
+      MangoPay.request(:get, url, {}, filters)
+    end
+  end
+end

data/lib/mangopay/ubo.rb

@@ -0,0 +1,26 @@
+module MangoPay
+  # Provides API methods for the UBO entity.
+  class Ubo < Resource
+    class << self
+      def url(user_id, ubo_declaration_id, id = nil)
+        if id
+          "#{MangoPay.api_path}/users/#{user_id}/kyc/ubodeclarations/#{ubo_declaration_id}/ubos/#{id}"
+        else
+          "#{MangoPay.api_path}/users/#{user_id}/kyc/ubodeclarations/#{ubo_declaration_id}/ubos"
+        end
+      end
+
+      def create(user_id, ubo_declaration_id, params, idempotency_key = nil)
+        MangoPay.request(:post, url(user_id, ubo_declaration_id), params, {}, idempotency_key)
+      end
+
+      def fetch(user_id, ubo_declaration_id, ubo_id)
+        MangoPay.request(:get, url(user_id, ubo_declaration_id, ubo_id))
+      end
+
+      def update(user_id, ubo_declaration_id, ubo_id, params, idempotency_key = nil)
+        MangoPay.request(:put, url(user_id, ubo_declaration_id, ubo_id), params, {}, idempotency_key)
+      end
+    end
+  end
+end

data/lib/mangopay/ubo_declaration.rb

@@ -0,0 +1,32 @@
+module MangoPay
+  # Provides API methods for the UBO declaration entity.
+  class UboDeclaration < Resource
+    class << self
+      def url(user_id, id = nil)
+        if id
+          "#{MangoPay.api_path}/users/#{user_id}/kyc/ubodeclarations/#{id}"
+        else
+          "#{MangoPay.api_path}/users/#{user_id}/kyc/ubodeclarations"
+        end
+      end
+
+      def create(user_id, idempotency_key = nil)
+        MangoPay.request(:post, url(user_id), {}, {}, idempotency_key)
+      end
+
+      # Fetches the Ubo declaration belonging to the given +user_id+ if given, with the given +id+.
+      def fetch(user_id, id, idempotency_key = nil)
+        url = (user_id) ? url(user_id, id) : "#{MangoPay.api_path}/kyc/ubodeclarations/#{CGI.escape(id.to_s)}"
+        MangoPay.request(:get, url, {}, {}, idempotency_key)
+      end
+
+      def update(user_id, id, params = {}, idempotency_key = nil)
+        request_params = {
+            Status: params['Status'],
+            Ubos: params['Ubos']
+        }
+        MangoPay.request(:put, url(user_id, id), request_params, {}, idempotency_key)
+      end
+    end
+  end
+end

data/lib/mangopay/user.rb

@@ -0,0 +1,100 @@
+module MangoPay
+
+  # See http://docs.mangopay.com/api-references/users/
+  # See also children classes:
+  # - MangoPay::NaturalUser
+  # - MangoPay::LegalUser
+  # - MangoPay::NaturalUserSca
+  # - MangoPay::LegalUserSca
+  class User < Resource
+    include HTTPCalls::Create
+    include HTTPCalls::Update
+    include HTTPCalls::Fetch
+    class << self
+      def enroll_sca(user_id, idempotency_key = nil)
+        url = "#{MangoPay.api_path}/sca/users/#{user_id}/enrollment"
+        MangoPay.request(:post, url, {}, {}, idempotency_key)
+      end
+
+      def manage_consent(user_id, idempotency_key = nil)
+        url = "#{MangoPay.api_path}/sca/users/#{user_id}/consent"
+        MangoPay.request(:post, url, {}, {}, idempotency_key)
+      end
+
+      # Fetches list of wallets belonging to the given +user_id+.
+      # Optional +filters+ is a hash accepting following keys:
+      # - +page+, +per_page+, +sort+: pagination and sorting params (see MangoPay::HTTPCalls::Fetch::ClassMethods#fetch)
+      def wallets(user_id, filters = {})
+        MangoPay.request(:get, url(user_id) + '/wallets', {}, filters)
+      end
+
+      # Fetches list of bank accounts belonging to the given +user_id+.
+      # Optional +filters+ is a hash accepting following keys:
+      # - +page+, +per_page+, +sort+: pagination and sorting params
+      # (see MangoPay::HTTPCalls::Fetch::ClassMethods#fetch)
+      def bank_accounts(user_id, filters = {})
+        MangoPay.request(:get, url(user_id) + '/bankaccounts', {}, filters)
+      end
+
+      # Fetches list of cards belonging to the given +user_id+.
+      # Optional +filters+ is a hash accepting following keys:
+      # - +page+, +per_page+, +sort+: pagination and sorting params (see MangoPay::HTTPCalls::Fetch::ClassMethods#fetch)
+      def cards(user_id, filters = {})
+        MangoPay.request(:get, url(user_id) + '/cards', {}, filters)
+      end
+
+      # Fetches list of transactions belonging to the given +user_id+.
+      # Optional +filters+ is a hash accepting following keys:
+      # - +page+, +per_page+, +sort+: pagination and sorting params (see MangoPay::HTTPCalls::Fetch::ClassMethods#fetch)
+      # - other keys specific for transactions filtering (see MangoPay::Transaction#fetch)
+      def transactions(user_id, filters = {})
+        MangoPay.request(:get, url(user_id) + '/transactions', {}, filters)
+      end
+
+      # View EMoney belonging to the given +user_id+.
+      # Optional +filters+ is a hash accepting following keys:
+      # - +page+, +per_page+, +sort+: pagination and sorting params (see MangoPay::HTTPCalls::Fetch::ClassMethods#fetch)
+      # - other keys specific for transactions filtering (see MangoPay::Transaction#fetch)
+      def emoney(user_id, year, month = nil, filters = {})
+        if month
+          MangoPay.request(:get, url(user_id) + "/emoney/#{year}/#{month}", {}, filters)
+        else
+          MangoPay.request(:get, url(user_id) + "/emoney/#{year}", {}, filters)
+        end
+      end
+
+      # Fetches list of kyc documents belonging to the given +user_id+.
+      # Optional +filters+ is a hash accepting following keys:
+      # - +page+, +per_page+, +sort+, +BeforeDate+, +AfterDate+, +Status+: pagination and sorting params (see MangoPay::HTTPCalls::Fetch::ClassMethods#fetch)
+      def kyc_documents(user_id, filters = {})
+        MangoPay.request(:get, url(user_id) + '/KYC/documents', {}, filters)
+      end
+
+      # Fetches list of pre-authorizations belonging to the given +user_id+.
+      # Optional +filters+ is a hash accepting the following keys:
+      # - +page+, +per_page+, +sort+, +Status+, +ResultCode+, +PaymentStatus+: pagination and sorting/filtering params (see MangoPay::HTTPCalls::Fetch::ClassMethods#fetch)
+      def pre_authorizations(user_id, filters = {})
+        MangoPay.request(:get, url(user_id) + '/preauthorizations', {}, filters)
+      end
+
+      # Fetches User Block Status
+      def block_status(user_id, filters = {})
+        MangoPay.request(:get, url(user_id) + '/blockStatus', {}, filters)
+      end
+
+      # Fetches User Regulatory
+      def regulatory(user_id, filters = {})
+        MangoPay.request(:get, url(user_id) + '/Regulatory', {}, filters)
+      end
+
+      def fetch_sca(user_id)
+        url = "#{MangoPay.api_path}/sca/users/#{user_id}"
+        MangoPay.request(:get, url, {}, {})
+      end
+
+      def validate_data_format(params, idempotency_key = nil)
+        MangoPay.request(:post, "#{MangoPay.api_path}/users/data-formats/validation", params, {}, idempotency_key)
+      end
+    end
+  end
+end

data/lib/mangopay/version.rb

@@ -0,0 +1,3 @@
+module MangoPay
+  VERSION = '3.44.0'
+end

data/lib/mangopay/virtual_account.rb

@@ -0,0 +1,44 @@
+module MangoPay
+
+  class VirtualAccount < Resource
+    class << self
+      # Creates a new virtual account
+      def create(wallet_id, params, idempotency_key = nil)
+        url = "#{MangoPay.api_path}/wallets/#{wallet_id}/virtual-accounts"
+        MangoPay.request(:post, url, params, {}, idempotency_key)
+      end
+
+      # Updates:
+      # - irreversibly deactivates a virtual account with +virtual_account_id+
+      # see https://docs.mangopay.com/api-reference/virtual-accounts/deactivate-virtual-account
+      def deactivate(wallet_id, virtual_account_id, idempotency_key = nil)
+        url = "#{MangoPay.api_path}/wallets/#{wallet_id}/virtual-accounts/#{virtual_account_id}"
+        MangoPay.request(:put, url, {}, {}, idempotency_key)
+      end
+
+      # Fetches:
+      # - view a virtual account with +virtual_account_id+
+      # see https://docs.mangopay.com/api-reference/virtual-accounts/view-virtual-account
+      def fetch(wallet_id, virtual_account_id)
+        url = "#{MangoPay.api_path}/wallets/#{wallet_id}/virtual-accounts/#{virtual_account_id}"
+        MangoPay.request(:get, url, {})
+      end
+
+      # Fetches:
+      # - view virtual accounts for given +wallet_id+
+      # see https://docs.mangopay.com/api-reference/virtual-accounts/list-virtual-accounts-wallet
+      def fetch_all(wallet_id, filters = {})
+        url = "#{MangoPay.api_path}/wallets/#{wallet_id}/virtual-accounts"
+        MangoPay.request(:get, url, {}, filters)
+      end
+
+      # Fetches:
+      # Allows to check which account countries and currencies are available
+      # see https://docs.mangopay.com/api-reference/virtual-accounts/view-virtual-account-availabilities
+      def fetch_availabilities(filters = {})
+        url = "#{MangoPay.api_path}/virtual-accounts/availability"
+        MangoPay.request(:get, url, {}, filters)
+      end
+    end
+  end
+end

data/lib/mangopay/wallet.rb

@@ -0,0 +1,17 @@
+module MangoPay
+
+  # See http://docs.mangopay.com/api-references/wallets/
+  class Wallet < Resource
+    include HTTPCalls::Create
+    include HTTPCalls::Update
+    include HTTPCalls::Fetch
+
+    # Fetches list of transactions belonging to the given +wallet_id+.
+    # Optional +filters+ is a hash accepting following keys:
+    # - +page+, +per_page+, +sort+: pagination and sorting params (see MangoPay::HTTPCalls::Fetch::ClassMethods#fetch)
+    # - other keys specific for transactions filtering (see MangoPay::Transaction.fetch)
+    def self.transactions(wallet_id, filters = {}, headers = nil)
+      Transaction.fetch(wallet_id, filters, headers)
+    end
+  end
+end