mangopay 3.32.0 → 3.34.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c8e3054c801c2db4879dc5ee322b442204351fd2c96458345b865c7f30a8accf
-  data.tar.gz: e59f212b984b311a3999c1f768532798c072d60f40d692d1a90ae755a81a01d7
+  metadata.gz: 9a183b9490a45fa73745d864f9643d9afec4e4ea56b002784e2b888ae7886b7b
+  data.tar.gz: 4079521fab8f807345c218e00510e5197d4cb05d8afc4cbd4a332e5231650100
 SHA512:
-  metadata.gz: 74ce73c93504fbecef0a12d7ff98bd5f192700b90cf0e555063af16fabf88ffbdf6cb88e973e705f642e870c239bf306c624d97f8c8cc021008e88638cd9d6a1
-  data.tar.gz: d48f4c254375d55ddd36e911fb7f84cd18f8eeb96ed28081501ed745249abacad3fd6a35ede4e6be972196c0611675e259fea41cdb8e0cee0687cd5d296e0a86
+  metadata.gz: 1bb4ea160e1a0f9c93032320a1be553b669b7cc1f07c2b27d822ff7cc22e6015237666bc284f7304ad9d2302cfa9c963db75b81dfcae39645468efb717735c25
+  data.tar.gz: 2ee8715ac0e1bc4a96f8773f5bef406fa229a8f7d980b9813e539a4aaa4735451600f130046ae0810921e11e1ae0549d0850c1f1d7b98354228f9fe7c7f6c160

data/.github/workflows/ruby_cd.yml

@@ -1,4 +1,4 @@
-name: mangopay2-net-ruby-cd
+name: mangopay2-ruby-cd
 
 on:
   push:

data/.github/workflows/ruby_ci.yml

@@ -1,4 +1,4 @@
-name: mangopay2-net-ruby-ci
+name: mangopay2-ruby-ci
 
 on:
   push:

data/CHANGELOG.md

