mangopay 3.39.1 → 3.40.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a4c2003d85e74cce6405114e6b2bb1951ff8dc5f2b192b93d72e58818d73384a
-  data.tar.gz: e1843f824d66bf29919284dff8564b47bde5e9f98d5b78528c3249fc8238a580
+  metadata.gz: a00bf00099f0f11432b94342e5c0d8a2b6ad7e6d2d1faead123624685d60f1e5
+  data.tar.gz: d1b6aa8272cf91db8e456652c8e6da8a1004534a23d664ec245d22a07e80e2f5
 SHA512:
-  metadata.gz: 40a8c923ddb2552df9f374ae06619154fad6343b8ee0eaf468c20aecd27a1c6a28cede96d21aab6ef0516fbd25d4e53cb3f67db74ce7166203f6f9b5c16e64ae
-  data.tar.gz: 371a822b8dcff55c874229dcac58688065944422ee834e38769be7bde7e56d926f03a1b0cefc5fc9facf6255a32ff8fb93383d7903a979ec4f3e29ecc9f634d8
+  metadata.gz: c6c2f7f2bfb84e5127248b1e15e058fc5badd8600abe1193766bf114c4894ef9f2378b43720c9870102b9b9577b550e028df7a2f83d1c14dc3900176fb7d9683
+  data.tar.gz: 9e99f71081327534e55c5bf1d6a32aaa37b1db8b958604976cb42c22e2cc2e0e3294c5f8848a0b9d7a3d3da8022019d87712e19b7cc0b5bca3eddfa6bdd1c498

