mangopay 3.6.0 → 3.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bdb36f26dc6032401dfe30606b77d8368da58389fdae346d1a787971d0963357
-  data.tar.gz: 4d6ad1805512bfd56f6289bb2e482653b1b3167006d7d99d95cf7bb030724eb0
+  metadata.gz: fc045823d669fd8b24b86394f37b4da942dfdcd2ffec8c766c969bef6c8109d2
+  data.tar.gz: e699732cf7cbeb8e9e54e918298913908ac0a88b2103d09b6e5086b1b8464907
 SHA512:
-  metadata.gz: 1344508c23d8b559c672ff2ff6e3e8739d53b7e9d6690f3a5cfdde733b0af8803e4a4adadeb3fe300e373ab0fc2d638707c4d68a48dfb355301db074cea1732e
-  data.tar.gz: 4dab1cab255b3eb58def8ac300c64551541f7ba3f96b3eda1e7bf690439e7ffe6f46167fd7ae80b715bcdc9d4f04bcb969c8c1a290c0f97ed66c3da8dd3cb8b9
+  metadata.gz: c97ac50d3dd3adb9848871d84e385dc22940a431ef85a942c37380ea8403737375ab9054e88f2bce8632ff00237ce4063288ee224db96d89e3edbe4657631414
+  data.tar.gz: 2eae8cc1edb4423c31461acaf7f0d8cd5ab9226e84209d3be12236cc2d1cd0ded88fd1c18166f8810628b684915c966de7b68d7208b93f4a55f65819bc6199e0

data/CHANGELOG.md

