mangopay 3.31.0 → 3.33.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d0c9bf8de0cc8f9ac13e5c0410679c20e38cf971256a7109c034d06bf5ba07a3
-  data.tar.gz: 4cf8f88da31fcb566bf2bc5892a507e28e0815c75852fc119ae311b492d6c45d
+  metadata.gz: e2ea73775e3cbe39be6e8c2ab08353e325e4022c8e880c91ec39a2f7815158a5
+  data.tar.gz: e7a4e7daa408c976653cc7b45bb143e1e7d88b8c8267980bc26a03cd9483e100
 SHA512:
-  metadata.gz: b47ea99f7515a53d86d20bff3dba2291f971065e179d88e071cb18a47920969195a200a93192cce7535cb38bfac727e7fd78a233cc31bb2a0f472b399d802acb
-  data.tar.gz: 52cce07e5c04322c88c01771434ac5df303c1256558e60f4c32d96386272d3c3ea381ccc18a79061813c93c3336299bf75bb784b151e93fc4bb4f38dc8375b7a
+  metadata.gz: a237843330abcee5203d85c86fcfcdf4d4e549b1ff3c0662f502d9d064de94de512dd358a26b930a55ae133852bf8aba5b92b91c3f92391806b1cc47797977e4
+  data.tar.gz: c15777f6e7043c031371dcf1aaca92ed2396402c68fa9a3c2d8ab0e8a8cf6bfdb4f516b55602d5fa32ae543bbb9254e0b3fc0f557630e7e1806601d3b4043a02

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,38 @@
+## [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
+
+#### Recipients
+- [GET View payout methods](/api-reference/recipients/view-payout-methods)
+- [GET View the schema for a Recipient](/api-reference/recipients/view-recipient-schema)
+- [POST Validate data for a Recipient](/api-reference/recipients/validate-recipient-data)
+- [POST Create a Recipient](/api-reference/recipients/create-recipient)
+- [GET View a Recipient](/api-reference/recipients/view-recipient)
+- [GET List Recipients for a user](/api-reference/recipients/list-recipients-user)
+- [PUT Deactivate a Recipient](/api-reference/recipients/deactivate-recipient)
+
+#### Endpoints to close a user account
+- [DELETE Close a Natural User](/api-reference/users/close-natural-user)
+- [DELETE Close a Legal User](/api-reference/users/close-legal-user)
+
 ## [3.31.0] - 2025-04-16
 ### Added
 - [POST Create a Pay by Bank PayIn](https://docs.mangopay.com/api-reference/pay-by-bank/create-pay-by-bank-payin)

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/legal_user.rb

@@ -13,6 +13,9 @@ module MangoPay
     end
 
     class << self
+      def close(user_id)
+        MangoPay.request(:delete, url(user_id))
+      end
     end
   end
 end

data/lib/mangopay/legal_user_sca.rb

@@ -16,6 +16,10 @@ module MangoPay
         url = "#{MangoPay.api_path}/sca/users/legal/#{user_id}/category"
         MangoPay.request(:put, url, params)
       end
+
+      def close(user_id)
+        MangoPay.request(:delete, url(user_id))
+      end
     end
   end
 end

data/lib/mangopay/natural_user.rb

@@ -10,5 +10,11 @@ module MangoPay
         "#{MangoPay.api_path}/users/natural"
       end
     end
+
+    class << self
+      def close(user_id)
+        MangoPay.request(:delete, url(user_id))
+      end
+    end
   end
 end

data/lib/mangopay/natural_user_sca.rb

@@ -16,6 +16,10 @@ module MangoPay
         url = "#{MangoPay.api_path}/sca/users/natural/#{user_id}/category"
         MangoPay.request(:put, url, params)
       end
+
+      def close(user_id)
+        MangoPay.request(:delete, url(user_id))
+      end
     end
   end
 end

data/lib/mangopay/recipient.rb

@@ -0,0 +1,35 @@
+module MangoPay
+
+  class Recipient < Resource
+    def self.create(params, user_id, idempotency_key = nil)
+      MangoPay.request(:post, "#{MangoPay.api_path}/users/#{user_id}/recipients", params, {}, idempotency_key)
+    end
+
+    def self.get(recipient_id, filters = {})
+      MangoPay.request(:get, "#{MangoPay.api_path}/recipients/#{recipient_id}", {}, filters)
+    end
+
+    def self.get_user_recipients(user_id, filters = {})
+      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)
+    end
+
+    def self.get_payout_methods(country, currency, filters = {})
+      MangoPay.request(:get, "#{MangoPay.api_path}/recipients/payout-methods?country=#{country}&currency=#{currency}", {}, filters)
+    end
+
+    def self.validate(params, user_id, idempotency_key = nil)
+      MangoPay.request(:post, "#{MangoPay.api_path}/users/#{user_id}/recipients/validate", params, {}, idempotency_key)
+    end
+
+    def self.deactivate(recipient_id)
+      params = {
+        Status: 'DEACTIVATED'
+      }
+      MangoPay.request(:put, "#{MangoPay.api_path}/recipients/#{recipient_id}", params, {})
+    end
+  end
+end

