mangopay 3.35.0 → 3.36.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e11195066c9596106c5615e858bf1af13f20e4d6f6efa51675158e7d49a8348b
-  data.tar.gz: d789d50dfdb1cb320cc0b4dc0d3b8b7ef12aac1627da49b77abadaa502b855c4
+  metadata.gz: 1e7c13389de9248688caaafdb17c31f307c06626b42f3062c963001d8f0a6910
+  data.tar.gz: 57c70a006da5aa84d3250683183aafe354b3fb549099cd6d428f66b252a1623e
 SHA512:
-  metadata.gz: 3ed3eb963aa03ae1874ecab170480f6f0cae564adc7f98007724ce8f0049be680c9f013965f835e0300fcb6d46fa2497da27aa7faf310b24ca3702de72021609
-  data.tar.gz: 3f3e98a623f39a930ceaa2be9b747c72d7daa987bcb69a8e2a3a1883c0ca4ab93b51a98e69d383c13fc32fb17ec9dbbfb771a55698bfd47618bb15e59010ea08
+  metadata.gz: d662e3de61baec5457c58ef57a477a463177460acb6a7e9f193ce5e7ceef8023bb490bb9b47e10a357cec10f2444e4ee29b813af371449d6c87143695201cfeb
+  data.tar.gz: e8e73b9ce2db464f598366e6ff558980d676df136ab4f16df9e696f8995d4417163272f2bbfdd4be7c574493bd8c46dc7a68e811cf9a4412d7c5fa3c5352530d

data/CHANGELOG.md