@@ -1,3 +1,45 @@
+## [3.9.0] - 2022.03.31
+### Added
+
+#### Instant payment eligibility check
+
+With the function
+`PayOut::InstantPayoutEligibility::Reachability.create(params)`
+the destination bank reachability can now be verified prior to making an instant payout. This results in a better user experience, as this preliminary check will allow the platform to propose the instant payout option only to end users whose bank is eligible.
+
+## [3.8.0] - 2021.10.20
+## Added
+
+You can now change the status to "ENDED" for a recurring payment.
+
+## Fixed
+
+- "Status" is now available in the response when you request a recurring payment registration.
+
+
+## [3.7.0] - 2021.10.11
+## Added
+
+### Payconiq
+
+As requested by numerous clients, we are now providing [Payconiq](https://www.payconiq.be) as a new mean-of-payment. To request access, please contact MANGOPAY.
+
+### Flags for KYC documents
+
+**We provide more information regarding refused KYC documents.** Therefore it will be easier for you to adapt your app behavior and help your end user.
+
+You are now able to see the exact explanation thanks to a new parameter called “Flags”.
+
+It has been added to
+
+`$this->_api->KycDocuments->Get($kycDocument->Id);`
+
+It will display one or several error codes that provide the reason(s) why your document validation has failed. These error codes description are available [here](https://docs.mangopay.com/guide/kyc-document).
+
+## Fixed
+
+Idempotency key is not required anymore for UBO declarations
+
 ## [3.6.0] - 2021.08.10
 ## Added
 

data/lib/mangopay/pay_in.rb

@@ -106,6 +106,17 @@ module MangoPay
 
     end
 
+    module Payconiq
+
+      class Web < Resource
+        include HTTPCalls::Create
+        def self.url(*)
+          "#{MangoPay.api_path}/payins/payconiq/#{CGI.escape(class_name.downcase)}"
+        end
+      end
+
+    end
+
     module ApplePay
       class Direct < Resource
         include HTTPCalls::Create
@@ -129,6 +140,8 @@ module MangoPay
     module RecurringPayments
       class Recurring < Resource
         include HTTPCalls::Create
+        include HTTPCalls::Fetch
+        include HTTPCalls::Update
 
         def self.url(*args)
           if args.any?

data/lib/mangopay/pay_out.rb

@@ -26,5 +26,16 @@ module MangoPay
         MangoPay.request(:get, url);
       end
     end
+
+    # See https://docs.mangopay.com/endpoints/v2.01/payouts#e1058_check-instant-payout-eligibility
+    module InstantPayoutEligibility
+      class Reachability < Resource
+        include HTTPCalls::Create
+
+        def self.url(*)
+          "#{MangoPay.api_path}/payouts/reachability"
+        end
+      end
+    end
   end
 end

data/lib/mangopay/ubo_declaration.rb

@@ -10,17 +10,17 @@ module MangoPay
         end
       end
 
-      def create(user_id, idempotency_key)
+      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)
+      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)
+      def update(user_id, id, params = {}, idempotency_key = nil)
         request_params = {
             Status: params['Status'],
             Ubos: params['Ubos']

data/lib/mangopay/version.rb

@@ -1,3 +1,3 @@
 module MangoPay
-  VERSION = '3.6.0'
+  VERSION = '3.9.0'
 end

data/spec/mangopay/kyc_document_spec.rb

@@ -8,6 +8,7 @@ describe MangoPay::KycDocument do
       expect(new_document['Status']).to eq('CREATED')
       expect(new_document['RefusedReasonType']).to be_nil
       expect(new_document['RefusedReasonMessage']).to be_nil
+      expect(new_document['Flags']).to match_array([])
     end
   end
 

data/spec/mangopay/payin_applepay_direct_spec.rb

@@ -11,7 +11,7 @@ describe MangoPay::PayIn::ApplePay::Direct, type: :feature do
 
   describe 'CREATE' do
     it 'creates a applepay direct payin' do
-      #pending("no cards to test for")
+      pending("no cards to test for")
       created = new_payin_applepay_direct
       expect(created['Id']).not_to be_nil
       check_type_and_status(created)

data/spec/mangopay/payin_payconiq_web_spec.rb

@@ -0,0 +1,25 @@
+describe MangoPay::PayIn::Payconiq::Web, type: :feature do
+  include_context 'payins'
+
+  def check_type_and_status(payin)
+    expect(payin['Type']).to eq('PAYIN')
+    expect(payin['Nature']).to eq('REGULAR')
+    expect(payin['PaymentType']).to eq('PAYCONIQ')
+    expect(payin['ExecutionType']).to eq('WEB')
+
+    # not SUCCEEDED yet: waiting for processing
+    expect(payin['Status']).to eq('CREATED')
+    expect(payin['ResultCode']).to be_nil
+    expect(payin['ResultMessage']).to be_nil
+    expect(payin['ExecutionDate']).to be_nil
+  end
+
+  describe 'CREATE' do
+    it 'creates a payconiq web payin' do
+      created = new_payin_payconiq_web
+      expect(created['Id']).not_to be_nil
+      check_type_and_status(created)
+    end
+  end
+
+end

data/spec/mangopay/payout_bankwire_spec.rb

@@ -49,6 +49,26 @@ describe MangoPay::PayOut::BankWire, type: :feature do
     end
   end
 
+  describe 'Check Eligibility' do
+    it 'checks the eligibility of a payout' do
+      created = new_payout_bankwire
+
+      eligibility = MangoPay::PayOut::InstantPayoutEligibility::Reachability.create(
+        AuthorId: created['AuthorId'],
+        DebitedFunds: {
+          Amount: 10,
+          Currency: 'EUR'
+        },
+        PayoutModeRequested: 'INSTANT_PAYMENT',
+        BankAccountId: created['BankAccountId'],
+        DebitedWalletId: created['DebitedWalletId']
+      )
+
+      expect(created).not_to be_nil
+      expect(eligibility).not_to be_nil
+    end
+  end
+
   describe 'FETCH' do
     it 'fetches a payout' do
       created = new_payout_bankwire

data/spec/mangopay/recurring_payin_spec.rb

@@ -40,6 +40,12 @@ describe MangoPay::PayIn::RecurringPayments, type: :feature do
         }
       )
       expect(recurring).not_to be_nil
+      expect(recurring['Status']).not_to be_nil
+      expect(recurring['Id']).not_to be_nil
+      id = recurring['Id']
+
+      get = MangoPay::PayIn::RecurringPayments::Recurring.fetch(id)
+      expect(get).not_to be_nil
 
       cit = MangoPay::PayIn::RecurringPayments::CIT.create(
         RecurringPayinRegistrationId: recurring['Id'],
@@ -61,6 +67,12 @@ describe MangoPay::PayIn::RecurringPayments, type: :feature do
       )
 
       expect(cit).not_to be_nil
+
+      update = MangoPay::PayIn::RecurringPayments::Recurring.update(id, {
+        Status: 'Ended'
+      })
+
+      expect(update).not_to be_nil
     end
   end
 end

data/spec/mangopay/shared_resources.rb

@@ -215,6 +215,22 @@ shared_context 'payins' do
     )
   end
 
+  ###############################################
+  # payconiq/web
+  ###############################################
+
+  let(:new_payin_payconiq_web) do
+    MangoPay::PayIn::Payconiq::Web.create(
+      AuthorId: new_natural_user['Id'],
+      CreditedWalletId: new_wallet['Id'],
+      DebitedFunds: {Currency: 'EUR', Amount: 100},
+      Fees: {Currency: 'EUR', Amount: 0},
+      ReturnURL: MangoPay.configuration.root_url,
+      Country: "BE",
+      Tag: 'Custom Meta'
+    )
+  end
+
   ###############################################
   # applepay/direct
   ###############################################

