mangopay 3.42.0 → 3.43.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 75e70fb3e6f0127887de7a15963f3d6da46eba5ae5e442e020cb68464540f3d9
-  data.tar.gz: 2925a4605e33e3c0325522cdd3657db592b87675172ceabeb749f321ce1af2e9
+  metadata.gz: e8e415a3b362b0ba193e2477fdc7508c7559b9523b40a590612e4e74150003ea
+  data.tar.gz: 7c9cbca2320c1398508f208d9650d2adce0a10817df521ca37d96ca8901c3135
 SHA512:
-  metadata.gz: '016839ec01d68ffeeff441b0f144758b911febc7ad559808f65ef57baab454f21798cc9c52ff664b4fdcb6ed3bc54fea8d3b38e3c3e2801767d9fd793eb1f915'
-  data.tar.gz: 055ae925c27dc1aed17a0f41fa2585854f156b1b206d3661d990a8bf91dbfc83ca63199f3992e83604883466bb23c972547d3364fc1d1cb78a795efdeeceb076
+  metadata.gz: 7384bcd1a7c53eef9dc2a069693087283667b256e575ae216ea0ddc242a3e66ea9e7888f4dfe9a4911acb44c5d884621149ea8c2db87ae3f98617078dc9033ab
+  data.tar.gz: 2aa7998c203b484274941a2cb5c67190d3364920c8968ec0095944145993dc0288ab92e71fd0a0a1f60ad4d39ae030607d01a44a79c9cbba602ffff734c499bc

data/CHANGELOG.md

