mangopay 3.33.0 → 3.35.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e2ea73775e3cbe39be6e8c2ab08353e325e4022c8e880c91ec39a2f7815158a5
-  data.tar.gz: e7a4e7daa408c976653cc7b45bb143e1e7d88b8c8267980bc26a03cd9483e100
+  metadata.gz: e11195066c9596106c5615e858bf1af13f20e4d6f6efa51675158e7d49a8348b
+  data.tar.gz: d789d50dfdb1cb320cc0b4dc0d3b8b7ef12aac1627da49b77abadaa502b855c4
 SHA512:
-  metadata.gz: a237843330abcee5203d85c86fcfcdf4d4e549b1ff3c0662f502d9d064de94de512dd358a26b930a55ae133852bf8aba5b92b91c3f92391806b1cc47797977e4
-  data.tar.gz: c15777f6e7043c031371dcf1aaca92ed2396402c68fa9a3c2d8ab0e8a8cf6bfdb4f516b55602d5fa32ae543bbb9254e0b3fc0f557630e7e1806601d3b4043a02
+  metadata.gz: 3ed3eb963aa03ae1874ecab170480f6f0cae564adc7f98007724ce8f0049be680c9f013965f835e0300fcb6d46fa2497da27aa7faf310b24ca3702de72021609
+  data.tar.gz: 3f3e98a623f39a930ceaa2be9b747c72d7daa987bcb69a8e2a3a1883c0ca4ab93b51a98e69d383c13fc32fb17ec9dbbfb771a55698bfd47618bb15e59010ea08

data/CHANGELOG.md