@@ -1,3 +1,45 @@
+## [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
+
+#### SCA on wallet access endpoints
+
+`ScaContext` query parameter added on wallet access endpoints for the [introduction of SCA](https://docs.mangopay.com/guides/sca/wallets):
+
+- [GET View a Wallet](https://docs.mangopay.com/api-reference/wallets/view-wallet)
+- [GET List Wallets for a User](https://docs.mangopay.com/api-reference/wallets/list-wallets-user)
+- [GET List Transactions for a User](https://docs.mangopay.com/api-reference/transactions/list-transactions-user)
+- [GET List Transactions for a Wallet](https://docs.mangopay.com/api-reference/transactions/list-transactions-wallet)
+
+If SCA is required, Mangopay responds with a 401 response code. The `PendingUserAction` `RedirectUrl` is in the dedicated `WWW-Authenticate` response header.
+
+See the tests for examples on handling this error.
+
+#### BLIK with code
+Support for [BLIK with code endpoint](https://docs.mangopay.com/api-reference/blik/create-blik-payin-with-code)
+
 ## [3.32.0] - 2025-04-16
 ### Added
 

data/lib/mangopay/deposit.rb

@@ -16,5 +16,13 @@ module MangoPay
       }
       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
   end
 end

data/lib/mangopay/http_calls.rb

@@ -52,8 +52,11 @@ module MangoPay
         #   MangoPay::User.fetch(filter = {'page' => 2, 'per_page' => 3})
         #   filter # => {"page"=>2, "per_page"=>3, "total_pages"=>1969, "total_items"=>5905}
         #
-        def fetch(id_or_filters = nil, idempotency_key = nil)
+        def fetch(id_or_filters = nil, idempotency_key = nil, query_params_get_by_id = nil)
           id, filters = HTTPCalls::Fetch.parse_id_or_filters(id_or_filters)
+          if query_params_get_by_id != nil and query_params_get_by_id != {}
+            filters = query_params_get_by_id
+          end
           response = MangoPay.request(:get, url(id), {}, filters, idempotency_key)
         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/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.32.0'
+  VERSION = '3.34.0'
 end

data/lib/mangopay.rb

@@ -234,6 +234,12 @@ module MangoPay
       end
 
       unless res.is_a?(Net::HTTPOK) or res.is_a?(Net::HTTPCreated) or res.is_a?(Net::HTTPNoContent)
+        if res.is_a?(Net::HTTPUnauthorized) and res['www-authenticate'] != nil
+          redirect_url = res['www-authenticate'][/RedirectUrl=(.+)/, 1]
+          data['RedirectUrl'] = redirect_url
+          data['message'] = 'SCA required to perform this action.'
+          raise MangoPay::ResponseError.new(uri, res.code, data)
+        end
         raise MangoPay::ResponseError.new(uri, res.code, data)
       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,26 @@ 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
   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_blik_web_spec.rb

@@ -17,6 +17,15 @@ describe MangoPay::PayIn::Blik::Web, type: :feature do
       expect(created['ReturnURL']).not_to be_nil
       check_type_and_status(created)
     end
+
+    it 'creates a blik web payin with code' do
+      created = new_payin_blik_web_with_code
+      expect(created['Id']).not_to be_nil
+      expect(created['Code']).not_to be_nil
+      expect(created['IpAddress']).not_to be_nil
+      expect(created['BrowserInfo']).not_to be_nil
+      check_type_and_status(created)
+    end
   end
 
   describe 'FETCH' do

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

@@ -577,7 +577,36 @@ shared_context 'payins' do
       Currency: 'PLN',
       Tag: 'Test wallet'
     )
-    MangoPay::PayIn::Blik::Web.create(
+    MangoPay::PayIn::Blik::Web.create(define_new_blik(user, wallet))
+  end
+
+  let(:new_payin_blik_web_with_code) do
+    user = new_natural_user
+    wallet = MangoPay::Wallet.create(
+      Owners: [user['Id']],
+      Description: 'A test wallet',
+      Currency: 'PLN',
+      Tag: 'Test wallet'
+    )
+    blik = define_new_blik(user, wallet)
+    blik['Code'] = '777365'
+    blik['IpAddress'] = '159.180.248.187'
+    blik['BrowserInfo'] = {
+      AcceptHeader: "text/html, application/xhtml+xml, application/xml;q=0.9, /;q=0.8",
+      JavaEnabled: true,
+      Language: "FR-FR",
+      ColorDepth: 4,
+      ScreenHeight: 1800,
+      ScreenWidth: 400,
+      JavascriptEnabled: true,
+      TimeZoneOffset: "+60",
+      UserAgent: "Mozilla/5.0 (iPhone; CPU iPhone OS 13_6_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148"
+    }
+    MangoPay::PayIn::Blik::Web.create(blik)
+  end
+
+  def define_new_blik(user, wallet)
+    {
       AuthorId: user['Id'],
       CreditedWalletId: wallet['Id'],
       DebitedFunds: { Currency: 'PLN', Amount: 199 },
@@ -585,7 +614,7 @@ shared_context 'payins' do
       StatementDescriptor: "ruby",
       Tag: 'Test PayIn/Blik/Web',
       ReturnURL: 'https://example.com'
-    )
+    }
   end
 
   ###############################################
@@ -1222,6 +1251,7 @@ shared_context 'recipient' do
       "PayoutMethodType": "LocalBankTransfer",
       "RecipientType": "Individual",
       "Currency": "GBP",
+      "Country": "GB",
       "IndividualRecipient": {
         "FirstName": "Alex",
         "LastName": "Smith",

data/spec/mangopay/user_spec.rb

@@ -240,6 +240,14 @@ describe MangoPay::User do
       expect(transactions_ids).to include payin['Id']
       expect(transactions_ids).to include payout['Id']
     end
+
+    it 'fetches transactions sca' do
+      begin
+        MangoPay::User.transactions(new_natural_user['Id'], {'ScaContext': 'USER_PRESENT'})
+      rescue MangoPay::ResponseError => ex
+        expect(ex.details['RedirectUrl']).not_to be_nil
+      end
+    end
   end
 
   describe 'FETCH WALLETS' do
@@ -256,6 +264,14 @@ describe MangoPay::User do
       expect(wallets.count).to eq 1
       expect(wallets.first['Id']).to eq wallet['Id']
     end
+
+    it 'fetches wallets sca' do
+      begin
+        MangoPay::User.wallets(new_natural_user['Id'], {'ScaContext': 'USER_PRESENT'})
+      rescue MangoPay::ResponseError => ex
+        expect(ex.details['RedirectUrl']).not_to be_nil
+      end
+    end
   end
 
   describe 'FETCH CARDS' do

data/spec/mangopay/wallet_spec.rb

@@ -27,6 +27,14 @@ describe MangoPay::Wallet do
       wallet = MangoPay::Wallet.fetch(new_wallet['Id'])
       expect(wallet['Id']).to eq(new_wallet['Id'])
     end
+
+    it 'fetches a wallet sca' do
+      begin
+        MangoPay::Wallet.fetch(new_wallet['Id'], nil, {'ScaContext': 'USER_PRESENT'})
+      rescue MangoPay::ResponseError => ex
+        expect(ex.details['RedirectUrl']).not_to be_nil
+      end
+    end
   end
 
   describe 'FETCH TRANSACTIONS' do
@@ -81,5 +89,12 @@ describe MangoPay::Wallet do
       expect(by_type_pyout.first['Id']).to eq payout['Id']
     end
 
+    it 'fetches transactions sca' do
+      begin
+        MangoPay::Wallet.transactions(new_wallet['Id'], {'ScaContext': 'USER_PRESENT'})
+      rescue MangoPay::ResponseError => ex
+        expect(ex.details['RedirectUrl']).not_to be_nil
+      end
+    end
   end
 end

metadata

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