@@ -1,3 +1,11 @@
+## [3.43.0] - 2025-11-19
+### Added
+First batch of endpoints for direct acquiring solution (in private beta).
+
+## [3.42.1] - 2025-11-06
+### Improved
+- Support for case variations in error handler #313
+
 ## [3.42.0] - 2025-10-27
 ### Added
 - New [POST Manage proxy consent for a User](https://docs.mangopay.com/api-reference/users/manage-proxy-consent) endpoint to obtain and manage user consent via the hosted SCA experience (if proxy is activated). A proxy and user consent are now required to use the `USER_NOT_PRESENT` value for `ScaContext` ([API release note](https://docs.mangopay.com/release-notes/api/2025-10-23), #310)

data/lib/mangopay/acquiring.rb

@@ -0,0 +1,56 @@
+module MangoPay
+
+  class Acquiring < Resource
+    module PayIn
+      module Card
+        class Direct < Resource
+          def self.create(params, idempotency_key = nil)
+            MangoPay.request(:post, "#{MangoPay.api_path}/acquiring/payins/card/direct", params, {}, idempotency_key)
+          end
+        end
+      end
+
+      module ApplePay
+        class Direct < Resource
+          def self.create(params, idempotency_key = nil)
+            MangoPay.request(:post, "#{MangoPay.api_path}/acquiring/payins/payment-methods/applepay", params, {}, idempotency_key)
+          end
+        end
+      end
+
+      module GooglePay
+        class Direct < Resource
+          def self.create(params, idempotency_key = nil)
+            MangoPay.request(:post, "#{MangoPay.api_path}/acquiring/payins/payment-methods/googlepay", params, {}, idempotency_key)
+          end
+        end
+      end
+
+      module Ideal
+        class Web < Resource
+          def self.create(params, idempotency_key = nil)
+            MangoPay.request(:post, "#{MangoPay.api_path}/acquiring/payins/payment-methods/ideal", params, {}, idempotency_key)
+          end
+        end
+      end
+
+      module PayPal
+        class Web < Resource
+          def self.create(params, idempotency_key = nil)
+            MangoPay.request(:post, "#{MangoPay.api_path}/acquiring/payins/payment-methods/paypal", params, {}, idempotency_key)
+          end
+
+          def self.create_data_collection(params, idempotency_key = nil)
+            MangoPay.request(:post, "#{MangoPay.api_path}/acquiring/payins/payment-methods/paypal/data-collection", params, {}, idempotency_key)
+          end
+        end
+      end
+    end
+
+    class Refund < Resource
+      def self.create(pay_in_id, params, idempotency_key = nil)
+        MangoPay.request(:post, "#{MangoPay.api_path}/acquiring/payins/#{pay_in_id}/refunds", params, {}, idempotency_key)
+      end
+    end
+  end
+end

data/lib/mangopay/errors.rb

@@ -50,7 +50,7 @@ module MangoPay
 
     def type;    @details['Type'] || @details['type']; end
     def error;   @details['error']; end
-    def errors;  @details['errors'] || error; end
+    def errors;  @details['errors'] || @details['Errors'] || error; end
 
     def message;
       if error

data/lib/mangopay/version.rb

@@ -1,3 +1,3 @@
 module MangoPay
-  VERSION = '3.42.0'
+  VERSION = '3.43.0'
 end

data/lib/mangopay.rb

@@ -54,6 +54,7 @@ module MangoPay
   autoload :IdentityVerification, 'mangopay/identity_verification'
   autoload :Recipient, 'mangopay/recipient'
   autoload :Settlement, 'mangopay/settlement'
+  autoload :Acquiring, 'mangopay/acquiring'
 
   # temporary
   autoload :Temp, 'mangopay/temp'
@@ -118,8 +119,6 @@ module MangoPay
     end
 
     def uk_header_flag
-      warn "[DEPRECATION] `uk_header_flag` is deprecated and will be removed in a future version. " \
-             "Please update your configuration accordingly."
       @uk_header_flag || false
     end
   end

data/spec/mangopay/acquiring_spec.rb

@@ -0,0 +1,176 @@
+xdescribe MangoPay::Hook do
+  include_context 'wallets'
+  include_context 'payins'
+
+  let(:card_id) { 'placeholder' }
+
+  describe 'PAY_IN CARD DIRECT' do
+    it 'creates a Card Direct PayIn' do
+      created = create_new_pay_in_card_direct
+
+      assert_common_pay_in_properties(created)
+      expect(created['PaymentType']).to eq('CARD')
+      expect(created['ExecutionType']).to eq('DIRECT')
+    end
+  end
+
+  describe 'REFUND' do
+    it 'creates a Refund for a PayIn' do
+      pay_in = create_new_pay_in_card_direct
+      refund = MangoPay::Acquiring::Refund.create(pay_in['Id'], { DebitedFunds: { Currency: 'EUR', Amount: 10 } })
+
+      expect(refund['Id']).not_to be_nil
+      expect(refund['Status']).to eq('SUCCEEDED')
+      expect(refund['Type']).to eq('PAYOUT')
+      expect(refund['Nature']).to eq('REFUND')
+      expect(refund['InitialTransactionType']).to eq('PAYIN')
+      expect(refund['InitialTransactionId']).to eq(pay_in['Id'])
+    end
+  end
+
+  describe 'PAY_IN APPLE_PAY' do
+    it 'creates an ApplePay direct PayIn' do
+      created = MangoPay::Acquiring::PayIn::ApplePay::Direct.create(
+        DebitedFunds: { Currency: 'EUR', Amount: 100 },
+        PaymentData: {
+          transactionId: "97e64d87f13a89ff6443cdcc205d5ccf7e15368b0d64126a8a2e0888a3a5c2a0",
+          network: "MasterCard",
+          tokenDataø: "{\"data\":\"2TihgKbmyPje02.........wAAAAAAAA==\",\"header\":{\"publicKeyHash\":\"xUyeFb75d359bfPEiq2JJMQj694UAxtTuBsaTWMOJxQ=\",\"ephemeralPublicKey\":\"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEkeuICjZ7x15b7hPEBEBT5Zp43l95wCmJCU3QNxBvOCusG9w9sJMULuXlT4K8LOlPgaZzAcyWlfNwnLivVdOPfg==\",\"transactionId\":\"97e64d87f13a89ff6443cdcc205d5ccf7e15368b0d64126a8a2e0888a3a5c2a0\"},\"version\":\"EC_v1\"}"
+        }
+      )
+
+      assert_common_pay_in_properties(created)
+      expect(created['PaymentType']).to eq('APPLEPAY')
+      expect(created['ExecutionType']).to eq('DIRECT')
+    end
+  end
+
+  describe 'PAY_IN GOOGLE_PAY' do
+    it 'creates a GooglePay direct PayIn' do
+      created = MangoPay::Acquiring::PayIn::GooglePay::Direct.create(
+        DebitedFunds: { Currency: 'EUR', Amount: 199 },
+        IpAddress: "2001:0620:0000:0000:0211:24FF:FE80:C12C",
+        SecureModeReturnURL: 'http://test.com',
+        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"
+        },
+        PaymentData: "{\"signature\":\"MEUCIQDc49/Bw1lTk8ok2fUe4UT......................\\u003d\\\"}\"}"
+      )
+
+      assert_common_pay_in_properties(created)
+      expect(created['PaymentType']).to eq('GOOGLEPAY')
+      expect(created['ExecutionType']).to eq('DIRECT')
+    end
+  end
+
+  describe 'PAY_IN IDEAL WEB' do
+    it 'creates an Ideal Web PayIn' do
+      created = MangoPay::Acquiring::PayIn::Ideal::Web.create(
+        DebitedFunds: { Currency: 'EUR', Amount: 100 },
+        ReturnURL: 'http://www.my-site.com/returnURL'
+      )
+
+      assert_common_pay_in_properties(created)
+      expect(created['PaymentType']).to eq('IDEAL')
+      expect(created['ExecutionType']).to eq('WEB')
+    end
+  end
+
+  describe 'PAY_IN PAYPAL' do
+    it 'creates a PayPal Web PayIn' do
+      created = MangoPay::Acquiring::PayIn::PayPal::Web.create(
+        DebitedFunds: { Currency: 'EUR', Amount: 400 },
+        ReturnUrl: "http://example.com",
+        LineItems: [
+          {
+            Name: "running shoes",
+            Quantity: 1,
+            UnitAmount: 200,
+            TaxAmount: 0,
+            Description: "seller1 ID"
+          },
+          {
+            Name: "running shoes",
+            Quantity: 1,
+            UnitAmount: 200,
+            TaxAmount: 0,
+            Description: "seller2 ID"
+          }
+        ]
+      )
+
+      assert_common_pay_in_properties(created)
+      expect(created['PaymentType']).to eq('PAYPAL')
+      expect(created['ExecutionType']).to eq('WEB')
+    end
+
+    it 'creates PayPal DataCollection' do
+      data_collection = MangoPay::Acquiring::PayIn::PayPal::Web.create_data_collection(
+        {
+          "sender_account_id": "A12345N343",
+          "sender_first_name": "Jane",
+          "sender_last_name": "Doe",
+          "sender_email": "jane.doe@sample.com",
+          "sender_phone": "(042)11234567",
+          "sender_address_zip": "75009",
+          "sender_country_code": "FR",
+          "sender_create_date": "2012-12-09T19:14:55.277-0:00",
+          "sender_signup_ip": "10.220.90.20",
+          "sender_popularity_score": "high",
+          "receiver_account_id": "A12345N344",
+          "receiver_create_date": "2012-12-09T19:14:55.277-0:00",
+          "receiver_email": "jane@sample.com",
+          "receiver_address_country_code": "FR",
+          "business_name": "Jane Ltd",
+          "recipient_popularity_score": "high",
+          "first_interaction_date": "2012-12-09T19:14:55.277-0:00",
+          "txn_count_total": "34",
+          "vertical": "Household goods",
+          "transaction_is_tangible": "0"
+        }
+      )
+      expect(data_collection['dataCollectionId']).not_to be_nil
+    end
+  end
+
+  def create_new_pay_in_card_direct
+    MangoPay::Acquiring::PayIn::Card::Direct.create(
+      DebitedFunds: { Currency: 'EUR', Amount: 100 },
+      CardType: 'CB_VISA_MASTERCARD',
+      CardId: card_id,
+      SecureMode: 'DEFAULT',
+      SecureModeReturnURL: 'http://test.com',
+      Tag: 'Acquiring Test PayIn/Card/Direct',
+      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"
+      },
+      IpAddress: "2001:0620:0000:0000:0211:24FF:FE80:C12C"
+    )
+  end
+
+  def assert_common_pay_in_properties(pay_in)
+    expect(pay_in['Id']).not_to be_nil
+    expect(pay_in['Type']).to eq('PAYIN')
+    expect(pay_in['Nature']).to eq('REGULAR')
+    expect(pay_in['Status']).to eq('SUCCEEDED')
+    expect(pay_in['ResultCode']).to eq('000000')
+    expect(pay_in['ResultMessage']).to eq('Success')
+    expect(pay_in['ExecutionDate']).to be > 0
+  end
+end