@@ -1,3 +1,36 @@
+## [3.35.0] - 2025-05-23
+### Added
+
+Support for [30-day deposit preauthorization](https://docs.mangopay.com/guides/payment-methods/card/deposit-preauthorization) features:
+- [POST Create a Deposit Preauthorized PayIn prior to complement](https://docs.mangopay.com/api-reference/deposit-preauthorizations/create-deposit-preauthorized-payin-prior-to-complement)
+- [POST Create a Deposit Preauthorized PayIn complement](https://docs.mangopay.com/api-reference/deposit-preauthorizations/create-deposit-preauthorized-payin-complement)
+- `NO_SHOW_REQUESTED` on `updateDeposit` method for [PUT Cancel a Deposit Preauthorization or request a no-show](https://docs.mangopay.com/api-reference/deposit-preauthorizations/cancel-deposit-preauthorization-request-no-show)
+- [GET View a PayIn (Deposit Preauthorized Card](https://docs.mangopay.com/api-reference/deposit-preauthorizations/view-payin-deposit-preauthorized)
+- [GET List Transactions for a Deposit Preauthorization](https://docs.mangopay.com/api-reference/transactions/list-transactions-deposit-preauthorization)
+
+## [3.34.0] - 2025-05-14
+### Added and refined
+
+#### Hosted KYC/KYB endpoints
+
+The following endpoints have been refined following the beta phase, and are now generally available:
+- [POST Create an IDV Session](https://docs.mangopay.com/api-reference/idv-sessions/create-idv-session) (no changes)
+- [GET View an IDV Session](https://docs.mangopay.com/api-reference/idv-sessions/view-idv-session) (includes `Checks` in response)
+- [GET List IDV Sessions for a User](https://docs.mangopay.com/api-reference/idv-sessions/list-idv-sessions-user) (new endpoint)
+
+The previously available endpoint GET View Checks for an IDV Session has been removed (as Checks were integrated into the GET by ID).
+
+See the [guide](https://docs.mangopay.com/guides/users/verification/hosted) for more details.
+
+#### Recipients
+
+The `Country` property has been added to [Recipients](https://docs.mangopay.com/guides/sca/recipients), as a required query parameter on [GET View the schema for a Recipient](https://docs.mangopay.com/api-reference/recipients/view-recipient-schema) and as a required body parameter on [POST Validate data for a Recipient](https://docs.mangopay.com/api-reference/recipients/validate-recipient-data) and [POST Create a Recipient](https://docs.mangopay.com/api-reference/recipients/create-recipient).
+
+### Added
+
+- [GET List Deposit Preauthorizations for a Card](https://docs.mangopay.com/api-reference/deposit-preauthorizations/list-deposit-preauthorizations-card)
+- [GET List Deposit Preauthorizations for a User](https://docs.mangopay.com/api-reference/deposit-preauthorizations/list-deposit-preauthorizations-user)
+
 ## [3.33.0] - 2025-04-29
 ### Added
 

data/lib/mangopay/deposit.rb

@@ -16,5 +16,21 @@ module MangoPay
       }
       MangoPay.request(:put, "#{MangoPay.api_path}/deposit-preauthorizations/#{deposit_id}", params)
     end
+
+    def self.update(deposit_id, params)
+      MangoPay.request(:put, "#{MangoPay.api_path}/deposit-preauthorizations/#{deposit_id}", params)
+    end
+
+    def self.get_all_for_user(user_id, filters = {})
+      MangoPay.request(:get, "#{MangoPay.api_path}/users/#{user_id}/deposit-preauthorizations", {}, filters)
+    end
+
+    def self.get_all_for_card(card_id, filters = {})
+      MangoPay.request(:get, "#{MangoPay.api_path}/cards/#{card_id}/deposit-preauthorizations", {}, filters)
+    end
+
+    def self.get_transactions(deposit_id, filters = {})
+      MangoPay.request(:get, "#{MangoPay.api_path}/deposit-preauthorizations/#{deposit_id}/transactions", {}, filters)
+    end
   end
 end

data/lib/mangopay/identity_verification.rb

@@ -9,8 +9,8 @@ module MangoPay
       MangoPay.request(:get, "#{MangoPay.api_path}/identity-verifications/#{identity_verification_id}", {}, filters)
     end
 
-    def self.get_checks(identity_verification_id, filters = {})
-      MangoPay.request(:get, "#{MangoPay.api_path}/identity-verifications/#{identity_verification_id}/checks", {}, filters)
+    def self.get_all(user_id, filters = {})
+      MangoPay.request(:get, "#{MangoPay.api_path}/users/#{user_id}/identity-verifications", {}, filters)
     end
   end
 end

data/lib/mangopay/pay_in.rb

@@ -62,6 +62,14 @@ module MangoPay
         def self.create_pre_authorized_deposit_pay_in(params, idempotency_key = nil)
           MangoPay.request(:post, "#{MangoPay.api_path}/payins/deposit-preauthorized/direct/full-capture", params, {}, idempotency_key)
         end
+
+        def self.create_deposit_preauthorized_pay_in_prior_to_complement(params, idempotency_key = nil)
+          MangoPay.request(:post, "#{MangoPay.api_path}/payins/deposit-preauthorized/direct/capture-with-complement", params, {}, idempotency_key)
+        end
+
+        def self.create_deposit_preauthorized_pay_in_complement(params, idempotency_key = nil)
+          MangoPay.request(:post, "#{MangoPay.api_path}/payins/deposit-preauthorized/direct/complement", params, {}, idempotency_key)
+        end
       end
 
     end

data/lib/mangopay/recipient.rb

@@ -13,8 +13,8 @@ module MangoPay
       MangoPay.request(:get, "#{MangoPay.api_path}/users/#{user_id}/recipients", {}, filters)
     end
 
-    def self.get_schema(payout_method_type, recipient_type, currency, filters = {})
-      MangoPay.request(:get, "#{MangoPay.api_path}/recipients/schema?payoutMethodType=#{payout_method_type}&recipientType=#{recipient_type}&currency=#{currency}", {}, filters)
+    def self.get_schema(payout_method_type, recipient_type, currency, country, filters = {})
+      MangoPay.request(:get, "#{MangoPay.api_path}/recipients/schema?payoutMethodType=#{payout_method_type}&recipientType=#{recipient_type}&currency=#{currency}&country=#{country}", {}, filters)
     end
 
     def self.get_payout_methods(country, currency, filters = {})

data/lib/mangopay/version.rb

@@ -1,3 +1,3 @@
 module MangoPay
-  VERSION = '3.33.0'
+  VERSION = '3.35.0'
 end

data/spec/mangopay/client_spec.rb

@@ -40,7 +40,7 @@ describe MangoPay::Client do
   end
 
   describe 'UPLOAD LOGO' do
-    it 'accepts Base64 encoded file content' do
+    xit 'accepts Base64 encoded file content' do
       fnm = __FILE__.sub('.rb', '.png')
       bts = File.open(fnm, 'rb') { |f| f.read }
       b64 = Base64.encode64(bts)
@@ -48,7 +48,7 @@ describe MangoPay::Client do
       expect(ret).to_not be_nil
     end
 
-    it 'accepts file path' do
+    xit 'accepts file path' do
       fnm = __FILE__.sub('.rb', '.png')
       ret = MangoPay::Client.upload_logo(nil, fnm)
       expect(ret).to_not be_nil

data/spec/mangopay/deposit_spec.rb

@@ -24,6 +24,38 @@ describe MangoPay::Deposit do
 
       assert_deposit(fetched_deposit, card_registration['CardId'], author["Id"])
     end
+
+    it 'gets all deposits for a user' do
+      author = new_natural_user
+      card_registration = new_card_registration_completed
+      create_new_deposit(card_registration['CardId'], author['Id'])
+
+      result = MangoPay::Deposit.get_all_for_user(author['Id'])
+      expect(result).to be_kind_of(Array)
+      expect(result.count).to be > 0
+    end
+
+    it 'gets all deposits for a card' do
+      author = new_natural_user
+      card_registration = new_card_registration_completed
+      create_new_deposit(card_registration['CardId'], author['Id'])
+
+      result = MangoPay::Deposit.get_all_for_card(card_registration['CardId'])
+      expect(result).to be_kind_of(Array)
+      expect(result.count).to be > 0
+    end
+
+    it 'fetches transactions for a deposit' do
+      author = new_natural_user
+      wallet = new_wallet
+      card_registration = new_card_registration_completed
+      deposit = create_new_deposit(card_registration['CardId'], author['Id'])
+      create_new_payin_pre_authorized_deposit_direct(deposit['Id'], author['Id'], wallet['Id'])
+
+      transactions = MangoPay::Deposit.get_transactions(deposit['Id'])
+      expect(transactions).to be_kind_of(Array)
+      expect(transactions.count).to be > 0
+    end
   end
 
 # the Cancel flow will be teste manually for now

data/spec/mangopay/identity_verification_spec.rb

@@ -21,22 +21,17 @@ describe MangoPay::IdentityVerification do
       expect(created['ReturnUrl']).to eq(fetched['ReturnUrl'])
       expect(created['Status']).to eq(fetched['Status'])
     end
-  end
 
-  # endpoint returning 404
-  # describe 'GET CHECKS' do
-  #   it 'fetches checks for an existing identity verification' do
-  #     created = create_new_identity_verification
-  #     checks = MangoPay::IdentityVerification.get_checks(created['Id'])
-  #
-  #     expect(checks).not_to be_nil
-  #     expect(created['Id']).to eq(checks['SessionId'])
-  #     expect(checks['Status']).not_to be_nil
-  #     expect(checks['CreationDate']).not_to be_nil
-  #     expect(checks['LastUpdate']).not_to be_nil
-  #     expect(checks['Checks']).not_to be_nil
-  #   end
-  # end
+    it 'fetches all identity verifications for a user' do
+      create_new_identity_verification
+      user = new_natural_user
+      fetched = MangoPay::IdentityVerification.get_all(user['Id'])
+
+      expect(fetched).not_to be_nil
+      expect(fetched).to be_kind_of(Array)
+      expect(fetched).not_to be_empty
+    end
+  end
 
   def create_new_identity_verification
     user = new_natural_user

data/spec/mangopay/payin_preauthorized_direct_spec.rb

@@ -45,7 +45,7 @@ describe MangoPay::PayIn::PreAuthorized::Direct, type: :feature do
     it 'refunds a payin' do
       payin = new_payin_preauthorized_direct
       sleep(2)
-      refund = MangoPay::PayIn.refund(payin['Id'], {AuthorId: payin['AuthorId']})
+      refund = MangoPay::PayIn.refund(payin['Id'], { AuthorId: payin['AuthorId'] })
       expect(refund['Id']).not_to be_nil
       expect(refund['Status']).to eq('SUCCEEDED')
       expect(refund['Type']).to eq('PAYOUT')
@@ -66,26 +66,52 @@ describe MangoPay::PayIn::PreAuthorized::Direct, type: :feature do
       wallets_reload_and_check_amounts(wlt, 1000)
 
       # refund the payin
-      refund = MangoPay::PayIn.refund(payin['Id'], {AuthorId: payin['AuthorId']})
+      refund = MangoPay::PayIn.refund(payin['Id'], { AuthorId: payin['AuthorId'] })
       wallets_reload_and_check_amounts(wlt, 0)
     end
   end
 
-    # this flow is tested manually for the moment
-=begin
-  describe 'CREATE AND VIEW PRE AUTHORIZED DEPOSIT' do
-    it 'creates a card direct pre authorized deposit payin' do
-      wallet = new_wallet
-      author = new_natural_user
-      card_registration = new_card_registration_completed
-      deposit = create_new_deposit(card_registration['CardId'], author['Id'])
+  begin
+    describe 'CREATE AND VIEW PRE AUTHORIZED DEPOSIT' do
+      it 'creates a card direct pre authorized deposit payin' do
+        wallet = new_wallet
+        author = new_natural_user
+        card_registration = new_card_registration_completed
+        deposit = create_new_deposit(card_registration['CardId'], author['Id'])
 
-      created = create_new_payin_pre_authorized_deposit_direct(deposit['Id'], author['Id'], wallet['Id'])
+        created = create_new_payin_pre_authorized_deposit_direct(deposit['Id'], author['Id'], wallet['Id'])
 
-      expect(created['Id']).not_to be_nil
-      check_type_and_status(created)
-      expect(created['DepositId']).to eq(deposit['Id'])
+        expect(created['Id']).not_to be_nil
+        check_type_and_status(created)
+        expect(created['DepositId']).to eq(deposit['Id'])
+      end
+
+      it 'creates a card direct pre authorized deposit payin prior to complement' do
+        wallet = new_wallet
+        author = new_natural_user
+        card_registration = new_card_registration_completed
+        deposit = create_new_deposit(card_registration['CardId'], author['Id'])
+
+        created = create_new_deposit_pre_authorized_pay_in_prior_to_complement(deposit['Id'], author['Id'], wallet['Id'])
+
+        expect(created['Id']).not_to be_nil
+        check_type_and_status(created)
+        expect(created['DepositId']).to eq(deposit['Id'])
+      end
+
+      it 'creates a card direct pre authorized deposit payin complement' do
+        wallet = new_wallet
+        author = new_natural_user
+        card_registration = new_card_registration_completed
+        deposit = create_new_deposit(card_registration['CardId'], author['Id'])
+        MangoPay::Deposit.update(deposit['Id'], {PaymentStatus: 'NO_SHOW_REQUESTED'})
+
+        created = create_new_deposit_pre_authorized_pay_in_complement(deposit['Id'], author['Id'], wallet['Id'])
+
+        expect(created['Id']).not_to be_nil
+        check_type_and_status(created)
+        expect(created['DepositId']).to eq(deposit['Id'])
+      end
     end
   end
-=end
 end

data/spec/mangopay/recipient_spec.rb

@@ -30,7 +30,7 @@ describe MangoPay::Recipient do
 
   describe 'GET Schema' do
     it 'fetches schema for LocalBankTransfer, Individual' do
-      schema = MangoPay::Recipient.get_schema('LocalBankTransfer', 'Individual', 'GBP')
+      schema = MangoPay::Recipient.get_schema('LocalBankTransfer', 'Individual', 'GBP', 'GB')
       expect(schema).not_to be_nil
       expect(schema['DisplayName']).not_to be_nil
       expect(schema['Currency']).not_to be_nil
@@ -42,10 +42,11 @@ describe MangoPay::Recipient do
       expect(schema['LocalBankTransfer']).not_to be_nil
       expect(schema['BusinessRecipient']).to be_nil
       expect(schema['InternationalBankTransfer']).to be_nil
+      expect(schema['Country']).not_to be_nil
     end
 
     it 'fetches schema for InternationalBankTransfer, Business' do
-      schema = MangoPay::Recipient.get_schema('InternationalBankTransfer', 'Business', 'GBP')
+      schema = MangoPay::Recipient.get_schema('InternationalBankTransfer', 'Business', 'GBP', 'GB')
       expect(schema).not_to be_nil
       expect(schema['DisplayName']).not_to be_nil
       expect(schema['Currency']).not_to be_nil
@@ -57,6 +58,7 @@ describe MangoPay::Recipient do
       expect(schema['InternationalBankTransfer']).not_to be_nil
       expect(schema['IndividualRecipient']).to be_nil
       expect(schema['LocalBankTransfer']).to be_nil
+      expect(schema['Country']).not_to be_nil
     end
   end
 
@@ -110,4 +112,5 @@ def assert_recipient(recipient)
   expect(recipient['LocalBankTransfer']).not_to be_nil
   expect(recipient['RecipientScope']).not_to be_nil
   expect(recipient['UserId']).not_to be_nil
+  expect(recipient['Country']).not_to be_nil
 end

data/spec/mangopay/shared_resources.rb

@@ -936,6 +936,28 @@ shared_context 'payins' do
     )
   end
 
+  def create_new_deposit_pre_authorized_pay_in_prior_to_complement(deposit_id, author_id, credited_wallet_id)
+    MangoPay::PayIn::PreAuthorized::Direct.create_deposit_preauthorized_pay_in_prior_to_complement(
+      AuthorId: author_id,
+      CreditedWalletId: credited_wallet_id,
+      DebitedFunds: { Currency: 'EUR', Amount: 1000 },
+      Fees: { Currency: 'EUR', Amount: 0 },
+      DepositId: deposit_id,
+      Tag: 'lorem ipsum'
+    )
+  end
+
+  def create_new_deposit_pre_authorized_pay_in_complement(deposit_id, author_id, credited_wallet_id)
+    MangoPay::PayIn::PreAuthorized::Direct.create_deposit_preauthorized_pay_in_complement(
+      AuthorId: author_id,
+      CreditedWalletId: credited_wallet_id,
+      DebitedFunds: { Currency: 'EUR', Amount: 1000 },
+      Fees: { Currency: 'EUR', Amount: 0 },
+      DepositId: deposit_id,
+      Tag: 'lorem ipsum'
+    )
+  end
+
   ###############################################
   # bankwire/direct
   ###############################################
@@ -1251,6 +1273,7 @@ shared_context 'recipient' do
       "PayoutMethodType": "LocalBankTransfer",
       "RecipientType": "Individual",
       "Currency": "GBP",
+      "Country": "GB",
       "IndividualRecipient": {
         "FirstName": "Alex",
         "LastName": "Smith",

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mangopay
 version: !ruby/object:Gem::Version
-  version: 3.33.0
+  version: 3.35.0
 platform: ruby
 authors:
 - Geoffroy Lorieux
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-04-29 00:00:00.000000000 Z
+date: 2025-05-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: multi_json