mangopay4-ruby-sdk 3.45.0 → 3.47.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 34a20d61f0af4ebbb27b23462855b1e3245dea990232708c2cadf541388a1d3e
-  data.tar.gz: 0c60b1686a83da66bbc35eff7d79c2dc76669b433d30ade26005fbff5804d6d2
+  metadata.gz: 8cc10e268ef7f7029a76cd99da66abdcfbe9a76c7cd1b938992e102758e4396e
+  data.tar.gz: 947581ca00b8c352e07be28d4bf5f21f28211a15f6c69afc6595aa669f201249
 SHA512:
-  metadata.gz: 401e7578d63593838a3ddd30ccf4f51a7dc954d03a425eddbc3328e872692adf9fc2b16c3ab96310b31de856bdd6e000e63adee0fa5b0aaae8197f3ddd9258ee
-  data.tar.gz: 3f33993df417398540c62ed379f07b00a6a7fafd3115803b18f1fda163138ea7b431577bbcd933de503e45647a523983600cb29de7c7046b6897127254f4e884
+  metadata.gz: 7deab526bea4f06430b8b0ce51ee9d7208a7c6e103abb0cced837e4463bf634f5a686215e8ca3a547d57a685b0a7b61912efcb9fb46455c592a96555d6b5a2de
+  data.tar.gz: 1dd444f37f32c14ea3f74d9fa12e40a1d1957eee20be9bb121c8707e7df13d6d92a7bd3e07e37756abec1addb3f53e9b0320fa84d451e69dcb02abff99533db8

data/CHANGELOG.md