data/lib/mangopay/version.rb

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

data/lib/mangopay.rb

@@ -51,6 +51,7 @@ module MangoPay
   autoload :PaymentMethodMetadata, 'mangopay/payment_method_metadata'
   autoload :VirtualAccount, 'mangopay/virtual_account'
   autoload :IdentityVerification, 'mangopay/identity_verification'
+  autoload :Recipient, 'mangopay/recipient'
 
   # temporary
   autoload :Temp, 'mangopay/temp'
@@ -232,7 +233,13 @@ module MangoPay
         raise MangoPay::ResponseError.new(uri, res.code, details)
       end
 
-      unless res.is_a?(Net::HTTPOK)
+      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

@@ -45,13 +45,13 @@ describe MangoPay::Client do
       bts = File.open(fnm, 'rb') { |f| f.read }
       b64 = Base64.encode64(bts)
       ret = MangoPay::Client.upload_logo(b64)
-      expect(ret).to be_nil
+      expect(ret).to_not be_nil
     end
 
     it 'accepts file path' do
       fnm = __FILE__.sub('.rb', '.png')
       ret = MangoPay::Client.upload_logo(nil, fnm)
-      expect(ret).to be_nil
+      expect(ret).to_not be_nil
     end
 
     it 'fails when input string is not base64-encoded' do

data/spec/mangopay/kyc_document_spec.rb

@@ -86,13 +86,13 @@ describe MangoPay::KycDocument do
       bts = File.open(fnm, 'rb') { |f| f.read }
       b64 = Base64.encode64(bts)
       ret = create_page(b64)
-      expect(ret).to be_nil
+      expect(ret).to_not be_nil
     end
 
     it 'accepts file path' do
       fnm = __FILE__.sub('.rb', '.png')
       ret = MangoPay::KycDocument.create_page(new_natural_user['Id'], new_document['Id'], nil, fnm)
-      expect(ret).to be_nil
+      expect(ret).to_not be_nil
     end
 
     it 'fails when input string is not base64-encoded' do

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

@@ -0,0 +1,113 @@
+describe MangoPay::Recipient do
+  include_context 'recipient'
+
+  describe 'CREATE' do
+    it 'creates a new recipient' do
+      recipient = new_recipient
+      assert_recipient(recipient)
+      expect(recipient['PendingUserAction']).not_to be_nil
+    end
+  end
+
+  describe 'GET' do
+    it 'fetches a recipient' do
+      recipient = new_recipient
+      fetched = MangoPay::Recipient.get(recipient['Id'])
+      assert_recipient(fetched)
+    end
+  end
+
+  describe 'GET User Recipients' do
+    it 'fetches a recipient' do
+      john = create_new_natural_user_sca_owner
+      create_new_recipient(john['Id'])
+      fetched = MangoPay::Recipient.get_user_recipients(john['Id'])
+      expect(fetched).not_to be_nil
+      expect(fetched).to be_kind_of(Array)
+      expect(fetched).not_to be_empty
+    end
+  end
+
+  describe 'GET Schema' do
+    it 'fetches schema for LocalBankTransfer, Individual' do
+      schema = MangoPay::Recipient.get_schema('LocalBankTransfer', 'Individual', 'GBP')
+      expect(schema).not_to be_nil
+      expect(schema['DisplayName']).not_to be_nil
+      expect(schema['Currency']).not_to be_nil
+      expect(schema['RecipientType']).not_to be_nil
+      expect(schema['PayoutMethodType']).not_to be_nil
+      expect(schema['RecipientScope']).not_to be_nil
+      expect(schema['Tag']).not_to be_nil
+      expect(schema['IndividualRecipient']).not_to be_nil
+      expect(schema['LocalBankTransfer']).not_to be_nil
+      expect(schema['BusinessRecipient']).to be_nil
+      expect(schema['InternationalBankTransfer']).to be_nil
+    end
+
+    it 'fetches schema for InternationalBankTransfer, Business' do
+      schema = MangoPay::Recipient.get_schema('InternationalBankTransfer', 'Business', 'GBP')
+      expect(schema).not_to be_nil
+      expect(schema['DisplayName']).not_to be_nil
+      expect(schema['Currency']).not_to be_nil
+      expect(schema['RecipientType']).not_to be_nil
+      expect(schema['PayoutMethodType']).not_to be_nil
+      expect(schema['RecipientScope']).not_to be_nil
+      expect(schema['Tag']).not_to be_nil
+      expect(schema['BusinessRecipient']).not_to be_nil
+      expect(schema['InternationalBankTransfer']).not_to be_nil
+      expect(schema['IndividualRecipient']).to be_nil
+      expect(schema['LocalBankTransfer']).to be_nil
+    end
+  end
+
+  describe 'GET Payout Methods' do
+    it 'fetches payout methods' do
+      payout_methods = MangoPay::Recipient.get_payout_methods('DE', 'EUR')
+      expect(payout_methods).not_to be_nil
+      expect(payout_methods['AvailablePayoutMethods']).to be_kind_of(Array)
+      expect(payout_methods['AvailablePayoutMethods']).not_to be_empty
+    end
+  end
+
+  describe 'VALIDATE' do
+    it 'validates a recipient' do
+      recipient = define_new_recipient
+      john = create_new_natural_user_sca_owner
+      # it should pass
+      MangoPay::Recipient.validate(recipient, john['Id'])
+
+      # it should throw error
+      recipient['Currency'] = nil
+      expect { MangoPay::Recipient.validate(recipient, john['Id']) }.to raise_error { |err|
+        expect(err).to be_a MangoPay::ResponseError
+        expect(err.code).to eq '400'
+        expect(err.type).to eq 'param_error'
+      }
+    end
+  end
+
+  describe 'DEACTIVATE' do
+    it 'deactivates a recipient' do
+      pending("a recipient needs to be manually activated before running the test")
+      john = create_new_natural_user_sca_owner
+      recipient = create_new_recipient(john['Id'])
+      deactivated = MangoPay::Recipient.deactivate(recipient['Id'])
+      fetched = MangoPay::Recipient.get(recipient['Id'])
+      expect(deactivated['Status']).to eq('DEACTIVATED')
+      expect(fetched['Status']).to eq('DEACTIVATED')
+    end
+  end
+end
+
+
+def assert_recipient(recipient)
+  expect(recipient).not_to be_nil
+  expect(recipient['Status']).not_to be_nil
+  expect(recipient['DisplayName']).not_to be_nil
+  expect(recipient['PayoutMethodType']).not_to be_nil
+  expect(recipient['RecipientType']).not_to be_nil
+  expect(recipient['IndividualRecipient']).not_to be_nil
+  expect(recipient['LocalBankTransfer']).not_to be_nil
+  expect(recipient['RecipientScope']).not_to be_nil
+  expect(recipient['UserId']).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
 
   ###############################################
