mangopay4-ruby-sdk 3.46.0 → 3.48.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ebeaec3cb872600bd73956fbf11d134bc90c5d4eb858e4a5873ff1dc020bbe56
-  data.tar.gz: 0df0444dd4be33ca5936d3d911250287cddafc339aa9275c35fbfc264e3d2d21
+  metadata.gz: 674878e4aba915f0f767a1a58f76f9330bb0000628d0ea0d5fca7ca124eaa3bc
+  data.tar.gz: 5a4dcd8a5b50557536daf8f57b82fb8ebefa8c73cb963a4e5087ab6dfaf6b4e9
 SHA512:
-  metadata.gz: 474b4ec9b214ea50d75aec50506818aba748f9b2c279919ba8849d4749b716151411a8a5a0e6240d16744b70ea8341342188c89e6db471269a83c8a93c7e4757
-  data.tar.gz: b9e6f1e6636a116c2f670849a61839964d11a2298304c0ad0be7584a4024a9415f42f5861bf630effca9a964084f8baa0f7a9f49e3848f1c35f1df21663ea6c3
+  metadata.gz: d69b73f8eba11516e2cd4c93992732a0eddcc02ab3ba6aa9779b9c692b3a827f17078dba7ce6654d3e2dccf59ab218717dc58111c368ebf790eb17bef05b5df2
+  data.tar.gz: f1c53aa135c0f4343522bb7d5df8c65ae7d31654a42075cc39322ecbb394c4538777458b54e369bf9dec1549c3b5e9502246d3186b2d716dc2f29016a77ac46e

data/CHANGELOG.md

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

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

data/lib/mangopay/version.rb

@@ -1,3 +1,3 @@
 module MangoPay
-  VERSION = '3.46.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/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,7 @@ shared_context 'instant_conversion' do
       },
       Fees: {
         Currency: 'EUR',
-        Amount: 0.01,
+        Amount: 10,
         Type: 'PERCENTAGE'
       },
       Tag: 'Instant conversion test'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mangopay4-ruby-sdk
 version: !ruby/object:Gem::Version
-  version: 3.46.0
+  version: 3.48.0
 platform: ruby
 authors:
 - Geoffroy Lorieux
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-12 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
@@ -251,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

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