mangopay 3.34.0 → 3.35.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9a183b9490a45fa73745d864f9643d9afec4e4ea56b002784e2b888ae7886b7b
-  data.tar.gz: 4079521fab8f807345c218e00510e5197d4cb05d8afc4cbd4a332e5231650100
+  metadata.gz: 15264b27e3c6d9543eb22df8793bb0fb37870aa19d6c12c5d9c41f7ae3e37f7a
+  data.tar.gz: 8333f909cf729a462acd645a4b68aa03a048a6490fe16881eb675a818e25a0c8
 SHA512:
-  metadata.gz: 1bb4ea160e1a0f9c93032320a1be553b669b7cc1f07c2b27d822ff7cc22e6015237666bc284f7304ad9d2302cfa9c963db75b81dfcae39645468efb717735c25
-  data.tar.gz: 2ee8715ac0e1bc4a96f8773f5bef406fa229a8f7d980b9813e539a4aaa4735451600f130046ae0810921e11e1ae0549d0850c1f1d7b98354228f9fe7c7f6c160
+  metadata.gz: 2522a4843d777f4db554b7df2ab8c331d592155288fd641deaf17e19de28e426df70eeca7041e8007c9732aae4663c1fe93677d1c9a71fcb8244b7b8cf766490
+  data.tar.gz: 607684d9029548a5798d1274938f74d8c0fad61591d3ca68bf56a8a90247741d475a34ddb0dbe06c20def8f06810d6d3cdd6ceb47a75221086baf480cb30ec3b

data/CHANGELOG.md

@@ -1,3 +1,21 @@
+## [3.35.1] - 2025-06-05
+### Added
+- Support for `RecipientScope` query parameter on [GET List Recipients for a User](https://docs.mangopay.com/api-reference/recipients/list-recipients-user)
+- [POST Validate the format of User data](https://docs.mangopay.com/api-reference/user-data-format/validate-user-data-format)
+
+### Fixed
+- Support for legacy Payconiq integration via `MangoPay::PayIn::Payconiq::Web.create_legacy` (removed in error).
+
+## [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
 

data/lib/mangopay/deposit.rb

@@ -17,6 +17,10 @@ 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
@@ -24,5 +28,9 @@ module MangoPay
     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/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
@@ -139,6 +147,10 @@ module MangoPay
         def self.url(*)
           "#{MangoPay.api_path}/payins/payment-methods/payconiq"
         end
+
+        def self.create_legacy(params, idempotency_key = nil)
+          MangoPay.request(:post, "#{MangoPay.api_path}/payins/payconiq/web", params, {}, idempotency_key)
+        end
       end
 
     end

data/lib/mangopay/user.rb

@@ -87,6 +87,10 @@ module MangoPay
         url = "#{MangoPay.api_path}/sca/users/#{user_id}"
         MangoPay.request(:get, url, {}, {})
       end
+
+      def validate_data_format(params, idempotency_key = nil)
+        MangoPay.request(:post, "#{MangoPay.api_path}/users/data-formats/validation", params, {}, idempotency_key)
+      end
     end
   end
 end

data/lib/mangopay/version.rb

@@ -1,3 +1,3 @@
 module MangoPay
-  VERSION = '3.34.0'
+  VERSION = '3.35.1'
 end

data/spec/mangopay/deposit_spec.rb

@@ -44,6 +44,18 @@ describe MangoPay::Deposit do
       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/payin_payconiq_web_spec.rb

@@ -20,6 +20,12 @@ describe MangoPay::PayIn::Payconiq::Web, type: :feature do
       expect(created['Id']).not_to be_nil
       check_type_and_status(created)
     end
+
+    it 'creates a payconiq web payin using the old endpoint' do
+      created = new_payin_payconiq_web_legacy
+      expect(created['Id']).not_to be_nil
+      check_type_and_status(created)
+    end
   end
 
 end

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

@@ -18,7 +18,7 @@ describe MangoPay::Recipient do
   end
 
   describe 'GET User Recipients' do
-    it 'fetches a recipient' do
+    it 'fetches recipients without query param' do
       john = create_new_natural_user_sca_owner
       create_new_recipient(john['Id'])
       fetched = MangoPay::Recipient.get_user_recipients(john['Id'])
@@ -26,6 +26,24 @@ describe MangoPay::Recipient do
       expect(fetched).to be_kind_of(Array)
       expect(fetched).not_to be_empty
     end
+
+    it 'fetches recipients with scope PAYOUT' do
+      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
+      expect(fetched).to be_kind_of(Array)
+      expect(fetched).not_to be_empty
+    end
+
+    it 'fetches recipients with scope PAYIN' do
+      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
+      expect(fetched).to be_kind_of(Array)
+      expect(fetched).to be_empty
+    end
   end
 
   describe 'GET Schema' do

data/spec/mangopay/shared_resources.rb

@@ -372,6 +372,18 @@ shared_context 'payins' do
     )
   end
 
+  let(:new_payin_payconiq_web_legacy) do
+    MangoPay::PayIn::Payconiq::Web.create_legacy(
+      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
   ###############################################
@@ -936,6 +948,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
   ###############################################

data/spec/mangopay/user_spec.rb

@@ -399,4 +399,30 @@ describe MangoPay::User do
       expect(closed['UserStatus']).to eq('CLOSED')
     end
   end
+
+  describe 'Validate User Data Format' do
+    it 'validates successfully' do
+      validation = {
+        "CompanyNumber": {
+          "CompanyNumber": "AB123456",
+          "CountryCode": "IT"
+        }
+      }
+      result = MangoPay::User.validate_data_format(validation)
+      expect(result['CompanyNumber']).not_to be_nil
+    end
+
+    it 'validates with error' do
+      validation = {
+        "CompanyNumber": {
+          "CompanyNumber": "123"
+        }
+      }
+      expect { MangoPay::User.validate_data_format(validation) }.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
 end

metadata

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