mangopay4-ruby-sdk 3.45.0 → 3.48.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 34a20d61f0af4ebbb27b23462855b1e3245dea990232708c2cadf541388a1d3e
-  data.tar.gz: 0c60b1686a83da66bbc35eff7d79c2dc76669b433d30ade26005fbff5804d6d2
+  metadata.gz: 674878e4aba915f0f767a1a58f76f9330bb0000628d0ea0d5fca7ca124eaa3bc
+  data.tar.gz: 5a4dcd8a5b50557536daf8f57b82fb8ebefa8c73cb963a4e5087ab6dfaf6b4e9
 SHA512:
-  metadata.gz: 401e7578d63593838a3ddd30ccf4f51a7dc954d03a425eddbc3328e872692adf9fc2b16c3ab96310b31de856bdd6e000e63adee0fa5b0aaae8197f3ddd9258ee
-  data.tar.gz: 3f33993df417398540c62ed379f07b00a6a7fafd3115803b18f1fda163138ea7b431577bbcd933de503e45647a523983600cb29de7c7046b6897127254f4e884
+  metadata.gz: d69b73f8eba11516e2cd4c93992732a0eddcc02ab3ba6aa9779b9c692b3a827f17078dba7ce6654d3e2dccf59ab218717dc58111c368ebf790eb17bef05b5df2
+  data.tar.gz: f1c53aa135c0f4343522bb7d5df8c65ae7d31654a42075cc39322ecbb394c4538777458b54e369bf9dec1549c3b5e9502246d3186b2d716dc2f29016a77ac46e

data/CHANGELOG.md

@@ -1,3 +1,63 @@
+## [3.48.0] - 2026-03-25
+### Removed
+- Payconiq PayIn (`MangoPay::PayIn::PayconiqWeb::Create`) removed following provider discontinuation on 4 Dec 2025 (#334)
+
+## [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

@@ -147,22 +147,6 @@ module MangoPay
 
     end
 
-    module Payconiq
-
-      class Web < Resource
-        include HTTPCalls::Create
-
-        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
-
     module ApplePay
       class Direct < Resource
         include HTTPCalls::Create
@@ -409,6 +393,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.48.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

@@ -358,34 +358,6 @@ shared_context 'payins' do
     )
   end
 
-  ###############################################
-  # payconiq/web
-  ###############################################
-
-  let(:new_payin_payconiq_web) do
-    MangoPay::PayIn::Payconiq::Web.create(
-      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
-
-  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
   ###############################################
@@ -1225,7 +1197,8 @@ shared_context 'instant_conversion' do
       },
       Fees: {
         Currency: 'EUR',
-        Amount: 9
+        Amount: 10,
+        Type: 'PERCENTAGE'
       },
       Tag: 'Instant conversion test'
     )
@@ -1259,6 +1232,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.48.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-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: multi_json
@@ -159,7 +159,6 @@ files:
 - spec/mangopay/payin_mbway_web_spec.rb
 - spec/mangopay/payin_multibanco_web_spec.rb
 - spec/mangopay/payin_paybybank_web_spec.rb
-- spec/mangopay/payin_payconiq_web_spec.rb
 - spec/mangopay/payin_paypal_web_spec.rb
 - spec/mangopay/payin_preauthorized_direct_spec.rb
 - spec/mangopay/payin_satispay_web_spec.rb
@@ -176,6 +175,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
@@ -250,7 +250,6 @@ test_files:
 - spec/mangopay/payin_mbway_web_spec.rb
 - spec/mangopay/payin_multibanco_web_spec.rb
 - spec/mangopay/payin_paybybank_web_spec.rb
-- spec/mangopay/payin_payconiq_web_spec.rb
 - spec/mangopay/payin_paypal_web_spec.rb
 - spec/mangopay/payin_preauthorized_direct_spec.rb
 - spec/mangopay/payin_satispay_web_spec.rb
@@ -267,6 +266,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

data/spec/mangopay/payin_payconiq_web_spec.rb

@@ -1,32 +0,0 @@
-describe MangoPay::PayIn::Payconiq::Web, type: :feature do
-  include_context 'payins'
-
-  def check_type_and_status(payin)
-    expect(payin['Type']).to eq('PAYIN')
-    expect(payin['Nature']).to eq('REGULAR')
-    expect(payin['PaymentType']).to eq('PAYCONIQ')
-    expect(payin['ExecutionType']).to eq('WEB')
-
-    # not SUCCEEDED yet: waiting for processing
-    expect(payin['Status']).to eq('CREATED')
-    expect(payin['ResultCode']).to be_nil
-    expect(payin['ResultMessage']).to be_nil
-    expect(payin['ExecutionDate']).to be_nil
-  end
-
-  describe 'CREATE' do
-    it 'creates a payconiq web payin' do
-      created = new_payin_payconiq_web
-      expect(created['Id']).not_to be_nil
-      check_type_and_status(created)
-    end
-
-    # endpoint removed
-    xit '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