@@ -1,3 +1,23 @@
+## [3.36.0] - 2025-06-24
+### Added
+
+[New Reporting Service](https://docs.mangopay.com/release-notes/api/2025-06-05) endpoints (#287 ):
+- [POST Create a Report](https://docs.mangopay.com/api-reference/reporting/create-report)
+- [GET View a Report](https://docs.mangopay.com/api-reference/reporting/view-report)
+- [GET List all Reports](https://docs.mangopay.com/api-reference/reporting/list-reports)
+
+Support for:
+- [GET List Disputes for a PayIn](https://docs.mangopay.com/api-reference/disputes/list-disputes-payin) (#287)
+- [GET List Transactions for a Card Fingerprint](https://docs.mangopay.com/api-reference/transactions/list-transactions-card-fingerprint) (#289)
+
+## [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
 

data/lib/mangopay/card.rb

@@ -45,6 +45,10 @@ module MangoPay
         url = "#{MangoPay.api_path}/cards/#{card_id}/validation/#{validation_id}"
         MangoPay.request(:get, url)
       end
+
+      def get_transactions_by_fingerprint(fingerprint, filters = {})
+        MangoPay.request(:get, "#{fingerprint_url(fingerprint)}/transactions", {}, filters)
+      end
     end
   end
 end

data/lib/mangopay/dispute.rb

@@ -40,6 +40,11 @@ module MangoPay
         MangoPay.request(:get, url, {}, filters)
       end
 
+      def fetch_for_pay_in(pay_in_id, filters = {})
+        url = "#{MangoPay.api_path}/payins/#{pay_in_id}/disputes"
+        MangoPay.request(:get, url, {}, filters)
+      end
+
       def fetch_pending_settlement(filters = {})
         url = "#{MangoPay.api_path}/disputes/pendingsettlement"
         MangoPay.request(:get, url, {}, filters)

data/lib/mangopay/pay_in.rb

@@ -147,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/report_v2.rb

@@ -0,0 +1,21 @@
+module MangoPay
+
+  # See https://docs.mangopay.com/endpoints/v2.01/reporting
+  class ReportV2 < Resource
+
+    class << self
+      def create(params, idempotency_key = nil)
+        MangoPay.request(:post, "#{MangoPay.api_path}/reporting/reports", params, {}, idempotency_key)
+      end
+
+      def get(id)
+        MangoPay.request(:get, "#{MangoPay.api_path}/reporting/reports/#{id}")
+      end
+
+      def get_all(params = nil)
+        MangoPay.request(:get, "#{MangoPay.api_path}/reporting/reports", params)
+      end
+
+    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.35.0'
+  VERSION = '3.36.0'
 end

data/lib/mangopay.rb

@@ -38,6 +38,7 @@ module MangoPay
   autoload :Dispute, 'mangopay/dispute'
   autoload :Mandate, 'mangopay/mandate'
   autoload :Report, 'mangopay/report'
+  autoload :ReportV2, 'mangopay/report_v2'
   autoload :JSON, 'mangopay/json'
   autoload :AuthorizationToken, 'mangopay/authorization_token'
   autoload :FilterParameters, 'mangopay/filter_parameters'

data/spec/mangopay/card_registration_spec.rb

@@ -107,4 +107,17 @@ describe MangoPay::CardRegistration do
       expect(card_validation['Id']).equal? fetched_card_validation['Id']
     end
   end
+
+  describe 'Get transactions by card fingerprint' do
+    it 'retrieves list of transactions for a fingerprint' do
+      completed = new_card_registration_completed
+      card_id = completed['CardId']
+      card = MangoPay::Card.fetch(card_id)
+      fingerprint = card['Fingerprint']
+      result = MangoPay::Card.get_transactions_by_fingerprint(fingerprint)
+
+      expect(result).to be_kind_of(Array)
+      expect(result.count).to be > 0
+    end
+  end
 end

data/spec/mangopay/dispute_spec.rb

@@ -49,14 +49,17 @@ and it's infact not suitable like that
       expect(disputes).not_to be_empty
     end
     it 'fetches disputes for wallet' do
-      dispute = @disputes.find {|disp| disp['InitialTransactionId'] != nil}
-      expect(dispute).not_to be_nil, "Cannot test fetching disputes for wallet because there's no disputes with transaction ID in the disputes list."
-      payin = MangoPay::PayIn.fetch(dispute['InitialTransactionId'])
+      payin = MangoPay::PayIn.fetch("133379281")
       wallet_id = payin['CreditedWalletId']
       disputes = MangoPay::Dispute.fetch_for_wallet(wallet_id, {'per_page' => 1})
       expect(disputes).to be_kind_of(Array)
       expect(disputes).not_to be_empty
     end
+    it 'fetches disputes for payin' do
+      disputes = MangoPay::Dispute.fetch_for_pay_in("133379281", {'per_page' => 1})
+      expect(disputes).to be_kind_of(Array)
+      expect(disputes).not_to be_empty
+    end
   end
 
   describe 'UPDATE' do

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

@@ -5,7 +5,7 @@ describe MangoPay::Recipient do
     it 'creates a new recipient' do
       recipient = new_recipient
       assert_recipient(recipient)
-      expect(recipient['PendingUserAction']).not_to be_nil
+      expect(recipient['Status']).to eq('PENDING')
     end
   end
 
@@ -18,14 +18,32 @@ describe MangoPay::Recipient do
   end
 
   describe 'GET User Recipients' do
-    it 'fetches a recipient' do
-      john = create_new_natural_user_sca_owner
+    it 'fetches recipients without query param' do
+      john = create_new_natural_user_sca_payer
       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
+
+    it 'fetches recipients with scope PAYOUT' do
+      john = create_new_natural_user_sca_payer
+      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_payer
+      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
@@ -74,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_owner
+      john = create_new_natural_user_sca_payer
       # it should pass
       MangoPay::Recipient.validate(recipient, john['Id'])
 

data/spec/mangopay/report_v2_spec.rb

@@ -0,0 +1,38 @@
+describe MangoPay::ReportV2 do
+
+  def create
+    params = {
+      "Tag": "Created using the Mangopay API Postman collection",
+      "DownloadFormat": "CSV",
+      "ReportType": "COLLECTED_FEES",
+      "AfterDate": 1740787200,
+      "BeforeDate": 1743544740
+    }
+    MangoPay::ReportV2.create(params)
+  end
+
+  describe 'CREATE' do
+    it 'creates a report v2' do
+      created = create
+      expect(created['Id']).to_not be_nil
+      expect(created['Status']).to eq("PENDING")
+    end
+  end
+
+  describe 'GET' do
+
+    it 'gets a report' do
+      created = create
+      fetched = MangoPay::ReportV2.get(created['Id'])
+      expect(fetched['Id']).to eq(created['Id'])
+    end
+
+    it 'gets all the reports' do
+      reports = MangoPay::ReportV2.get_all
+      expect(reports).to be_kind_of(Array)
+      expect(reports).not_to be_empty
+    end
+
+  end
+
+end

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
   ###############################################
@@ -1261,7 +1273,7 @@ end
 shared_context 'recipient' do
   include_context 'users'
 
-  let(:new_recipient) { create_new_recipient(create_new_natural_user_sca_owner['Id']) }
+  let(:new_recipient) { create_new_recipient(create_new_natural_user_sca_payer['Id']) }
 
   def create_new_recipient(user_id)
     MangoPay::Recipient.create(define_new_recipient, user_id)

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.35.0
+  version: 3.36.0
 platform: ruby
 authors:
 - Geoffroy Lorieux
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-05-23 00:00:00.000000000 Z
+date: 2025-06-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: multi_json
@@ -106,6 +106,7 @@ files:
 - lib/mangopay/refund.rb
 - lib/mangopay/regulatory.rb
 - lib/mangopay/report.rb
+- lib/mangopay/report_v2.rb
 - lib/mangopay/resource.rb
 - lib/mangopay/transaction.rb
 - lib/mangopay/transfer.rb
@@ -166,6 +167,7 @@ files:
 - spec/mangopay/refund_spec.rb
 - spec/mangopay/regulatory_spec.rb
 - spec/mangopay/report_spec.rb
+- spec/mangopay/report_v2_spec.rb
 - spec/mangopay/report_wallets_spec.rb
 - spec/mangopay/shared_resources.rb
 - spec/mangopay/transaction_spec.rb
@@ -251,6 +253,7 @@ test_files:
 - spec/mangopay/refund_spec.rb
 - spec/mangopay/regulatory_spec.rb
 - spec/mangopay/report_spec.rb
+- spec/mangopay/report_v2_spec.rb
 - spec/mangopay/report_wallets_spec.rb
 - spec/mangopay/shared_resources.rb
 - spec/mangopay/transaction_spec.rb