Skip to main content

​
[3.46.0] - 2026-02-12

​
FX

​
Breaking change – Custom fees

To support percentage-based FX fees (API release note):
  • Updated tests to check for conversion custom fees and user margins

​
Echo

​
Breaking change - Settlement upload endpoints

To support the new behavior of the POST Create a Settlement endpoint to obtain an UploadUrl:
  • Updated settlement_sample.csv and tests
Caution - Breaking change
  • Replaced upload method in Settlement with generate_upload_url:
Ruby
MangoPay::Settlement.generate_upload_url({FileName: 'settlement_sample.csv'})
Caution - Breaking change
  • Replace update method in Settlement with: generate_new_upload_url
Ruby
 MangoPay::Settlement.generate_new_upload_url(@settlement['SettlementId'], {FileName: 'settlement_sample.csv'})

​
Added - GET validations for a Settlement endpoint

To support the GET View validations for a Settlement endpoint:
  • Added get_validationsmethod to Settlement
Ruby
MangoPay::Settlement.get_validations(@settlement['SettlementId'], {page: 1, per_page: 10})

​
Added - PUT Cancel a Settlement endpoint

To support the PUT Cancel a Settlement endpoint:
  • Changes: added cancel method to Settlement
Ruby
MangoPay::Settlement.cancel(@settlement['SettlementId'])

​
Added – POST Create an Intent Refund

To support POST Create an Intent Refund:
  • Added create method to Refund
Ruby
MangoPay::PayIn::PayInIntent::Refund.create(intent['Id'], dto)

​
Added – POST Reverse an Intent Refund

To support POST Reverse an Intent Refund:
  • Added reverse method to Refund
Ruby
MangoPay::PayIn::PayInIntent::Refund.reverse(intent['Id'], intent['Refund']['Id'], dto)

​
Added – POST Create an Intent Dispute

To support POST Create an Intent Dispute:
  • Added create method to Dispute
Ruby
MangoPay::PayIn::PayInIntent::Dispute.create(intent['Id'], intent['Capture']['Id'], dto)

​
Added - PUT Update an Intent Dispute

To support PUT Update an Intent Dispute:
  • Added update_outcome method to Dispute
Ruby
MangoPay::PayIn::PayInIntent::Dispute.update_outcome(intent['Id'], intent['Capture']['Id'], intent['Dispute']['Id'], dto)

​
[3.45.0] - 2025-01-30

​
Added

​
Support for new SCA status endpoint

The SDK now supports the new GET View the SCA status of a User endpoint. Added new method to lib/mangopay/user.rb:
Ruby
def get_sca_status(user_id, filters = {})
       MangoPay.request(:get, "#{MangoPay.api_path}/sca/users/#{user_id}/sca-status", {}, filters)
     end
Corresponding tests updated.

​
[3.44.0] - 2025-11-28

​
Changed

  • Migrated to V4 naming convention

​
[3.43.0] - 2025-11-19

​
Added

First batch of endpoints for direct acquiring solution (in private beta).

​
[3.42.1] - 2025-11-06

​
Improved

  • Support for case variations in error handler

​
[3.42.0] - 2025-10-27

​
Added

​
Changed

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

​
[3.41.1] - 2025-10-10

​
Added

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

​
[3.41.0] - 2025-10-01

​
Added

​
[3.40.2] - 2025-09-02

​
Changed

  • OAuth token refresh buffer before expiry updated to 30s

​
Fixed

  • Tests #302

​
[3.40.1] - 2025-08-14

​
Added

​
[3.40.0] - 2025-08-07

​
Added

Support for new Splits endpoints for Echo (API release note): New ReportTypes for Echo (API release note):
  • ECHO_INTENT
  • ECHO_INTENT_ACTION
  • ECHO_SETTLEMENT
  • ECHO_SPLIT

​
[3.39.1] - 2025-07-28

​
Added

​
[3.39.0] - 2025-07-18

​
Added

Endpoints for Mangopay Echo, a solution for platforms working with another third-party PSP for funds acquisition (including via the Mirakl Connector):

​
[3.38.0] - 2025-07-02

​
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] - 2025-06-24

​
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] - 2025-06-24

​
Added

New Reporting Service endpoints: Support for:

​
[3.35.1] - 2025-06-05

​
Added

​
Fixed

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