data/spec/mangopay/ubo_declaration_spec.rb

@@ -6,9 +6,9 @@ describe MangoPay::UboDeclaration do
     it 'can fetch a UBO declaration' do
       legal_user = new_legal_user
 
-      ubo_declaration = MangoPay::UboDeclaration.create(legal_user['Id'], nil)
+      ubo_declaration = MangoPay::UboDeclaration.create(legal_user['Id'])
 
-      ubo_declaration_byId = MangoPay::UboDeclaration.fetch(legal_user['Id'], ubo_declaration['Id'], nil)
+      ubo_declaration_byId = MangoPay::UboDeclaration.fetch(legal_user['Id'], ubo_declaration['Id'])
 
       expect(ubo_declaration).not_to be_nil
       expect(ubo_declaration_byId).not_to be_nil
@@ -28,13 +28,13 @@ describe MangoPay::UboDeclaration do
     describe 'UPDATE' do
       it 'can update a UBO declaration' do
         legal_user = new_legal_user
-        ubo_declaration = MangoPay::UboDeclaration.create(legal_user['Id'], nil)
+        ubo_declaration = MangoPay::UboDeclaration.create(legal_user['Id'])
         ubo_declaration['Status'] = 'VALIDATION_ASKED'
 
         ubo = new_ubo(legal_user, ubo_declaration)
 
         ubo_declaration['Ubos'] = [ubo]
-        ubo_declaration = MangoPay::UboDeclaration.update(legal_user['Id'], ubo_declaration['Id'], ubo_declaration, nil)
+        ubo_declaration = MangoPay::UboDeclaration.update(legal_user['Id'], ubo_declaration['Id'], ubo_declaration)
 
         expect(ubo_declaration).not_to be_nil
         expect(ubo_declaration['Status']).to eq 'VALIDATION_ASKED'

data/spec/mangopay/ubo_spec.rb

@@ -5,7 +5,7 @@ describe MangoPay::Ubo do
   describe 'FETCH' do
     it 'can fetch a Ubo' do
       legal_user = new_legal_user
-      ubo_declaration = MangoPay::UboDeclaration.create(legal_user['Id'], nil)
+      ubo_declaration = MangoPay::UboDeclaration.create(legal_user['Id'])
       ubo = new_ubo(legal_user, ubo_declaration)
       result = MangoPay::Ubo.fetch(legal_user['Id'], ubo_declaration['Id'], ubo['Id'])
       expect(result).not_to be_nil
@@ -16,7 +16,7 @@ describe MangoPay::Ubo do
   describe 'CREATE' do
     it 'can create a new Ubo' do
       legal_user = new_legal_user
-      ubo_declaration = MangoPay::UboDeclaration.create(legal_user['Id'], nil)
+      ubo_declaration = MangoPay::UboDeclaration.create(legal_user['Id'])
       result = new_ubo(legal_user, ubo_declaration)
       expect(result).not_to be_nil
     end
@@ -25,7 +25,7 @@ describe MangoPay::Ubo do
   describe 'UPDATE' do
     it 'can update a Ubo' do
       legal_user = new_legal_user
-      ubo_declaration = MangoPay::UboDeclaration.create(legal_user['Id'], nil)
+      ubo_declaration = MangoPay::UboDeclaration.create(legal_user['Id'])
       ubo = new_ubo(legal_user, ubo_declaration)
       ubo['FirstName'] = 'Santa'
       ubo['LastName'] = 'Clause'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mangopay
 version: !ruby/object:Gem::Version
-  version: 3.6.0
+  version: 3.9.0
 platform: ruby
 authors:
 - Geoffroy Lorieux
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-08-10 00:00:00.000000000 Z
+date: 2022-03-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: multi_json
@@ -131,6 +131,7 @@ files:
 - spec/mangopay/payin_card_web_spec.rb
 - spec/mangopay/payin_directdebit_direct_spec.rb
 - spec/mangopay/payin_directdebit_web_spec.rb
+- spec/mangopay/payin_payconiq_web_spec.rb
 - spec/mangopay/payin_paypal_web_spec.rb
 - spec/mangopay/payin_preauthorized_direct_spec.rb
 - spec/mangopay/payout_bankwire_spec.rb
@@ -196,6 +197,7 @@ test_files:
 - spec/mangopay/payin_card_web_spec.rb
 - spec/mangopay/payin_directdebit_direct_spec.rb
 - spec/mangopay/payin_directdebit_web_spec.rb
+- spec/mangopay/payin_payconiq_web_spec.rb
 - spec/mangopay/payin_paypal_web_spec.rb
 - spec/mangopay/payin_preauthorized_direct_spec.rb
 - spec/mangopay/payout_bankwire_spec.rb