This page lists all error codes returned by Payments Direct 2.0.
Each entry includes:
- Code
- Title
- Description
- HTTP status
- Type
Error codes follow a prefix naming convention that indicates the error category:
| Prefix | Type | Description |
|---|---|---|
USR_ | USER_ERROR or NOT_FOUND | The error is caused by the request. Fix the request to resolve. |
SYS_ | SYSTEM_ERROR | An internal service error occurred. Retry with exponential backoff; contact Ripple technical support if the issue persists. |
CFG_ | CONFIGURATION_ERROR | An account or service configuration issue. Contact Ripple technical support. |
AUTH_ | AUTH_ERROR | An authentication or authorization error. |
If the error type is AUTH_ERROR, NOT_FOUND, or USER_ERROR, the cause may be things such as an expired auth token, a malformed request URL, or a request body with invalid values.
The description field in the error response body for these types of errors typically includes more details and actionable information when available.
System errors
Errors with the CONFIGURATION_ERROR and SYSTEM_ERROR type are internal or server errors.
These errors cannot be overcome without Ripple's help. Contact Ripple technical support for help and provide the error information you received in the response. This includes the error code, title, error type, description, timestamp, and the API endpoint that returned the error.
| Code | Title | Description | Status | Type |
|---|---|---|---|---|
| AUTH_001 | Unauthorized | The token you provided is invalid or has expired. Generate a new access token and try again. | 401 | AUTH_ERROR |
| AUTH_002 | Forbidden | The token you provided doesn't have the required permissions for this action. | 403 | AUTH_ERROR |
| AUTH_003 | Unauthorized | The JWT issuer in the token is not recognized. Verify your authentication configuration. | 401 | AUTH_ERROR |
| AUTH_051 | Unauthorized | The payment was created by a different organization and cannot be accessed with your credentials. | 403 | AUTH_ERROR |
| Code | Title | Description | Status | Type |
|---|---|---|---|---|
| USR_001 | Bad request | Invalid request. Check your request parameters and try again. | 400 | USER_ERROR |
| USR_002 | Resource not found | The requested resource could not be found. | 404 | NOT_FOUND |
| USR_003 | User error | Unable to process request due to a user error. | 400 | USER_ERROR |
| SYS_001 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| Code | Title | Description | Status | Type |
|---|---|---|---|---|
| USR_011 | Invalid quote | Unable to find quote with the specified quote ID. Try again with a valid quote. | 404 | USER_ERROR |
| USR_012 | Invalid quote collection | Unable to find quote collection with the specified ID. Try again with a valid quote collection ID. | 404 | USER_ERROR |
| USR_013 | Insufficient quote amount | Unable to create a quote because the quote amount is not sufficient to cover transaction fees. Try again with a larger quote amount. | 400 | USER_ERROR |
| USR_014 | Incorrect pay in category | Unable to create quote because the pay in category you specified is not one of the supported values. Try again with a supported pay in category value. | 400 | USER_ERROR |
| USR_015 | Incorrect payout category | Unable to create quote because the payout category you specified is not one of the supported values. Try again with a supported payout category value. | 400 | USER_ERROR |
| USR_016 | Invalid country/currency pair | Unable to create a quote because the country and currency pair you provided is invalid. Try again with valid values. | 400 | USER_ERROR |
| USR_017 | Invalid request body | Unable to create quote because one or more required fields are missing from the request body. Try again with all required fields. | 400 | USER_ERROR |
| USR_018 | Invalid quote amount type | Unable to create quote due to invalid quote amount type. The value should be one of SOURCE_AMOUNT or DESTINATION_AMOUNT. | 400 | USER_ERROR |
| USR_019 | Invalid quote amount | The quote amount value must be between 1 and 100000000. Try again with a valid value. | 400 | USER_ERROR |
| USR_020 | Invalid country code | Unable to create quote due to invalid country code in the request body. The country code should be 2 characters long. | 400 | USER_ERROR |
| USR_021 | Invalid currency code | Unable to create quote due to invalid currency code in the request body. The currency code should be 3-5 characters long. | 400 | USER_ERROR |
| USR_022 | Invalid source and destination pair | Unable to create a quote because a payment using the specified source country, source currency, destination currency, and blockchain information is not supported. Try again with valid values. | 400 | USER_ERROR |
| USR_023 | Invalid destination currency/payout category pair | Unable to create a quote because the destinationCurrency is not supported for the specified payoutCategory. Try again with a supported destinationCurrency/payoutCategory pair. | 400 | USER_ERROR |
| USR_024 | Unsupported payment rail | Unable to create quote because the payment rail you specified is not supported for the selected corridor. Try again with a supported payment rail. | 400 | USER_ERROR |
| SYS_011 | Quote creation failed | Unable to create quote due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_012 | Quote creation failed | Unable to create quote due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_013 | Quote creation failed | Unable to create quote due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_014 | Quote creation failed | Unable to create quote due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_015 | Quote creation failed | Unable to create quote due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_016 | Quote creation failed | Unable to create quote due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_017 | Quote creation failed | Unable to create quote due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_018 | Quote creation failed | Unable to create quote due to an internal server error. | 500 | SYSTEM_ERROR |
| CFG_011 | Invalid configuration | Unable to create a quote due to a configuration issue. Contact Ripple technical support for help. | 500 | CONFIGURATION_ERROR |
| CFG_012 | Invalid configuration | Unable to create a quote due to a configuration issue. Contact Ripple technical support for help. | 500 | CONFIGURATION_ERROR |
| CFG_013 | Invalid configuration | Unable to create a quote due to a configuration issue. Contact Ripple technical support for help. | 500 | CONFIGURATION_ERROR |
| CFG_014 | Invalid configuration | Unable to create a quote due to a configuration issue. Contact Ripple technical support for help. | 500 | CONFIGURATION_ERROR |
| CFG_015 | Invalid configuration | Unable to create a quote due to a configuration issue. Contact Ripple technical support for help. | 500 | CONFIGURATION_ERROR |
| CFG_016 | Invalid configuration | Unable to create a quote due to a configuration issue. Contact Ripple technical support for help. | 500 | CONFIGURATION_ERROR |
| CFG_017 | Invalid configuration | Unable to create a quote due to a configuration issue. Contact Ripple technical support for help. | 500 | CONFIGURATION_ERROR |
| CFG_018 | Invalid configuration | Unable to create a quote due to a configuration issue. Contact Ripple technical support for help. | 500 | CONFIGURATION_ERROR |
HTTP 402 status
Several payment creation errors return HTTP 402 (Payment Required) rather than 400. This indicates that the request itself is valid, but the payment cannot proceed due to an account-level condition such as insufficient balance or a limit being reached. Resolve the condition before retrying.
| Code | Title | Description | Status | Type |
|---|---|---|---|---|
| USR_051 | Invalid value. 36-character long UUID is expected | Unable to parse UUID value for the specified payment field. Try again with valid UUID value. | 400 | USER_ERROR |
| USR_052 | Missing quote ID | Missing value for quoteId field. Try again with valid input value. | 400 | USER_ERROR |
| USR_053 | Missing beneficiary identity ID | Missing value for beneficiaryIdentityId field. Try again with valid input value. | 400 | USER_ERROR |
| USR_054 | Field size constraint violation | Value of expected size is required for the specified payment field. Try again with valid input value. | 400 | USER_ERROR |
| USR_055 | Invalid request body | Unable to create payment because the request body is empty or contains unexpected characters. Try again with a valid request body. | 400 | USER_ERROR |
| USR_056 | Missing request body | Unable to create payment due to missing request body in JSON format. Try again with a request body. | 400 | USER_ERROR |
| USR_057 | Invalid quote ID | Unable to find quote with the specified quote ID. Try again with a valid quote ID. | 400 | USER_ERROR |
| USR_058 | Quote expired | The quote with the specified quote ID is expired. Try again with a valid quote ID. | 400 | USER_ERROR |
| USR_059 | Invalid PII data | Unable to find the identity with the specified identity ID. Try again with valid identity ID. | 400 | USER_ERROR |
| USR_060 | Mismatched use case | Payment use case not supported for the specified identity. | 400 | USER_ERROR |
| USR_061 | Missing sourceOfCash or purposeCode | Missing sourceOfCash or purposeCode. See "Working with the user_info object" page for list of supported codes. | 400 | USER_ERROR |
| USR_062 | Transaction limit reached | Payment failed because you have already made the maximum number of transactions in a 24-hr period. Try again later. | 402 | USER_ERROR |
| USR_063 | Transaction amount limit exceeded | The transaction amount you requested is greater than the allowed maximum per transaction. Reduce the amount and try again. | 402 | USER_ERROR |
| USR_064 | Credit limit reached | Payment failed because you have already reached your credit limit. Try again after your credit limit resets, or contact Ripple technical support to review your limit. | 402 | USER_ERROR |
| USR_065 | User validation error | Payment could not be processed because your account has been flagged for a validation issue. Contact Ripple technical support for assistance. | 402 | USER_ERROR |
| USR_066 | Invoice past due | Payment failed because you have a past-due invoice. If you have already submitted a payment confirmation, try again later or contact Ripple technical support. | 402 | USER_ERROR |
| USR_067 | Insufficient balance | Payment failed due to insufficient balance. Add funds to your account and try again. | 402 | USER_ERROR |
| USR_068 | Field value constraint violation | Field value validation error for the request field. Try again with valid input value. | 400 | USER_ERROR |
| USR_069 | Not active PII data | The identity with the specified identity ID is not active. Try again with valid identity ID. | 400 | USER_ERROR |
| USR_070 | Mismatching PII type | The identity with the specified identity ID type is not matching expected type. Try again with valid identity ID. | 400 | USER_ERROR |
| USR_071 | Payment type is not allowed | The payment created is not allowed. Please submit a payment with other payment types. | 400 | USER_ERROR |
| USR_072 | Too many labels | The request is trying to add too many labels. The maximum number of labels has been reached. | 400 | USER_ERROR |
| USR_073 | Mismatched blockchain network | The blockchain network associated with the payment's beneficiary doesn't match the blockchain network you specified in the quote. Try again with a valid blockchain network value. | 400 | USER_ERROR |
| USR_074 | Missing beneficiary's blockchain network | The beneficiary id's details is missing blockchain network. | 400 | USER_ERROR |
| USR_075 | Missing or unsupported content type | The request is either missing the 'Content-Type' header or the header contains an unsupported value. Set the 'Content-Type' header value to 'application/json' and try again. | 415 | USER_ERROR |
| USR_076 | Missing request field error | Missing required field. | 400 | USER_ERROR |
| USR_077 | Invalid request | Some required fields are missing in the request or have invalid values. Please check the request and try again. | 400 | USER_ERROR |
| USR_078 | Invalid payment return error code | There is no mapping for the provided payment return error code. Try again with a valid payment return error code. | 400 | USER_ERROR |
| USR_079 | Invalid return payment request | Payment must be in COMPLETED status to be returned. | 400 | USER_ERROR |
| USR_080 | Invalid account number | The specified account number is invalid or does not exist. | 400 | USER_ERROR |
| USR_081 | Invalid bank identifier | The bank identifier (e.g., SWIFT, BIC, IBAN, or routing number) is incorrect or improperly formatted. | 400 | USER_ERROR |
| USR_082 | Mismatched beneficiary details | Beneficiary details, such as name, address, or business ID, do not match the bank account information. | 400 | USER_ERROR |
| USR_083 | Missing beneficiary financial instrument ID | Missing value for Beneficiary Financial Instrument ID field. Try again with valid input value. | 400 | USER_ERROR |
| USR_084 | Financial instrument not found for beneficiary | The specified financial instrument could not be found for the provided beneficiary identity. Verify the financial instrument ID and try again with a valid value. | 400 | USER_ERROR |
| USR_085 | Amount below minimum threshold | The requested payment amount is below the minimum amount required for liquidation on the destination exchange. Increase the amount and try again. | 400 | USER_ERROR |
| USR_086 | Invalid sort field | The specified sort field is invalid. Valid sort fields are: sourceCurrency, sourceAmount, destinationCurrency, destinationCountry, destinationAmount, initiatedAt, internalId, paymentState, expiresAt, lastStateUpdatedAt, and paymentLabel. | 400 | USER_ERROR |
| USR_088 | JIT funding timeout | Payment failed because funds were not received within the required funding window. Create a new payment and ensure funds are transferred within the funding window before retrying. | 400 | USER_ERROR |
| USR_089 | JIT funding disabled | Just-In-Time (JIT) funding has been disabled for this account. Contact Ripple technical support for assistance. | 403 | USER_ERROR |
| USR_090 | Required field missing | A required field is missing or empty in the request. Review the request parameters and resubmit. | 400 | USER_ERROR |
| SYS_051 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_052 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_053 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_054 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_055 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_056 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_057 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_058 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_059 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_060 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_061 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_062 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_063 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_064 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_065 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_066 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_067 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_068 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_069 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_070 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_071 | Payment declined | Unable to process the request as Ripple declined this payment. | 500 | SYSTEM_ERROR |
| SYS_072 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_073 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_074 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_075 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_076 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_077 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_078 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_079 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_080 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_081 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_082 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_083 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_084 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_085 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_086 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_087 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_088 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_089 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_090 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_091 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_092 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_093 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_094 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_095 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_096 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_097 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_098 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_099 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_100 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_101 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_102 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_103 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_104 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_105 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_106 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_107 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_108 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_109 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_110 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_111 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_112 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_113 | Account closed | The beneficiary account has been permanently closed and cannot receive payments. | 500 | SYSTEM_ERROR |
| SYS_114 | Account frozen or blocked | The account is frozen or blocked from receiving payments. | 500 | SYSTEM_ERROR |
| SYS_115 | Account type invalid | The account type cannot receive this type of payment or currency. | 500 | SYSTEM_ERROR |
| SYS_116 | Compliance policy rejection | The beneficiary bank declined the payment due to compliance rules, such as purpose restrictions or amount thresholds. | 500 | SYSTEM_ERROR |
| SYS_117 | Regulatory blocked payment | The payment violates a regulation in the destination country, such as currency controls or transaction limits. | 500 | SYSTEM_ERROR |
| SYS_118 | Beneficiary authorization required | The beneficiary must authorize the receipt of funds before they can be credited. | 500 | SYSTEM_ERROR |
| SYS_119 | Beneficiary refused payment | The beneficiary explicitly requested that the funds be returned. | 500 | SYSTEM_ERROR |
| SYS_120 | Bank-initiated return | The destination bank returned the funds on behalf of their customer or based on internal policy. | 500 | SYSTEM_ERROR |
| SYS_121 | Duplicate transaction | The payment was identified as a duplicate of a previously processed transaction. | 500 | SYSTEM_ERROR |
| SYS_122 | Undisclosed return reason | The return was processed without a specific reason provided by the destination institution. | 500 | SYSTEM_ERROR |
| SYS_123 | Callback listener retry exhausted | The callback listener exhausted its retry after failure to process the event. | 500 | SYSTEM_ERROR |
| CFG_051 | Invalid configuration | The payment failed due to a configuration issue. Contact Ripple technical support for help. | 500 | CONFIGURATION_ERROR |
| CFG_052 | Invalid configuration | The payment failed due to a configuration issue. Contact Ripple technical support for help. | 500 | CONFIGURATION_ERROR |
| CFG_053 | Invalid configuration | The payment failed due to a configuration issue. Contact Ripple technical support for help. | 500 | CONFIGURATION_ERROR |
| CFG_054 | Invalid configuration | The payment failed due to a configuration issue. Contact Ripple technical support for help. | 500 | CONFIGURATION_ERROR |
| CFG_055 | Invalid configuration | The payment failed due to a configuration issue. Contact Ripple technical support for help. | 500 | CONFIGURATION_ERROR |
| CFG_056 | Invalid configuration | The payment failed due to a configuration issue. Contact Ripple technical support for help. | 500 | CONFIGURATION_ERROR |
| CFG_057 | Invalid configuration | The payment failed due to a configuration issue. Contact Ripple technical support for help. | 500 | CONFIGURATION_ERROR |
| CFG_058 | Invalid liquidation configuration | The payment failed due to an invalid or unsupported liquidation configuration. Contact Ripple technical support to verify the corridor configuration. | 500 | CONFIGURATION_ERROR |
| Code | Title | Description | Status | Type |
|---|---|---|---|---|
| USR_151 | Invalid identity information | Payment failed due to one or more errors in the beneficiary identity details. Modify the existing beneficiary identity or create a new beneficiary identity with valid values and try again. | 400 | USER_ERROR |
| USR_152 | Conflicting beneficiary name info | Payment failed because both Cdtr.Nm and Cdtr.StrdNm fields are populated in the beneficiary identity information. Only one of these fields must be present. | 400 | USER_ERROR |
| USR_164 | Invalid payment amount | The payment amount you specified is greater than the maximum allowed amount. Try again with a smaller payment amount. | 400 | USER_ERROR |
| USR_165 | Invalid payment amount | The payment amount you specified is less than the minimum allowed amount. Try again with a larger payment amount. | 400 | USER_ERROR |
| USR_166 | Incorrect account number | Payment failed because the account number you provided doesn't match the beneficiary's account number. | 400 | USER_ERROR |
| USR_167 | Invalid originator identity ID | Unable to find originator with the originatorIdentityId provided. Try again with a valid originator ID. | 400 | USER_ERROR |
| USR_168 | Invalid beneficiary identity ID | Unable to find beneficiary with the beneficiaryIdentityId provided. Try again with a valid beneficiary ID. | 400 | USER_ERROR |
| USR_169 | Unable to find payment destination | Payment failed because the beneficiary's account you specified could not be found. Try again with valid beneficiary information. | 400 | USER_ERROR |
| USR_171 | Incorrect request data format | Payment failed because one or more fields in the request contain incorrectly formatted data. Try again with correctly formatted request parameters. | 400 | USER_ERROR |
| USR_172 | Inactive beneficiary account | Payment failed because the beneficiary account you specified for this payment is inactive. Try again with a valid and active beneficiary account. | 400 | USER_ERROR |
| USR_173 | Conflicting beneficiary name info | Payment failed because both Cdtr.Nm and Cdtr.StrdNm fields are populated in the beneficiary identity information. Only one of these fields must be present. | 400 | USER_ERROR |
| USR_175 | Invalid beneficiary routing number | Payment failed because the bank routing number provided is invalid. Try again with a valid bank routing number. | 400 | USER_ERROR |
| USR_176 | Missing required fields in originator or beneficiary identity | The payment failed because one or more required fields are missing or empty in the originator or beneficiary identity. Check the identity details and try again. | 500 | CONFIGURATION_ERROR |
| USR_177 | Invalid data in originator or beneficiary identity | The payment failed because one or more fields in the originator or beneficiary identity contain invalid data. Check the identity details and try again. | 500 | CONFIGURATION_ERROR |
| USR_178 | Invalid beneficiary bank details | Payout failed because the beneficiary bank details are invalid or not recognized. This can occur when the identifier type or value is incorrect or missing, or when the creditor bank is not registered or addressable under that identifier in the clearing system. | 400 | USER_ERROR |
| USR_179 | Invalid originator account number | The originator's account number is invalid or missing. Verify the account number and resubmit the payment. | 400 | USER_ERROR |
| USR_180 | Invalid beneficiary account number | The beneficiary's account number is invalid or missing. Verify the account number and resubmit the payment. | 400 | USER_ERROR |
| USR_181 | Invalid or excessive beneficiary name length | The beneficiary name or address is missing, or the combined length of the name and address exceeds the maximum allowed 140 characters. | 400 | USER_ERROR |
| USR_182 | Invalid or excessive originator name length | The originator name or address is missing, or the combined length of the name and address exceeds the maximum allowed 140 characters. | 400 | USER_ERROR |
| USR_183 | Missing party name information | The originator or beneficiary name is missing. Verify that both names are provided and resubmit the payment. | 400 | USER_ERROR |
| USR_184 | Transaction limit exceeded | The total transaction amount allowed for this beneficiary or originator within the allowed time period has been exceeded. Try again later. | 400 | USER_ERROR |
| USR_185 | Invalid originator identity information | Payment failed due to one or more errors in the originator identity details. Modify the existing originator identity or create a new originator identity with valid values and try again. | 400 | USER_ERROR |
| USR_186 | Missing required field | A required field is missing from the request. Check the request body and resubmit. | 400 | USER_ERROR |
| USR_187 | Field length too short | A field in the request is too short. Check the minimum length requirements and resubmit. | 400 | USER_ERROR |
| USR_188 | Field length too long | A field in the request exceeds the maximum allowed length. Check the length requirements and resubmit. | 400 | USER_ERROR |
| USR_189 | Invalid field format | A field in the request has an incorrect format. Check the field format requirements and resubmit. | 400 | USER_ERROR |
| USR_190 | Unsupported field value | A field in the request contains an unsupported value. Check the allowed values and resubmit. | 400 | USER_ERROR |
| SYS_201 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_203 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_207 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_210 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_213 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_214 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_215 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_216 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_217 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_218 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_219 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_221 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_222 | Invalid or missing transaction identifier | The transaction identifier is missing, exceeds the maximum allowed length, or is invalid. Verify that sender_End_To_End_Id, internal ID, or external transaction ID complies with the required format. | 500 | SYSTEM_ERROR |
| SYS_224 | Internal server error | The transaction has been cancelled. | 500 | SYSTEM_ERROR |
| SYS_225 | Internal server error | Payment processing time has exceeded the maximum allowed limit. | 500 | SYSTEM_ERROR |
| SYS_227 | Payment declined | Unable to process the request as Ripple declined this payment. | 500 | SYSTEM_ERROR |
| CFG_101 | Invalid configuration | The payment failed due to a configuration issue. Contact Ripple technical support for help. | 500 | CONFIGURATION_ERROR |
| CFG_102 | Invalid configuration | The payment failed due to a configuration issue. Contact Ripple technical support for help. | 500 | CONFIGURATION_ERROR |
| Code | Title | Description | Status | Type |
|---|---|---|---|---|
| USR_201 | Transaction limit reached | Payment failed because you have already made the maximum number of transactions in a 24-hr period. Try again later. | 400 | USER_ERROR |
| USR_202 | Transaction amount limit exceeded | The transaction amount you requested is greater than the allowed maximum per transaction. | 400 | USER_ERROR |
| USR_203 | Insufficient credit | Payment failed because the payment amount is higher than your available credit amount. | 400 | USER_ERROR |
| USR_204 | Invoice past due | Payment failed because you have a past-due invoice. If you have already submitted a payment confirmation, try again later or contact Ripple technical support. | 400 | USER_ERROR |
| USR_205 | Insufficient balance | Payment failed due to insufficient balance. Add funds to your account and try again. | 400 | USER_ERROR |
| USR_206 | Too many pending direct debit transactions | Payment failed because you have too many pending direct debit transactions. Try again after some of the pending transactions are complete. | 400 | USER_ERROR |
| Code | Title | Description | Status | Type |
|---|---|---|---|---|
| USR_251 | Request parameter missing | The request parameter is missing. Please provide the required parameter and try again. | 400 | USER_ERROR |
| SYS_301 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| CFG_201 | Invalid configuration | Unable to retrieve account balances due to a configuration issue. Contact Ripple technical support for help. | 500 | CONFIGURATION_ERROR |
| Code | Title | Description | Status | Type |
|---|---|---|---|---|
| USR_351 | File not found | Unable to find file with the specified file ID. Try again with a valid file ID. | 404 | USER_ERROR |
| USR_352 | File access denied | This file is not available to your organization. | 403 | USER_ERROR |
| USR_353 | Invalid file name | Invalid file name. Please ensure your file name uses only letters, numbers, hyphens, underscores, and spaces. | 400 | USER_ERROR |
| SYS_351 | Internal server error | An error occurred while retrieving the document. Please try again later. | 500 | SYSTEM_ERROR |
| Code | Title | Description | Status | Type |
|---|---|---|---|---|
| USR_101 | Bad request | Invalid request. Check your request body and try again. | 400 | USER_ERROR |
| USR_102 | Bad request | Unable to get identity. Identity ID should be in UUID format. | 400 | USER_ERROR |
| USR_103 | Identity not found | No identity exists for the specified identity ID. | 404 | NOT_FOUND |
| USR_104 | Invalid request | The identity has already been deactivated. | 422 | USER_ERROR |
| USR_105 | Too many requests | Too many requests. Try again later. | 429 | USER_ERROR |
| USR_106 | Invalid account number | The account number you provided is invalid. Verify the account number and try again. | 400 | USER_ERROR |
| USR_107 | Invalid request | Invalid request. Provide the "PstlAdr.AdrLine" value as an array and try again. | 400 | USER_ERROR |
| USR_108 | Invalid request | Invalid request. One or more required fields are missing. Check the request body and try again. | 400 | USER_ERROR |
| USR_109 | Invalid request | Invalid request. One or more fields contain an invalid format. Check the request body and try again. | 400 | USER_ERROR |
| USR_110 | Financial instrument already exists | A financial instrument already exists for this identity. Retrieve the existing financial instrument or create a new identity. | 409 | USER_ERROR |
| USR_111 | Invalid request | The request failed validation. Check the request body for errors and try again. | 400 | USER_ERROR |
| USR_112 | Financial instrument not found | No financial instrument exists for the specified financial instrument ID. | 404 | USER_ERROR |
| USR_113 | Unprocessable entity | The requested API operation version cannot modify this data entry. Use a compatible API version and try again. | 422 | USER_ERROR |
| USR_114 | Unsupported operation | The requested API operation is not supported. Check the API documentation for supported operations and try again. | 405 | USER_ERROR |
| USR_115 | Identity already deactivated | The identity has already been deactivated. | 409 | USER_ERROR |
| USR_116 | Invalid next token | Invalid pagination token provided. Provide a valid token and try again. | 400 | USER_ERROR |
| USR_117 | Concurrent update conflict | The identity could not be created or updated because another process was modifying the same identity at the same time. Retry the request after a short delay. | 409 | USER_ERROR |
| USR_118 | Identity already exists | The internal ID you provided is already in use by another identity. Retrieve the existing identity or use a unique internal ID. | 409 | USER_ERROR |
| USR_119 | Operation not allowed for this tenant | This operation is not permitted for this tenant. Contact Ripple technical support for assistance. | 403 | USER_ERROR |
| USR_120 | Maximum financial instruments reached | Unable to add a financial instrument because the maximum number of financial instruments has been reached for this identity. | 422 | USER_ERROR |
| USR_121 | Identity not found | No identity exists for the specified internal ID. | 404 | NOT_FOUND |
| SYS_151 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_152 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_153 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| Code | Title | Description | Status | Type |
|---|---|---|---|---|
| SYS_251 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_252 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_253 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_254 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_255 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_256 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_257 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_258 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_259 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_260 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| SYS_261 | Internal server error | Unable to process the request due to an internal server error. | 500 | SYSTEM_ERROR |
| CFG_151 | Invalid configuration | Payment failed due to invalid configuration. Contact Ripple technical support for help. | 500 | CONFIGURATION_ERROR |
| CFG_152 | Account blocked | Payment failed because your account was blocked by an automated process. If you believe this is an error, contact Ripple technical support for help. | 500 | CONFIGURATION_ERROR |
| CFG_153 | Invalid configuration | Payment failed due to invalid configuration. Contact Ripple technical support for help. | 500 | CONFIGURATION_ERROR |
| CFG_154 | Invalid configuration | Payment failed due to a configuration issue. Contact Ripple technical support for help. | 500 | CONFIGURATION_ERROR |