data/spec/mangopay/recipient_spec.rb

@@ -19,7 +19,7 @@ describe MangoPay::Recipient do
 
   describe 'GET User Recipients' do
     it 'fetches recipients without query param' do
-      john = create_new_natural_user_sca_payer
+      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
@@ -28,7 +28,7 @@ describe MangoPay::Recipient do
     end
 
     it 'fetches recipients with scope PAYOUT' do
-      john = create_new_natural_user_sca_payer
+      john = create_new_natural_user_sca_owner
       create_new_recipient(john['Id'])
       fetched = MangoPay::Recipient.get_user_recipients(john['Id'], {RecipientScope: "PAYOUT"})
       expect(fetched).not_to be_nil
@@ -37,7 +37,7 @@ describe MangoPay::Recipient do
     end
 
     it 'fetches recipients with scope PAYIN' do
-      john = create_new_natural_user_sca_payer
+      john = create_new_natural_user_sca_owner
       create_new_recipient(john['Id'])
       fetched = MangoPay::Recipient.get_user_recipients(john['Id'], {RecipientScope: "PAYIN"})
       expect(fetched).not_to be_nil
@@ -92,7 +92,7 @@ describe MangoPay::Recipient do
   describe 'VALIDATE' do
     it 'validates a recipient' do
       recipient = define_new_recipient
