API Changelog Archive
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 before 2025. For recent changelog data, see API Changelog.
Enhancements
Delete Wallet - New requirement: Close virtual accounts. Effective in both sandbox and production.
Delete Virtual Account - New requirement: No transactions can be on hold for compliance review.
New Pages
Upload Documents - Methods for uploading and managing documents to payouts.
Enhancements
Delete Wallet - New requirement: Close virtual accounts. (Sandbox only).
Initiate Merchant Query - Updated phone number format.
New fields or objects
Wallet branch - New
parent_ewalletfield.Effective in both sandbox and production.
New Pages
Simulating a Payout Returned Status - Simulate the action of a third party that is required for returning the payout.
Update Beneficiary - Update a beneficiary with additional fields.
Recurring Digital Wallet Payments - Settings for subsequent Create Payment and hosted checkout page payments via digital wallets.
Enhancements
List Payout Method Types - Updated the endpoint and enhanced the response data.
Creating a Card Payment With 3DS Authentication - External 3DS - Removed the
tavvandxidfields.Card Network Lookup Service branch - Documentation improvements.
Cryptocurrency transactions:
Create Payment - Added a description and examples.
Payment Errors - Added ERROR_CRYPTOCURRENCY_PURCHASE_TRANSACTION.
New webhooks
Payment Updated Webhook - Notifies the client that a payment was updated using Update Payment.
New fields or objects
Webhook Root Parameters - Added the
extended_timestampfield. Effective in both sandbox and production.
Enhancements
Add Contact to Wallet and Update Wallet Contact -
date_of_birthrequest parameter: Added the YYYY-MM-DD format. Effective in both sandbox and production.Retrieve Card Eligibility Details - Request Body Parameters: Changed
card_tokentocard_id.Create Extended Beneficiary - Updated the date of incorporation format.
New webhooks
Wallet Status Changed Webhook - Notifies the client that the status of a wallet changed.
Wallet Closed Webhook - Notifies the client that the wallet status is permanently closed (CLO).
Virtual Account Status Webhook - Notifies the client that the status of a virtual account changed.
Breaking change
Retrieve Virtual Account Transaction - The response includes the remitter details. Retrieve Remitter Details is deprecated.
Effective in production from August 13, 2024.
New fields or objects
Create Checkout Page - Added the
recurrence_typeand therequire_card_cvvfields.Create Beneficiary Tokenization Page - Added the
beneficiary_extended_fieldsfield.
New pages
Card Network Lookup Service - New branch.
Verify Direct API Solution - New guide.
Enhancements
Add Contact to Wallet and Update Wallet Contact -
date_of_birthrequest parameter: Added the YYYY-MM-DD format (Sandbox only).
New endpoints. The deprecated endpoints are supported until March 31, 2025.
Retrieve Card Eligibility Details - Retrieve card eligibility for Original Credit Transactions (OCT) and Account Funding Transactions (AFT).
Add Card to Google Pay - Google Pay Push Provisioning - Add a card to a Google Pay wallet using Google Pay Push Provisioning.
Payout - Create a beneficiary that includes all compliance related data for payouts.
Breaking change
Create Payment - In production, the default value of
save_payment_methodis false. This now matches the sandbox behavior.
Retrieve Virtual Account Transaction - The response includes the remitter details. Retrieve Remitter Details is deprecated.
Effective in the sandbox from July 16, 2024.
New fields or objects
Payout and Beneficiary methods -
bin_detailsobject added to the relevant response parameters.Add Payment Method to Customer - Option to define
currencyinpayment_method_optionsobject. Also available in Create Customer with payment method.
New errors
Foreign Exchange Errors - ERROR_GET_FX_RATE
Effective in the sandbox from the week of July 14, 2024, and in production from the week of July 28, 2024.
Enhancements
Transaction Types- Added the
PayoutReturnCredittransaction type.Create Payout - Added the
returnedstatus.Payout Returned Webhook - Updated the scenarios when the webhook is sent.
Get FX Rate - Added note: In the sandbox, the FX rate is based on test data.
Card Numbers for Testing Payouts - New page that includes card numbers for simulating payouts and payout errors.
New endpoints. The deprecated endpoints are supported until March 31, 2025.
Breaking change
FX rates are dynamic, not daily.
New endpoint. The deprecated endpoint is supported until March 31, 2025.
New fields or objects
Create Checkout Page - Added the
required_customer_fieldsobject and thepayment_method_required_fieldsobject.
New errors
Payment Errors - ERROR_CREATE_PAYMENT_CUSTOMER_NOT_PRESENT
Enhancements
Change Wallet Status - Marked the
statusrequest path parameter as required.Delete Wallet Account Limit - Changed the body parameters to request query parameters.
New Webhook
Duplicate Contact Webhook - Notifies the client that an existing contact has been duplicated.
Breaking change
Create Payment - In the sandbox, the default value of
save_payment_methodis false. Whensave_payment_methodis false, the values ofpayment_methodandpayment_method_data.idin the response are null.Create Rapyd Verify Application - The request body
countryparameter must match the wallet contactcountryparameter.Verify Identity - The request body
countryparameter must match the wallet contactcountryparameter.Create Identity Verification Page - The request body
countryparameter is required and must match the wallet contactcountryparameter.
New fields
Create Payment Link - Added a field for indicating the the maximum number of times the payment link can be used.
Breaking change
Create Wallet -
countryfield incontactobject will be required in this method. Effective in the sandbox from the week of April 15, 2024, and in production from the week of May 6, 2024.
New endpoints. The old endpoints are deprecated but still supported.
Enhancements
Update Wallet Contact - Added the fields that can be updated only once.
Create Payment Link - Added support for FX payments.
Removed the
org_idresponse parameter from code examples and descriptions.
Breaking change
Create Wallet -
countryfield incontactobject will be required in this method. Effective in the sandbox from the week of April 15, 2024, and in production from the week of May 6, 2024.
New limitation
List Payouts - Maximum returned payouts is 1000.
New fields
Create Payment -
payment_account_reference(response)
New pages
Enhancements
Payment Method Types - Added a table summarizing the most prominent payment methods.
Create Checkout Page -
cart_itemssupports discounts.
New limitation
Transfer Funds Between Wallets - No longer available to client wallets of type collect.
New fields
Wallet transactions -
subtypeIssue Virtual Account to Wallet -
branch_code(response)
New pages
New API methods
Updated API methods
Cancel Subscription -
cancel_at_period_endis now a query parameter.Create Subscription -
simultaneous_invoicedefault value is changed to true.List Issued Cards - Added the following query parameters:
activation_end_dateactivation_start_datecreation_end_datecreation_start_datestatus
List Virtual Accounts by Rapyd Wallet - Now available in production.
Set Wallet Account Limit - Updated endpoint.
Delete Wallet Account Limit - Updated endpoint.
Update Wallet Contact - The following fields are no longer modifiable:
countrydate_of_birthfirst_nameidentification_numberidentification_typelast_namenationality
Simulating Cardholder Disputes - new field
payment_method_options.3d_required
New fields
Virtual account -
branch_code- see Issue Virtual Account to Wallet.Payout - see List Payouts.
gc_error_codebatch_file
New pages
New API methods
Updated API methods
New statuses
Wallet - CLO (closed)
New fields
Invoice
automatic_attempt_countdiscount_amount
Subscription
enable_retriesretry_options
Updated Finite State Diagrams
New manuals
New information
Deprecated API methods
Disable Wallet - replaced by Change Wallet Status but still supported.
Enable Wallet - replaced by Change Wallet Status but still supported.
New webhooks
New manuals
New endpoints. The old endpoints are deprecated but still supported.
New endpoint
Deprecated endpoints. These endpoints are deprecated but still supported.
Updated webhook:
Application Status Change Webhook - new values for
statusfield.
Payout Returned webhook - removed
Wallet transactions - new statuses HLD REJ PEN. See Transfer Funds Between Wallets.
New parameter
requested_currency- see Issue Virtual Account to Wallet.