data/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [3.40.0] - 2025-08-07
+### Added
+Support for new Splits endpoints for Echo (#294 , [API release note](https://docs.mangopay.com/release-notes/api/2025-07-16)):
+- [PUT Update a Split of an Intent](https://docs.mangopay.com/api-reference/intents/update-intent-split)
+- [POST Execute a Split of an Intent](https://docs.mangopay.com/api-reference/intents/execute-intent-split)
+- [POST Reverse the Split of an Intent](https://docs.mangopay.com/api-reference/intents/reverse-intent-split)
+- [GET View a Split of an Intent](https://docs.mangopay.com/api-reference/intents/view-intent-split)
+
+New `ReportTypes` for Echo (#295, [API release note](https://docs.mangopay.com/release-notes/api/2025-08-06))):
+- `ECHO_INTENT`
+- `ECHO_INTENT_ACTION`
+- `ECHO_SETTLEMENT`
+- `ECHO_SPLIT`
+
 ## [3.39.1] - 2025-07-28
 ### Added
 - support for new endpoint [View supported banks for Pay by Bank](https://docs.mangopay.com/api-reference/pay-by-bank/view-supported-banks-pay-by-bank), to enable presentation of banks to user before Pay by Bank payment request

data/lib/mangopay/pay_in.rb

@@ -383,6 +383,22 @@ module MangoPay
           def create(intent_id, params, idempotency_key = nil)
             MangoPay.request(:post, "#{MangoPay.api_path_v3}/payins/intents/#{intent_id}/splits", params, {}, idempotency_key)
           end
+
+          def execute(intent_id, split_id, idempotency_key = nil)
+            MangoPay.request(:post, "#{MangoPay.api_path_v3}/payins/intents/#{intent_id}/splits/#{split_id}/execute", {}, {}, idempotency_key)
+          end
+
+          def reverse(intent_id, split_id, idempotency_key = nil)
+            MangoPay.request(:post, "#{MangoPay.api_path_v3}/payins/intents/#{intent_id}/splits/#{split_id}/reverse", {}, {}, idempotency_key)
+          end
+
+          def get(intent_id, split_id)
+            MangoPay.request(:get, "#{MangoPay.api_path_v3}/payins/intents/#{intent_id}/splits/#{split_id}")
+          end
+
+          def update(intent_id, split_id, params)
+            MangoPay.request(:put, "#{MangoPay.api_path_v3}/payins/intents/#{intent_id}/splits/#{split_id}", params)
+          end
         end
       end
     end

data/lib/mangopay/version.rb

@@ -1,3 +1,3 @@
 module MangoPay
-  VERSION = '3.39.1'
+  VERSION = '3.40.0'
 end

data/spec/mangopay/payin_intent_spec.rb

@@ -75,31 +75,77 @@ describe MangoPay::PayIn::PayInIntent, type: :feature do
   #   end
   # end
 
-  describe 'CREATE SPLITS' do
+  describe 'SPLITS' do
     it 'creates a split' do
       intent = new_payin_intent_authorization
-      full_capture = {
-        "ExternalData": {
-          "ExternalProcessingDate": "01-10-2029",
-          "ExternalProviderReference": SecureRandom.uuid,
-          "ExternalMerchantReference": "Order-xyz-35e8490e-2ec9-4c82-978e-c712a3f5ba16",
-          "ExternalProviderName": "Stripe",
-          "ExternalProviderPaymentMethod": "PAYPAL"
-        }
-      }
-      MangoPay::PayIn::PayInIntent::Capture.create(intent['Id'], full_capture)
-      split = {
-        "Splits": [
-          {
-            "LineItemId": intent['LineItems'][0]['Id'],
-            "SplitAmount": 10
-          }
-        ]
-      }
-      created =  MangoPay::PayIn::PayInIntent::Split.create(intent['Id'], split)
+      created = create_new_splits(intent)
       expect(created['Splits']).to be_kind_of(Array)
       expect(created['Splits']).not_to be_empty
       expect(created['Splits'][0]['Status']).to eq('CREATED')
     end
+
+    it 'executes split' do
+      intent = new_payin_intent_authorization
+      split = create_new_splits(intent)['Splits'][0]
+      expect {
+        MangoPay::PayIn::PayInIntent::Split.execute(intent['Id'], split['Id'])
+      }.to raise_error { |err|
+        expect(err).to be_a MangoPay::ResponseError
+        expect(err.code).to eq '400'
+        expect(err.details['Type']).to eq 'param_error'
+      }
+    end
+
+    it 'reverses split' do
+      intent = new_payin_intent_authorization
+      split = create_new_splits(intent)['Splits'][0]
+      expect {
+        MangoPay::PayIn::PayInIntent::Split.reverse(intent['Id'], split['Id'])
+      }.to raise_error { |err|
+        expect(err).to be_a MangoPay::ResponseError
+        expect(err.code).to eq '400'
+        expect(err.details['Type']).to eq 'param_error'
+      }
+    end
+
+    it 'fetches split' do
+      intent = new_payin_intent_authorization
+      split = create_new_splits(intent)['Splits'][0]
+      fetched = MangoPay::PayIn::PayInIntent::Split.get(intent['Id'], split['Id'])
+      expect(fetched['Status']).to eq('CREATED')
+    end
+
+    it 'updates split' do
+      intent = new_payin_intent_authorization
+      split = create_new_splits(intent)['Splits'][0]
+      params = {
+        LineItemId: split['LineItemId'],
+        Description: 'updated split'
+      }
+      updated = MangoPay::PayIn::PayInIntent::Split.update(intent['Id'], split['Id'], params)
+      expect(updated['Description']).to eq('updated split')
+    end
+  end
+
+  def create_new_splits(intent)
+    full_capture = {
+      "ExternalData": {
+        "ExternalProcessingDate": "01-10-2029",
+        "ExternalProviderReference": SecureRandom.uuid,
+        "ExternalMerchantReference": "Order-xyz-35e8490e-2ec9-4c82-978e-c712a3f5ba16",
+        "ExternalProviderName": "Stripe",
+        "ExternalProviderPaymentMethod": "PAYPAL"
+      }
+    }
+    MangoPay::PayIn::PayInIntent::Capture.create(intent['Id'], full_capture)
+    split = {
+      "Splits": [
+        {
+          "LineItemId": intent['LineItems'][0]['Id'],
+          "SplitAmount": 10
+        }
+      ]
+    }
+    return  MangoPay::PayIn::PayInIntent::Split.create(intent['Id'], split)
   end
 end

data/spec/mangopay/recurring_payin_spec.rb

@@ -73,7 +73,7 @@ describe MangoPay::PayIn::RecurringPayments, type: :feature do
       expect(cit).not_to be_nil
 
       update = MangoPay::PayIn::RecurringPayments::Recurring.update(id, {
-        Status: 'Ended'
+        Status: 'ENDED'
       })
 
       expect(update).not_to be_nil

data/spec/mangopay/report_v2_spec.rb

@@ -17,10 +17,90 @@ describe MangoPay::ReportV2 do
       expect(created['Id']).to_not be_nil
       expect(created['Status']).to eq("PENDING")
     end
+
+    it 'creates an intent report' do
+      params = {
+        "DownloadFormat": "CSV",
+        "ReportType": "ECHO_INTENT",
+        "AfterDate": 1748782023,
+        "BeforeDate": 1753102013,
+        "Filters": {
+          "PaymentMethod": "PAYPAL",
+          "Status": "CAPTURED",
+          "Type": "PAYIN"
+        },
+        "Columns": %w[Id Status Amount Currency FeesAmount FeesCurrency Type PaymentMethod BuyerId SellerId]
+      }
+
+      created = MangoPay::ReportV2.create(params)
+      expect(created['Id']).to_not be_nil
+      expect(created['Status']).to eq("PENDING")
+      expect(created['ReportType']).to eq("ECHO_INTENT")
+    end
+
+    it 'creates an intent actions report' do
+      params = {
+        "DownloadFormat": "CSV",
+        "ReportType": "ECHO_INTENT_ACTION",
+        "AfterDate": 1748782023,
+        "BeforeDate": 1753102013,
+        "Filters": {
+          "PaymentMethod": "PAYPAL",
+          "Status": "CAPTURED",
+          "Type": "PAYIN"
+        },
+        "Columns": %w[IntentId Id ExternalProcessingDate ExternalProviderReference ExternalMerchantReference Status Amount Currency FeesAmount FeesCurrency Type PaymentMethod BuyerId SellerId]
+      }
+
+      created = MangoPay::ReportV2.create(params)
+      expect(created['Id']).to_not be_nil
+      expect(created['Status']).to eq("PENDING")
+      expect(created['ReportType']).to eq("ECHO_INTENT_ACTION")
+    end
+
+    it 'creates settlement report' do
+      params = {
+        "Tag": "Creating a report using new Mangopay system",
+        "DownloadFormat": "CSV",
+        "ReportType": "ECHO_SETTLEMENT",
+        "AfterDate": 1748782023,
+        "BeforeDate": 1753102013,
+        "Filters": {
+          "Status": "RECONCILED",
+          "ExternalProviderName": "PAYPAL"
+        },
+        "Columns": %w[Id CreationDate FileName SettlementCurrency Status SettledTransactionCount UnsettledTransactionCount SettledAmount DeclaredAmount DeficitAmount]
+      }
+
+      created = MangoPay::ReportV2.create(params)
+      expect(created['Id']).to_not be_nil
+      expect(created['Status']).to eq("PENDING")
+      expect(created['ReportType']).to eq("ECHO_SETTLEMENT")
+    end
   end
 
-  describe 'GET' do
+  it 'creates split report' do
+    params = {
+      "Tag": "Creating a report using new Mangopay system",
+      "DownloadFormat": "CSV",
+      "ReportType": "ECHO_SPLIT",
+      "AfterDate": 1748782023,
+      "BeforeDate": 1753102013,
+      "Filters": {
+        "Status": "COMPLETED",
+        "IntentId": "int_0197f975-63f6-714e-8fc6-4451e128170f",
+        "Scheduled": false
+      },
+      "Columns": %w[Id IntentId AuthorId Amount Currency FeesAmount FeesCurrency Status Description CreditedWalletId DebitedWalletId Scheduled CreationDate ExecutionDate]
+    }
+
+    created = MangoPay::ReportV2.create(params)
+    expect(created['Id']).to_not be_nil
+    expect(created['Status']).to eq("PENDING")
+    expect(created['ReportType']).to eq("ECHO_SPLIT")
+  end
 
+  describe 'GET' do
     it 'gets a report' do
       created = create
       fetched = MangoPay::ReportV2.get(created['Id'])
@@ -32,7 +112,6 @@ describe MangoPay::ReportV2 do
       expect(reports).to be_kind_of(Array)
       expect(reports).not_to be_empty
     end
-
   end
 
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mangopay
 version: !ruby/object:Gem::Version
-  version: 3.39.1
+  version: 3.40.0
 platform: ruby
 authors:
 - Geoffroy Lorieux
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-07-28 00:00:00.000000000 Z
+date: 2025-08-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: multi_json