Ruby SDK

​

3.47.0 - Mar 23, 2026

​

Added

​

Support for mTLS authentication

• Added mtls_cert, mtls_key, mtls_key_passphrase to the apply_configuration method
• Added ssl_options method which returns the existing ssl, timeout & retries config, but also appends mTLS configuration if needed
• Updated the requests logic to add the mTLS certificate if present
• Updated README.md file with details on how to configure mTLS for the SDK

​

3.46.0 - Feb 12, 2026

​

FX

​

Breaking change

​

Custom fees

• Updated tests to check for conversion custom fees and user margins

​

Echo

​

Breaking change

​

Settlement upload endpoints

• Updated settlement_sample.csv and tests

MangoPay::Settlement.generate_upload_url({FileName: 'settlement_sample.csv'})

 MangoPay::Settlement.generate_new_upload_url(@settlement['SettlementId'], {FileName: 'settlement_sample.csv'})

​

Added

​

GET validations for a Settlement endpoint

• Added get_validationsmethod to Settlement

MangoPay::Settlement.get_validations(@settlement['SettlementId'], {page: 1, per_page: 10})

​

PUT Cancel a Settlement endpoint

• Changes: added cancel method to Settlement

MangoPay::Settlement.cancel(@settlement['SettlementId'])

​

POST Create an Intent Refund

• Added create method to Refund

MangoPay::PayIn::PayInIntent::Refund.create(intent['Id'], dto)

​

POST Reverse an Intent Refund

• Added reverse method to Refund

MangoPay::PayIn::PayInIntent::Refund.reverse(intent['Id'], intent['Refund']['Id'], dto)

​

POST Create an Intent Dispute

• Added create method to Dispute

MangoPay::PayIn::PayInIntent::Dispute.create(intent['Id'], intent['Capture']['Id'], dto)

​

PUT Update an Intent Dispute

• Added update_outcome method to Dispute

MangoPay::PayIn::PayInIntent::Dispute.update_outcome(intent['Id'], intent['Capture']['Id'], intent['Dispute']['Id'], dto)

​

3.45.0 - Jan 30, 2025

​

Added

​

Support for new SCA status endpoint

def get_sca_status(user_id, filters = {})
       MangoPay.request(:get, "#{MangoPay.api_path}/sca/users/#{user_id}/sca-status", {}, filters)
     end

​

3.44.0 - Nov 28, 2025

​

Changed

• Migrated to V4 naming convention

​

3.43.0 - Nov 19, 2025

​

Added

​

3.42.1 - Nov 6, 2025

​

Improved

• Support for case variations in error handler

​

3.42.0 - Oct 27, 2025

​

Added

• New POST Manage proxy consent for a User endpoint to obtain and manage user consent via the hosted SCA experience (if proxy is activated). A proxy and user consent are now required to use the USER_NOT_PRESENT value for ScaContext (API release note)

​

Changed

• x-tenant-id deprecated as no longer necessary for UK platforms; the parameter is ignored by Mangopay

​

3.41.1 - Oct 10, 2025

​

Added

• Configuration for after_request_proc to be able to check rate limits post-request

​

3.41.0 - Oct 1, 2025

​

Added

• Support for the POST Cancel an Intent endpoint for Echo, Mangopay’s solution for platforms working with another third-party PSP for funds acquisition
• Support for POST Submit data for a PayPal PayIn endpoint

​

3.40.2 - Sep 2, 2025

​

Changed

• OAuth token refresh buffer before expiry updated to 30s

​

Fixed

• Tests #302

​

3.40.1 - Aug 14, 2025

​

Added

• Support for POST Create a Quoted Conversion between Client Wallets and POST Create an Instant Conversion between Client Wallets
• Support for POST Create a Bank Wire to the Repudiation Wallet

​

3.40.0 - Aug 7, 2025

​

Added

• PUT Update an Intent Split
• POST Execute an Intent Split
• POST Reverse an Intent Split
• GET View an Intent Split

• ECHO_INTENT
• ECHO_INTENT_ACTION
• ECHO_SETTLEMENT
• ECHO_SPLIT

​

3.39.1 - Jul 28, 2025

​

Added

• support for new endpoint View supported banks for Pay by Bank, to enable presentation of banks to user before Pay by Bank payment request

​

3.39.0 - Jul 18, 2025

​

Added

• POST Create an Intent
• GET View an Intent
• POST Create a Capture for an Intent
• POST Create a Settlement
• PUT Update a Settlement
• GET View a Settlement
• POST Create an Intent Split

​

3.38.0 - Jul 2, 2025

​

Added

• New endpoint POST Create a Bizum PayIn
• New webhook event types for SCA enrollment (API release note), note that these are triggered on enrollment not authentication:
  • SCA_ENROLLMENT_SUCCEEDED
  • SCA_ENROLLMENT_FAILED
  • SCA_ENROLLMENT_EXPIRED
• New webhook event types for UserCategory change (API release note):
  • USER_CATEGORY_UPDATED_TO_OWNER
  • USER_CATEGORY_UPDATED_TO_PAYER
  • USER_CATEGORY_UPDATED_TO_PLATFORM
• Support for PLATFORM value to UserCategory enum

​

3.37.0 - Jun 24, 2025

​

Changed

• multi_json library version updated to 1.15.0 (latest, release 2020) to enable compatibility with later versions of Ruby

⚠️ Caution - Breaking change If you use version 1.7.7 (2013) of the multi_json gem in your project, you need to update to 1.15.0 to use this version v3.37.0 of the Mangopay Ruby SDK

​

3.36.0 - Jun 24, 2025

​

Added

• POST Create a Report
• GET View a Report
• GET List all Reports

• GET List Disputes for a PayIn
• GET List Transactions for a Card Fingerprint

​

3.35.1 - Jun 5, 2025

​

Added

• Support for RecipientScope query parameter on GET List Recipients for a User
• POST Validate the format of User data

​

Fixed

• Support for legacy Payconiq integration via MangoPay::PayIn::Payconiq::Web.create_legacy (removed in error).