API Changelog

Additions and updates to the API. Unless explicitly stated otherwise, all changes are backward compatible and non-breaking. For a list of deprecated APIs, see API Deprecation Policy.

Note

Lists the updates from 2025. For previous changelog data, see API Changelog Archive.

April 2025

New fields or objects
- Payment branch - transaction_link_id response and webhook object: Identifier to link a Mastercard transaction to future transactions. Effective in both sandbox and production.
- Create Payout - Added the crypto_payout_hash response parameter. Relevant to stablecoin payouts.
- Rapyd Platform wallet support. Effective in both sandbox and production.
  - Card Network Lookup Service - New section: Rapyd Platform Wallet for Partners - Prerequisite
  - Create Wallet:
    New section: Rapyd Platform Wallet for Partners - Prerequisite
    cnls_partner_query_reference request and response parameter.
    New example: Company Wallet - Rapyd Platform
  - Wallet:
    cnls_partner_query_reference response and webhook parameter.
    Updated relevant examples with new field.
  - Add Contact to Wallet > business_details:
    address: New note with required fields.
    New required fields: customer_service_phone_number, mcc, statement_descriptor, website_url
    Updated relevant examples in the Wallet and Wallet Contact branches.
- Transaction Types > Internal Transactions - partner_commission transaction code: Revenue shared with a Rapyd partner.

Enhancements
- List Supported Languages - Updated the sample that indicates all the supported languages.
- Create Payment - New section: Response Errors, linked to Create Payment Error Example.
- Create Payout - Added stablecoin support (USDC) and code sample.
- Get FX Rate - Added stablecoin support (USDC) and code sample.

March 2025

New fields or objects
- Payment branch - transaction_link_id response and webhook object (Sandbox only): Identifier to link a Mastercard transaction to future transactions.
- Payment branch - authentication_result response and webhook object: 3DS authentication details of a card payment.
- Payment branch - authentication_result response and webhook object > cardholder_info field: Information that the issuer provides to a cardholder during the 3DS authentication process.

February 2025

New pages
- Rapyd Error Codes - All error codes and messages.

Enhancements
- Request Rate Limits - Updated description.
- Error Messages - Updated description.

New fields or objects
- Payment branch - Merchant Advice Code (MAC) response and webhook fields: merchant_advice_code and merchant_advice_message. Effective in both sandbox and production.

January 2025

New pages
- Merchant Advice Codes - Merchant Advice Code (MAC) codes and reasons.

Enhancements
- Retrieve Card Eligibility Details - Now also available for Mastercard cards.
- Initiate Merchant Query - country request parameter - New note about sandbox limitations.
- List Supported Languages - Updated the sample that indicates all the supported languages.

New fields or objects
- Payment branch - Merchant Advice Code (MAC) response and webhook fields (Sandbox only): merchant_advice_code and merchant_advice_message.

In this section:

Documentation