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.
New pages
Partner API Reference - Added a new section for partner related APIs.
Creating a Payment with Google Pay™ (decrypted) - Added instructions and samples.
New fields or objects
Create Payout >
payout_fees
>fee_currency
(Sandbox only) - Specifies a fee currency. See the new example: Payout - USDC Stablecoin with Fees.Create Payment - Added the
merchant_ewallet
field. Relevant to partners.Create Customer and Update Customer (Sandbox only) - Added AFT request body parameters:
birth_country
date_of_birth
nationality
occupation
Enhancements
Add Contact to Wallet >
business_details
>statement_descriptor
- Updated description.Card Network Errors - Updated introduction.
Partner API Reference branch - Documentation improvements.
New fields or objects
Add Payment Method to Customer- Added the
is_default
parameter.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 Partner wallet support. Effective in both sandbox and production.
Card Network Lookup Service - New section: Rapyd Wallet for Partners - Prerequisite
New section: Rapyd Wallet for Partners - Prerequisite
cnls_partner_query_reference
request and response parameter.New example: Company Wallet - Rapyd Partner
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.
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.
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
andmerchant_advice_message
. Effective in both sandbox and production.
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
andmerchant_advice_message
.