mangopay 3.35.1 → 3.36.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 15264b27e3c6d9543eb22df8793bb0fb37870aa19d6c12c5d9c41f7ae3e37f7a
-  data.tar.gz: 8333f909cf729a462acd645a4b68aa03a048a6490fe16881eb675a818e25a0c8
+  metadata.gz: 1e7c13389de9248688caaafdb17c31f307c06626b42f3062c963001d8f0a6910
+  data.tar.gz: 57c70a006da5aa84d3250683183aafe354b3fb549099cd6d428f66b252a1623e
 SHA512:
-  metadata.gz: 2522a4843d777f4db554b7df2ab8c331d592155288fd641deaf17e19de28e426df70eeca7041e8007c9732aae4663c1fe93677d1c9a71fcb8244b7b8cf766490
-  data.tar.gz: 607684d9029548a5798d1274938f74d8c0fad61591d3ca68bf56a8a90247741d475a34ddb0dbe06c20def8f06810d6d3cdd6ceb47a75221086baf480cb30ec3b
+  metadata.gz: d662e3de61baec5457c58ef57a477a463177460acb6a7e9f193ce5e7ceef8023bb490bb9b47e10a357cec10f2444e4ee29b813af371449d6c87143695201cfeb
+  data.tar.gz: e8e73b9ce2db464f598366e6ff558980d676df136ab4f16df9e696f8995d4417163272f2bbfdd4be7c574493bd8c46dc7a68e811cf9a4412d7c5fa3c5352530d

data/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [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)

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

@@ -1,3 +1,3 @@
 module MangoPay
-  VERSION = '3.35.1'
+  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/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
 
@@ -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_owner
+      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
@@ -28,7 +28,7 @@ describe MangoPay::Recipient do
     end
 
     it 'fetches recipients with scope PAYOUT' do
-      john = create_new_natural_user_sca_owner
+      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
@@ -37,7 +37,7 @@ describe MangoPay::Recipient do
     end
 
     it 'fetches recipients with scope PAYIN' do
-      john = create_new_natural_user_sca_owner
+      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
@@ -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_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

@@ -1273,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)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mangopay
 version: !ruby/object:Gem::Version
-  version: 3.35.1
+  version: 3.36.0
 platform: ruby
 authors:
 - Geoffroy Lorieux
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-06-05 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