-      john = create_new_natural_user_sca_payer
+      john = create_new_natural_user_sca_owner
       # it should pass
       MangoPay::Recipient.validate(recipient, john['Id'])
 

data/spec/mangopay/shared_resources.rb

@@ -1306,7 +1306,7 @@ end
 shared_context 'recipient' do
   include_context 'users'
 
-  let(:new_recipient) { create_new_recipient(create_new_natural_user_sca_payer['Id']) }
+  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)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mangopay
 version: !ruby/object:Gem::Version
-  version: 3.42.0
+  version: 3.43.0
 platform: ruby
 authors:
 - Geoffroy Lorieux
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-10-27 00:00:00.000000000 Z
+date: 2025-11-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: multi_json
@@ -75,6 +75,7 @@ files:
 - lib/generators/mangopay/install_generator.rb
 - lib/generators/templates/mangopay.rb.erb
 - lib/mangopay.rb
+- lib/mangopay/acquiring.rb
 - lib/mangopay/authorization_token.rb
 - lib/mangopay/bank_account.rb
 - lib/mangopay/bankingaliases.rb
@@ -118,6 +119,7 @@ files:
 - lib/mangopay/virtual_account.rb
 - lib/mangopay/wallet.rb
 - mangopay.gemspec
+- spec/mangopay/acquiring_spec.rb
 - spec/mangopay/authorization_token_spec.rb
 - spec/mangopay/bank_account_spec.rb
 - spec/mangopay/bankingaliases_spec.rb
@@ -208,6 +210,7 @@ signing_key:
 specification_version: 4
 summary: Ruby bindings for the version 2 of the MANGOPAY API
 test_files:
+- spec/mangopay/acquiring_spec.rb
 - spec/mangopay/authorization_token_spec.rb
 - spec/mangopay/bank_account_spec.rb
 - spec/mangopay/bankingaliases_spec.rb