@@ -1205,4 +1234,39 @@ shared_context 'virtual_account' do
 
     MangoPay::VirtualAccount.create(wallet_id, create_virtual_account)
   end
+end
+
+shared_context 'recipient' do
+  include_context 'users'
+
+  let(:new_recipient) { create_new_recipient(create_new_natural_user_sca_owner['Id']) }
+
+  def create_new_recipient(user_id)
+    MangoPay::Recipient.create(define_new_recipient, user_id)
+  end
+
+  def define_new_recipient
+    {
+      "DisplayName": "Alex Smith GBP account",
+      "PayoutMethodType": "LocalBankTransfer",
+      "RecipientType": "Individual",
+      "Currency": "GBP",
+      "IndividualRecipient": {
+        "FirstName": "Alex",
+        "LastName": "Smith",
+        "Address": {
+          "AddressLine1": "10 Kingsway",
+          "City": "London",
+          "PostalCode": "WC2B 6LH",
+          "Country": "GB"
+        }
+      },
+      "LocalBankTransfer": {
+        "GBP": {
+          "SortCode": "200000",
+          "AccountNumber": "55779911"
+        }
+      }
+    }
+  end
 end

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
@@ -367,4 +383,20 @@ describe MangoPay::User do
     end
   end
 =end
+
+  describe 'CLOSE' do
+    it 'closes a natural user' do
+      new_user = create_new_natural_user
+      MangoPay::NaturalUser.close(new_user['Id'])
+      closed = MangoPay::User.fetch(new_user['Id'])
+      expect(closed['UserStatus']).to eq('CLOSED')
+    end
+
+    it 'closes a legal user' do
+      new_user = new_legal_user
+      MangoPay::LegalUser.close(new_user['Id'])
+      closed = MangoPay::User.fetch(new_user['Id'])
+      expect(closed['UserStatus']).to eq('CLOSED')
+    end
+  end
 end

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.31.0
+  version: 3.33.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-04-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: multi_json
@@ -102,6 +102,7 @@ files:
 - lib/mangopay/pay_out.rb
 - lib/mangopay/payment_method_metadata.rb
 - lib/mangopay/pre_authorization.rb
+- lib/mangopay/recipient.rb
 - lib/mangopay/refund.rb
 - lib/mangopay/regulatory.rb
 - lib/mangopay/report.rb
@@ -160,6 +161,7 @@ files:
 - spec/mangopay/payment_method_metadata_spec.rb
 - spec/mangopay/payout_bankwire_spec.rb
 - spec/mangopay/preauthorization_spec.rb
+- spec/mangopay/recipient_spec.rb
 - spec/mangopay/recurring_payin_spec.rb
 - spec/mangopay/refund_spec.rb
 - spec/mangopay/regulatory_spec.rb
@@ -244,6 +246,7 @@ test_files:
 - spec/mangopay/payment_method_metadata_spec.rb
 - spec/mangopay/payout_bankwire_spec.rb
 - spec/mangopay/preauthorization_spec.rb
+- spec/mangopay/recipient_spec.rb
 - spec/mangopay/recurring_payin_spec.rb
 - spec/mangopay/refund_spec.rb
 - spec/mangopay/regulatory_spec.rb