@@ -1,3 +1,59 @@
+## [3.47.0] - 2026-03-19
+### Added - mTLS certificates support
+- mTLS certificates are now configurable in the SDK via file paths or encoded strings
+
+## [3.46.0] - 2026-02-12
+### FX
+
+#### Breaking change – Custom fees
+#329
+To support percentage-based FX fees ([API release note](/release-notes/api/2026-02-11)):
+-  Updated tests to check for conversion custom fees
+
+#### Added – User margin
+#329
+To support the FX user margin ([API release note](/release-notes/api/2026-02-11)):
+-  Updated tests to check for conversion user margins
+
+### Echo
+
+#### Breaking change - Settlement upload endpoints
+#325
+To support the new behavior of the [POST Create a Settlement](/api-reference/settlements/create-settlement) endpoint to obtain an `UploadUrl`:
+- Updated `settlement_sample.csv` and tests
+- **Breaking change** – Replaced `upload` method in `Settlement` with `generate_upload_url`:
+- **Breaking change** – Replaced `update` method in `Settlement` with `generate_new_upload_url`:
+
+#### Added - GET validations for a Settlement endpoint
+#325
+To support the [GET View validations for a Settlement](/api-reference/settlements/view-settlement-validations) endpoint:
+- Added `get_validations` method to `Settlement`
+
+#### Added - PUT Cancel a Settlement endpoint
+#325
+To support the [PUT Cancel a Settlement](/api-reference/settlements/cancel-settlement) endpoint:
+- Added `cancel` method to `Settlement`
+
+#### Added – POST Create a Refund of an Intent
+#324
+To support [POST Create a Refund of an Intent](/api-reference/intents/create-intent-refund):
+- Added `create` method to `Refund`
+
+#### Added – POST Reverse the Refund of an Intent
+#324
+To support [POST Reverse the Refund of an Intent](/api-reference/intents/create-intent-refund):
+- Added `reverse` method to `Refund`
+
+#### Added – POST Create a Dispute of an Intent
+#324
+To support [POST Create a Dispute of an Intent](/api-reference/intents/create-intent-refund):
+- Added `create` method to `Dispute`
+
+#### Added - PUT Update an Intent Dispute
+#324
+To support [PUT Update an Intent Dispute](/api-reference/intents/create-intent-dispute):
+- Added `update_outcome` method to `Dispute`
+
 ## [3.45.0] - 2026-01-27
 ### Added
 - Support for new [GET View the SCA status of a User](https://docs.mangopay.com/api-reference/users/view-user-sca-status) endpoint ([API release note](https://docs.mangopay.com/release-notes/api/2026-01-15)) (#326)

data/README.md

@@ -19,6 +19,61 @@ or by adding it to your Gemfile ```gem 'mangopay4-ruby-sdk'```
 
 * Call ```MangoPay.configure``` in your script as shown in the snippet below.
 
+## mTLS configuration
+### Set the base URL for mTLS
+
+Using mTLS authentication requires your integration to call a base URL with a different hostname from the standard API:
+
+* Sandbox: `https://api-mtls.sandbox.mangopay.com`
+* Production: `https://api-mtls.mangopay.com`
+
+If using mTLS, your integration should use the `api-mtls` URLs for all API calls, including OAuth token generation.
+
+**Caution:** Ensure you set the mTLS base URL, as shown in the configuration examples below. If you don’t, the mTLS certificate will not be transferred to Mangopay. When mTLS is enforced, your integration will result in an error.
+
+### Configure the SDK’s mTLS properties
+
+The Ruby SDK’s mTLS properties accept one of:
+
+* **Base64-encoded string** – To load the certificate content from environment variables
+* **File path** – To point to the locally stored file, for example during testing
+
+  | Property              | Type              | Description                                                                              |
+  | --------------------- | ----------------- |------------------------------------------------------------------------------------------|
+  | `mtls_cert`           | string            | Base64-encoded string of the certificate content or path to the certificate `.pem` file. |
+  | `mtls_private_key`    | string            | Base64-encoded string of the private key content or path to the private `.key` file.     |
+  | `mtls_key_passphrase` | string (optional) | String passphrase if the private key is encrypted.                                       |
+
+#### Base64-encoded strings
+
+  ```ruby  theme={null}
+  MangoPay.configure do |c|
+    c.client_id    = 'your-mangopay-client-id'
+    c.client_apiKey = 'your-mangopay-api-key'
+    c.root_url = 'https://api-mtls.sandbox.mangopay.com' # mTLS base URL
+    c.preproduction = true
+
+    c.mtls_cert           = ENV['CERTIFICATE_PEM_B64']  # Base64-encoded string
+    c.mtls_key            = ENV['PRIVATE_KEY_B64']   # Base64-encoded string
+    c.mtls_key_passphrase = ENV['YOUR_CERT_PASSPHRASE'] # optional, if encrypted
+  end
+  ```
+
+#### File paths
+
+  ```ruby  theme={null}
+  MangoPay.configure do |c|
+    c.client_id    = 'your-mangopay-client-id'
+    c.client_apiKey = 'your-mangopay-api-key'
+    c.root_url = 'https://api-mtls.sandbox.mangopay.com' # mTLS base URL
+    c.preproduction = true
+
+    c.mtls_cert           = '/path/to/certificate.pem' # file path
+    c.mtls_key            = '/path/to/private.key' # file path 
+    c.mtls_key_passphrase = 'your-cert-passphrase' # optional, if encrypted
+  end
+  ```
+
 ### Usage
 
 ```ruby

data/lib/mangopay/pay_in.rb

@@ -409,6 +409,30 @@ module MangoPay
           end
         end
       end
+
+      class Refund < Resource
+        class << self
+          def create(intent_id, params, idempotency_key = nil)
+            MangoPay.request(:post, "#{MangoPay.api_path_v3}/payins/intents/#{intent_id}/refunds", params, {}, idempotency_key)
+          end
+
+          def reverse(intent_id, refund_id, params, idempotency_key = nil)
+            MangoPay.request(:post, "#{MangoPay.api_path_v3}/payins/intents/#{intent_id}/refunds/#{refund_id}/reverse", params, {}, idempotency_key)
+          end
+        end
+      end
+
+      class Dispute < Resource
+        class << self
+          def create(intent_id, capture_id, params, idempotency_key = nil)
+            MangoPay.request(:post, "#{MangoPay.api_path_v3}/payins/intents/#{intent_id}/captures/#{capture_id}/disputes", params, {}, idempotency_key)
+          end
+
+          def update_outcome(intent_id, capture_id, dispute_id, params, idempotency_key = nil)
+            MangoPay.request(:put, "#{MangoPay.api_path_v3}/payins/intents/#{intent_id}/captures/#{capture_id}/disputes/#{dispute_id}/decision", params, {}, idempotency_key)
+          end
+        end
+      end
     end
 
   end

data/lib/mangopay/settlement.rb

@@ -2,9 +2,9 @@ module MangoPay
 
   class Settlement < Resource
     class << self
-      def upload(file, idempotency_key = nil)
+      def generate_upload_url(settlement, idempotency_key = nil)
         url = "#{MangoPay.api_path_v3}/payins/intents/settlements"
-        MangoPay.request_multipart(:post, url, file, 'settlement_file.csv', idempotency_key)
+        MangoPay.request(:post, url, settlement, {}, idempotency_key)
       end
 
       def get(settlement_id)
@@ -12,9 +12,19 @@ module MangoPay
         MangoPay.request(:get, url)
       end
 
-      def update(settlement_id, file, idempotency_key = nil)
+      def generate_new_upload_url(settlement_id, settlement)
         url = "#{MangoPay.api_path_v3}/payins/intents/settlements/#{settlement_id}"
-        MangoPay.request_multipart(:put, url, file, 'settlement_file.csv', idempotency_key)
+        MangoPay.request(:put, url, settlement, {})
+      end
+
+      def get_validations(settlement_id, filters = {})
+        url = "#{MangoPay.api_path_v3}/payins/intents/settlements/#{settlement_id}/validations"
+        MangoPay.request(:get, url, {}, filters)
+      end
+
+      def cancel(settlement_id, idempotency_key = nil)
+        url = "#{MangoPay.api_path_v3}/payins/intents/settlements/#{settlement_id}/cancel"
+        MangoPay.request(:post, url, {}, {}, idempotency_key)
       end
     end
   end

data/lib/mangopay/version.rb

@@ -1,3 +1,3 @@
 module MangoPay
-  VERSION = '3.45.0'
+  VERSION = '3.47.0'
 end

data/lib/mangopay.rb

@@ -1,4 +1,6 @@
 require 'net/http'
+require 'openssl'
+require 'base64'
 require 'cgi/util'
 require 'digest/md5'
 require 'multi_json'
@@ -67,7 +69,8 @@ module MangoPay
                   :temp_dir, :log_file, :log_trace_headers, :http_timeout,
                   :http_max_retries, :http_open_timeout,
                   :logger, :use_ssl, :uk_header_flag,
-                  :after_request_proc
+                  :after_request_proc,
+                  :mtls_cert, :mtls_key, :mtls_key_passphrase
 
     def apply_configuration
       MangoPay.configure do |config|
@@ -83,6 +86,9 @@ module MangoPay
         config.logger = @logger
         config.uk_header_flag = @uk_header_flag
         config.after_request_proc = @after_request_proc
+        config.mtls_cert = @mtls_cert
+        config.mtls_key = @mtls_key
+        config.mtls_key_passphrase = @mtls_key_passphrase
       end
     end
 
@@ -226,9 +232,7 @@ module MangoPay
         headers['x-tenant-id'] = 'uk'
       end
 
-      res = Net::HTTP.start(uri.host, uri.port, :use_ssl => configuration.use_ssl?, :read_timeout => configuration.http_timeout,
-                            :max_retries => configuration.http_max_retries,
-                            :open_timeout => configuration.http_open_timeout, ssl_version: :TLSv1_2) do |http|
+      res = Net::HTTP.start(uri.host, uri.port, **ssl_options) do |http|
         req = Net::HTTP::const_get(method.capitalize).new(uri.request_uri, headers)
         req.body = JSON.dump(params)
         before_request_proc.call(req) if before_request_proc
@@ -296,12 +300,7 @@ module MangoPay
       # Join string parts and ensure binary content is preserved
       body = multipart_body.map { |part| part.is_a?(String) ? part.force_encoding("ASCII-8BIT") : part }.join("\r\n")
 
-      res = Net::HTTP.start(uri.host, uri.port,
-                            use_ssl: configuration.use_ssl?,
-                            read_timeout: configuration.http_timeout,
-                            open_timeout: configuration.http_open_timeout,
-                            max_retries: configuration.http_max_retries,
-                            ssl_version: :TLSv1_2) do |http|
+      res = Net::HTTP.start(uri.host, uri.port, **ssl_options) do |http|
         req_class = Net::HTTP.const_get(method.capitalize)
         req = req_class.new(uri.request_uri, headers)
         req.body = body
@@ -380,6 +379,38 @@ module MangoPay
       end
     end
 
+    def ssl_options
+      opts = {
+        use_ssl:      configuration.use_ssl?,
+        read_timeout: configuration.http_timeout,
+        open_timeout: configuration.http_open_timeout,
+        max_retries:  configuration.http_max_retries,
+      }
+
+      if defined?(OpenSSL::SSL::TLS1_2_VERSION)
+        opts[:min_version] = OpenSSL::SSL::TLS1_2_VERSION
+      else
+        opts[:ssl_version] = :TLSv1_2
+      end
+
+      if configuration.mtls_cert && configuration.mtls_key
+        cert_pem = file_or_pem(configuration.mtls_cert)
+        key_pem  = file_or_pem(configuration.mtls_key)
+        opts[:cert] = OpenSSL::X509::Certificate.new(cert_pem)
+        opts[:key]  = OpenSSL::PKey.read(key_pem, configuration.mtls_key_passphrase)
+      end
+
+      opts
+    end
+
+    def file_or_pem(value)
+      if File.exist?(value)
+        File.read(value)
+      else
+        Base64.decode64(value)
+      end
+    end
+
     def do_request(http, req, uri)
       if logs_required?
         do_request_with_log(http, req, uri)

data/spec/mangopay/conversion_spec.rb

@@ -17,7 +17,10 @@ describe MangoPay::Conversion, type: :feature do
       expect(conversion['DebitedFunds']['Amount']).not_to be_nil
       expect(conversion['CreditedFunds']['Amount']).not_to be_nil
       expect(conversion['Fees']['Amount']).not_to be_nil
+      expect(conversion['RequestedFees']['Value']).not_to be_nil
       expect(conversion['Status']).equal? 'SUCCEEDED'
+      expect(conversion['MarginsResponse']['Mangopay']).not_to be_nil
+      expect(conversion['MarginsResponse']['User']).to be_nil
     end
   end
 
@@ -77,10 +80,14 @@ describe MangoPay::Conversion, type: :feature do
 
   describe 'CREATE CONVERSION QUOTE' do
     it 'create a conversion quote' do
-      conversion_quote = create_conversion_quote
+      conversion_quote = create_conversion_quote_with_fees
       expect(conversion_quote['DebitedFunds']).not_to be_nil
       expect(conversion_quote['CreditedFunds']).not_to be_nil
       expect(conversion_quote['Duration']).equal? 90
+      expect(conversion_quote['Fees']['Amount']).not_to be_nil
+      expect(conversion_quote['RequestedFees']['Value']).not_to be_nil
+      expect(conversion_quote['MarginsResponse']['Mangopay']).not_to be_nil
+      expect(conversion_quote['MarginsResponse']['User']).not_to be_nil
     end
   end
 

data/spec/mangopay/payin_intent_spec.rb

@@ -10,18 +10,7 @@ describe MangoPay::PayIn::PayInIntent, type: :feature do
     end
 
     it 'creates a payin intent full capture' do
-      intent = new_payin_intent_authorization
-      to_create = {
-        "ExternalData": {
-          "ExternalProcessingDate": "01-10-2029",
-          "ExternalProviderReference": SecureRandom.uuid,
-          "ExternalMerchantReference": "Order-xyz-35e8490e-2ec9-4c82-978e-c712a3f5ba16",
-          "ExternalProviderName": "Stripe",
-          "ExternalProviderPaymentMethod": "PAYPAL"
-        }
-      }
-
-      created = MangoPay::PayIn::PayInIntent::Capture.create(intent['Id'], to_create)
+      created = create_new_intent_full_capture
       expect(created['Id']).not_to be_nil
       expect(created['Status']).to eq('CAPTURED')
     end
@@ -122,6 +111,137 @@ describe MangoPay::PayIn::PayInIntent, type: :feature do
     end
   end
 
+  describe 'Intent Refund' do
+    it 'creates a full refund' do
+      created_refund = create_new_intent_full_refund
+      expect(created_refund['Id']).not_to be_nil
+      expect(created_refund['Status']).to eq('REFUNDED')
+    end
+
+    it 'creates a partial refund' do
+      full_capture = create_new_intent_full_capture
+      to_create = {
+        "Amount": 1000,
+        "LineItems": [
+          {
+            "Id": full_capture['LineItems'][0]['Id'],
+            "Amount": 1000
+          }
+        ],
+        "ExternalData": {
+          "ExternalProcessingDate": 1727913600,
+          "ExternalProviderReference": SecureRandom.uuid,
+          "ExternalMerchantReference": SecureRandom.uuid,
+          "ExternalProviderName": "Stripe",
+          "ExternalProviderPaymentMethod": "PAYPAL"
+        }
+      }
+      created_refund = MangoPay::PayIn::PayInIntent::Refund.create(full_capture['Id'], to_create)
+      expect(created_refund['Id']).not_to be_nil
+      expect(created_refund['Status']).to eq('REFUNDED')
+    end
+
+    it 'fully reverses a refund' do
+      created_refund = create_new_intent_full_refund
+      to_create = {
+        "ExternalData": {
+          "ExternalProcessingDate": 1727913600,
+          "ExternalProviderReference": SecureRandom.uuid,
+          "ExternalMerchantReference": SecureRandom.uuid,
+          "ExternalProviderName": "Stripe",
+          "ExternalProviderPaymentMethod": "PAYPAL"
+        }
+      }
+      reversed_refund = MangoPay::PayIn::PayInIntent::Refund.reverse(created_refund['Id'], created_refund['Refund']['Id'], to_create)
+      expect(reversed_refund['Id']).not_to be_nil
+      expect(reversed_refund['Status']).to eq('REFUND_REVERSED')
+    end
+
+    it 'partially reverses a refund' do
+      created_refund = create_new_intent_full_refund
+      to_create = {
+        "Amount": 1000,
+        "LineItems": [
+          {
+            "Id": created_refund['LineItems'][0]['Id'],
+            "Amount": 1000
+          }
+        ],
+        "ExternalData": {
+          "ExternalProcessingDate": 1727913600,
+          "ExternalProviderReference": SecureRandom.uuid,
+          "ExternalMerchantReference": SecureRandom.uuid,
+          "ExternalProviderName": "Stripe",
+          "ExternalProviderPaymentMethod": "PAYPAL"
+        }
+      }
+      reversed_refund = MangoPay::PayIn::PayInIntent::Refund.reverse(created_refund['Id'], created_refund['Refund']['Id'], to_create)
+      expect(reversed_refund['Id']).not_to be_nil
+      expect(reversed_refund['Status']).to eq('REFUND_REVERSED')
+    end
+
+    it 'creates a full dispute' do
+      capture = create_new_intent_full_capture
+      to_create = {
+        "ExternalData": {
+          "ExternalProcessingDate": 1727913600,
+          "ExternalProviderReference": SecureRandom.uuid,
+          "ExternalMerchantReference": SecureRandom.uuid,
+          "ExternalProviderName": "Stripe",
+          "ExternalProviderPaymentMethod": "PAYPAL"
+        }
+      }
+      created_dispute = MangoPay::PayIn::PayInIntent::Dispute.create(capture['Id'], capture['Capture']['Id'], to_create)
+      expect(created_dispute['Id']).not_to be_nil
+      expect(created_dispute['Status']).to eq('DISPUTED')
+    end
+
+    it 'creates a partial dispute' do
+      capture = create_new_intent_full_capture
+      to_create = {
+        "Amount": 1000,
+        "LineItems": [
+          {
+            "Id": capture['LineItems'][0]['Id'],
+            "Amount": 1000
+          }
+        ],
+        "ExternalData": {
+          "ExternalProcessingDate": 1727913600,
+          "ExternalProviderReference": SecureRandom.uuid,
+          "ExternalMerchantReference": SecureRandom.uuid,
+          "ExternalProviderName": "Stripe",
+          "ExternalProviderPaymentMethod": "PAYPAL"
+        }
+      }
+      created_dispute = MangoPay::PayIn::PayInIntent::Dispute.create(capture['Id'], capture['Capture']['Id'], to_create)
+      expect(created_dispute['Id']).not_to be_nil
+      expect(created_dispute['Status']).to eq('DISPUTED')
+    end
+
+    it 'updates dispute outcome' do
+      capture = create_new_intent_full_capture
+      to_create = {
+        "ExternalData": {
+          "ExternalProcessingDate": 1727913600,
+          "ExternalProviderReference": SecureRandom.uuid,
+          "ExternalMerchantReference": SecureRandom.uuid,
+          "ExternalProviderName": "Stripe",
+          "ExternalProviderPaymentMethod": "PAYPAL"
+        }
+      }
+      created_dispute = MangoPay::PayIn::PayInIntent::Dispute.create(capture['Id'], capture['Capture']['Id'], to_create)
+
+      dto = {
+        "Decision": "DEFENDED"
+      }
+      updated = MangoPay::PayIn::PayInIntent::Dispute.update_outcome(capture['Id'], capture['Capture']['Id'], created_dispute['Dispute']['Id'], dto)
+
+      expect(updated['Id']).not_to be_nil
+      expect(updated['Decision']).to eq('DEFENDED')
+    end
+  end
+
   def create_new_splits(intent)
     full_capture = {
       "ExternalData": {
@@ -143,4 +263,33 @@ describe MangoPay::PayIn::PayInIntent, type: :feature do
     }
     return  MangoPay::PayIn::PayInIntent::Split.create(intent['Id'], split)
   end
+
+  def create_new_intent_full_capture
+    intent = new_payin_intent_authorization
+    to_create = {
+      "ExternalData": {
+        "ExternalProcessingDate": "01-10-2029",
+        "ExternalProviderReference": SecureRandom.uuid,
+        "ExternalMerchantReference": "Order-xyz-35e8490e-2ec9-4c82-978e-c712a3f5ba16",
+        "ExternalProviderName": "Stripe",
+        "ExternalProviderPaymentMethod": "PAYPAL"
+      }
+    }
+
+    return MangoPay::PayIn::PayInIntent::Capture.create(intent['Id'], to_create)
+  end
+
+  def create_new_intent_full_refund
+    full_capture = create_new_intent_full_capture
+    to_create = {
+      "ExternalData": {
+        "ExternalProcessingDate": 1727913600,
+        "ExternalProviderReference": SecureRandom.uuid,
+        "ExternalMerchantReference": SecureRandom.uuid,
+        "ExternalProviderName": "Stripe",
+        "ExternalProviderPaymentMethod": "PAYPAL"
+      }
+    }
+    return MangoPay::PayIn::PayInIntent::Refund.create(full_capture['Id'], to_create)
+  end
 end

data/spec/mangopay/settlement_sample.csv

@@ -1,8 +1,8 @@
-IntentId,ExternalProviderReference,ExternalPaymentMethod,ExternalTransactionType,ExternalTransactionStatus,ExternalProcessingDate,Amount,Currency,ExternalInitialReference,ExternalProviderFees
-int_0197b19d-ee51-7b60-84cb-207491cf383a,6TU984332A894613W,PAYPAL,PAYMENT,SETTLED,19-06-2025,1000,EUR,,0
-,,,,,,,,,
-SettlementDate,19-06-2025,,,,,,,,
-ExternalProviderName,Paypal,,,,,,,,
-TotalSettlementFeesAmount,0,,,,,,,,
-TotalSettlementAmount,1000,,,,,,,,
-SettlementCurrency,EUR,,,,,,,,
+ExternalProviderReference,ExternalPaymentMethod,ExternalTransactionType,ExternalTransactionStatus,ExternalProcessingDate,Amount,Currency,ExternalInitialReference,ExternalProviderFees
+6TU984332A894613W,PAYPAL,PAYMENT,SETTLED,19-06-2025,1000,EUR,,0
+,,,,,,,,
+SettlementDate,19-06-2025,,,,,,,
+ExternalProviderName,Paypal,,,,,,,
+TotalSettlementFeesAmount,0,,,,,,,
+TotalNetSettlementAmount,1000,,,,,,,
+SettlementCurrency,EUR,,,,,,,

data/spec/mangopay/settlement_sample_bad.csv

@@ -0,0 +1,8 @@
+ExternalProviderReference,ExternalPaymentMethod,ExternalTransactionType,ExternalTransactionStatus,ExternalProcessingDate,Amount,Currency,ExternalInitialReference,ExternalProviderFees
+6TU984332A894613W,PAYPAL,PAYMENT,SETTLED,19-06-2025,1000,EUR,,0
+,,,,,,,,
+SettlementDate,19-06-2025,,,,,,,
+ExternalProviderName,Paypal,,,,,,,
+TotalSettlementFeesAmount,0,,,,,,,
+TotalNetSettlementAmount,999999,,,,,,,
+SettlementCurrency,EUR,,,,,,

data/spec/mangopay/settlement_spec.rb

@@ -6,33 +6,60 @@ describe MangoPay::Settlement do
 
   def create_settlement_if_needed
     @settlement ||= begin
-                      file_path = File.expand_path('settlement_sample.csv', __dir__)
-                      file = File.binread(file_path)
-                      MangoPay::Settlement.upload(file)
+                      MangoPay::Settlement.generate_upload_url({FileName: 'settlement_sample.csv'})
                     end
   end
 
+  def upload_file(upload_url, file_name)
+    file_path = File.expand_path(file_name, __dir__)
+    file_content = File.binread(file_path)
+
+    uri = URI(upload_url)
+    http = Net::HTTP.new(uri.host, uri.port)
+    http.use_ssl = (uri.scheme == 'https')
+
+    request = Net::HTTP::Put.new(uri)
+    request.body = file_content
+    request['Content-Type'] = 'text/csv'
+
+    http.request(request)
+  end
+
   describe 'UPLOAD' do
+    it 'generates the upload URL' do
+      expect(@settlement['SettlementId']).not_to be_nil
+      expect(@settlement['UploadUrl']).not_to be_nil
+    end
+
+    it 'generates a new upload URL' do
+      new_url = MangoPay::Settlement.generate_new_upload_url(@settlement['SettlementId'], {FileName: 'settlement_sample.csv'})
+      expect(new_url['SettlementId']).not_to be_nil
+      expect(new_url['UploadUrl']).not_to be_nil
+    end
+
     it 'uploads the file' do
-      expect(@settlement['Status']).to eq('UPLOADED')
+      response = upload_file(@settlement['UploadUrl'], 'settlement_sample.csv')
+      expect(response.code.to_i).to eq(200)
+    end
+
+    it 'fetches validations' do
+      upload_file(@settlement['UploadUrl'], 'settlement_sample_bad.csv')
+      validations = MangoPay::Settlement.get_validations(@settlement['SettlementId'], {page: 1, per_page: 10})
+      expect(validations).not_to be_nil
     end
   end
 
   describe 'GET' do
     it 'fetches the file' do
       fetched = MangoPay::Settlement.get(@settlement['SettlementId'])
-      expect(fetched['Status']).to eq('UPLOADED')
+      expect(fetched['Status']).to eq('PENDING_UPLOAD')
     end
   end
 
-  describe 'UPDATE' do
-    it 'updates the file' do
-      file_path = File.expand_path('settlement_sample.csv', __dir__)
-      file = File.binread(file_path)
-      before_update = MangoPay::Settlement.upload(file)
-      expect(before_update['Status']).to eq('UPLOADED')
-      updated = MangoPay::Settlement.update(before_update['SettlementId'], file)
-      expect(updated['Status']).to eq('UPLOADED')
+  describe 'CANCEL' do
+    it 'cancels the settlement' do
+      fetched = MangoPay::Settlement.cancel(@settlement['SettlementId'])
+      expect(fetched['Status']).to eq('CANCELLED')
     end
   end
 end

data/spec/mangopay/shared_resources.rb

@@ -1225,7 +1225,8 @@ shared_context 'instant_conversion' do
       },
       Fees: {
         Currency: 'EUR',
-        Amount: 9
+        Amount: 0.01,
+        Type: 'PERCENTAGE'
       },
       Tag: 'Instant conversion test'
     )
@@ -1259,6 +1260,24 @@ shared_context 'instant_conversion' do
     )
   end
 
+  def create_conversion_quote_with_fees
+    MangoPay::Conversion.create_quote(
+      CreditedFunds:  { Currency: 'GBP' },
+      DebitedFunds:  { Currency: 'EUR', Amount: 50 },
+      Duration: 300,
+      Tag: 'Created using the Mangopay Ruby SDK',
+      Fees: {
+        Currency: 'EUR',
+        Amount: 1,
+        Type: 'FIXED'
+      },
+      UserMargin: {
+        Type: "PERCENTAGE",
+        Value: 0.01
+      }
+    )
+  end
+
   def get_conversion(id)
     MangoPay::Conversion.get(id, params = {})
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mangopay4-ruby-sdk
 version: !ruby/object:Gem::Version
-  version: 3.45.0
+  version: 3.47.0
 platform: ruby
 authors:
 - Geoffroy Lorieux
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-01-30 00:00:00.000000000 Z
+date: 2026-03-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: multi_json
@@ -176,6 +176,7 @@ files:
 - spec/mangopay/report_v2_spec.rb
 - spec/mangopay/report_wallets_spec.rb
 - spec/mangopay/settlement_sample.csv
+- spec/mangopay/settlement_sample_bad.csv
 - spec/mangopay/settlement_spec.rb
 - spec/mangopay/shared_resources.rb
 - spec/mangopay/transaction_spec.rb
@@ -267,6 +268,7 @@ test_files:
 - spec/mangopay/report_v2_spec.rb
 - spec/mangopay/report_wallets_spec.rb
 - spec/mangopay/settlement_sample.csv
+- spec/mangopay/settlement_sample_bad.csv
 - spec/mangopay/settlement_spec.rb
 - spec/mangopay/shared_resources.rb
 - spec/mangopay/transaction_spec.rb