Skip to content

API errors

This page lists all error codes returned by Payments Direct 2.0.

Each entry includes:

  • Code
  • Type
  • Title
  • Description
  • HTTP status

User errors

If the error type is AUTH_ERROR, NOT_FOUND, or USER_ERROR, the cause may be such things as an expired auth token, a malformed request URL, or a request body that has invalid values.

The description field in the error response body for these types of errors typically includes more details about the error 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.

Complete set of API error codes

CodeTitleDescriptionStatusType
USR_001Bad requestInvalid request. Check your request parameters and try again.400USER_ERROR
USR_002Resource not foundThe requested resource could not be found.404NOT_FOUND
USR_003User errorUnable to process request due to a user error.400USER_ERROR
USR_011Invalid quoteUnable to find quote with the specified quote ID. Try again with a valid quote.404USER_ERROR
USR_012Invalid quote collectionUnable to find quote collection with the specified ID. Try again with a valid quote collection ID.404USER_ERROR
USR_013Insufficient quote amountUnable to create a quote because the quote amount is not sufficient to cover transaction fees. Try again with a larger quote amount.400USER_ERROR
USR_014Incorrect pay in categoryUnable 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.400USER_ERROR
USR_015Incorrect payout categoryUnable to create quote because the payout category you specified is not one of the supported values. Try again with a supported payout category value.400USER_ERROR
USR_016Invalid country/currency pairUnable to create a quote because the country and currency pair you provided is invalid. Try again with valid values.400USER_ERROR
USR_017Invalid request bodyUnable to create quote because one or more required fields are missing from the request body. Try again with all required fields.400USER_ERROR
USR_018Invalid quote amount typeUnable to create quote due to invalid quote amount type. The value should be one of SOURCE_AMOUNT or DESTINATION_AMOUNT.400USER_ERROR
USR_019Invalid quote amountThe quote amount value must be between 1 and 100000000. Try again with a valid value.400USER_ERROR
USR_020Invalid country codeUnable to create quote due to invalid country code in the request body. The country code should be 2 characters long.400USER_ERROR
USR_021Invalid currency codeUnable to create quote due to invalid currency code in the request body. The currency code should be 3-5 characters long.400USER_ERROR
USR_022Invalid source and destination pairUnable 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.400USER_ERROR
USR_023Invalid destination currency/payout category pairUnable to create a quote because the destinationCurrency is not supported for the specified payoutCategory. Try again with a supported destinationCurrency/payoutCategory pair.400USER_ERROR
USR_051Invalid value. 36-character long UUID is expectedUnable to parse UUID value for the specified payment field. Try again with valid UUID value.400USER_ERROR
USR_052Missing quote IDMissing value for quoteId field. Try again with valid input value.400USER_ERROR
USR_053Missing beneficiary identity IDMissing value for beneficiaryIdentityId field. Try again with valid input value.400USER_ERROR
USR_054Field size constraint violationValue of expected size is required for the specified payment field. Try again with valid input value.400USER_ERROR
USR_055Invalid request bodyUnable to create payment because the request body is empty or contains unexpected characters. Try again with all valid request body.400USER_ERROR
USR_056Missing request bodyUnable to create payment due to missing request body in JSON format. Try again with a request body.400USER_ERROR
USR_057Invalid quote IDUnable to find quote with the specified quote ID. Try again with a valid quote ID.400USER_ERROR
USR_058Quote expiredThe quote with the specified quote ID is expired. Try again with a valid quote ID.400USER_ERROR
USR_059Invalid PII dataUnable to find the identity with the specified identity ID. Try again with valid identity ID.400USER_ERROR
USR_060Mismatched use casePayment use case not supported for the specified identity.400USER_ERROR
USR_061Missing sourceOfCash or purposeCodeMissing sourceOfCash or purposeCode. See "Working with the user_info object" page for list of supported codes.400USER_ERROR
USR_062Transaction limit reachedPayment failed because you have already made the maximum number of transactions in a 24-hr period. Try again later.402USER_ERROR
USR_063Transaction amount limit exceededThe transaction amount you requested is greater than the allowed maximum per transaction.402USER_ERROR
USR_064Credit limit reachedPayment failed because you have already reached your credit limit.402USER_ERROR
USR_065User validation errorPayment could not be processed due to a validation error. Contact technical support.402USER_ERROR
USR_066Invoice past duePayment failed because you have a past-due invoice. If you have already submitted a payment confirmation, try again later or contact technical support.402USER_ERROR
USR_067Insufficient balancePayment failed due to insufficient balance. Add funds to your account and try again.402USER_ERROR
USR_068Field value constraint violationField value validation error for the request field. Try again with valid input value.400USER_ERROR
USR_069Not active PII dataThe identity with the specified identity ID is not active. Try again with valid identity ID.400USER_ERROR
USR_070Mismatching PII typeThe identity with the specified identity ID type is not matching expected type. Try again with valid identity ID.400USER_ERROR
USR_071Payment type is not allowedThe payment created is not allowed. Please submit a payment with other payment types.400USER_ERROR
USR_072Too many labelsThe request is trying to add too many labels. The maximum number of labels has been reached.400USER_ERROR
USR_073Mismatched blockchain networkThe 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.400USER_ERROR
USR_074Missing beneficiary's blockchain networkThe beneficiary id's details is missing blockchain network.400USER_ERROR
USR_075Missing or unsupported content typeThe 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.415USER_ERROR
USR_076Missing request field errorMissing required field.400USER_ERROR
USR_077Invalid requestSome required fields are missing in the request or have invalid values. Please check the request and try again.400USER_ERROR
USR_078Invalid payment return error codeThere is no mapping for the provided payment return error code. Try again with a valid payment return error code.400USER_ERROR
USR_079Invalid return payment requestPayment must be in COMPLETED status to be returned.400USER_ERROR
USR_080Invalid account numberThe specified account number is invalid or does not exist.400USER_ERROR
USR_081Invalid bank identifierThe bank identifier (e.g., SWIFT, BIC, IBAN, or routing number) is incorrect or improperly formatted.400USER_ERROR
USR_082Mismatched beneficiary detailsBeneficiary details, such as name, address, or business ID, do not match the bank account information.400USER_ERROR
USR_083Missing beneficiary financial instrument IDMissing value for Beneficiary Financial Instrument ID field. Try again with valid input value.400USER_ERROR
USR_084Financial instrument not found for beneficiaryThe specified financial instrument could not be found for the provided beneficiary identity. Verify the financial instrument ID and try again with a valid value.400USER_ERROR
USR_085Amount below minimum thresholdThe requested payment amount is below the minimum amount required for liquidation on the destination exchange. Increase the amount and try again.400USER_ERROR
USR_086Invalid sort fieldThe specified sort field is invalid. Valid sort fields are: sourceCurrency, sourceAmount, destinationCurrency, destinationCountry, destinationAmount, initiatedAt, internalId, paymentState, expiresAt, lastStateUpdatedAt, and paymentLabel.400USER_ERROR
USR_151Invalid identity informationPayment 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.400USER_ERROR
USR_152Conflicting beneficiary name infoPayment failed because both Cdtr.Nm and Cdtr.StrdNm fields are populated in the beneficiary identity information. Only one of these fields must be present.400USER_ERROR
USR_153Invalid beneficiary account identifierPayment failed because the beneficiary account identifier you provided is invalid. Create a new beneficiary identity with a valid value in the CdtrAcct.Othr.Id field.400USER_ERROR
USR_154Missing beneficiary account identification scheme codePayment failed because the beneficiary’s account identification scheme code is missing. Create a new beneficiary identity with the value specified in the CdtrAcct.Id.Othr.SchmeNm.Cd field.400USER_ERROR
USR_155Invalid beneficiary account identification scheme codePayment failed because the beneficiary’s account identification scheme code is invalid. Create a new beneficiary identity with a valid scheme code specified in the CdtrAcct.Id.Othr.SchmeNm.Cd field.400USER_ERROR
USR_156Missing beneficiary informationPayment failed because the beneficiary identity doesn’t have the required PII. Create a new beneficiary identity with the required Cdtr object and try again.400USER_ERROR
USR_157Missing beneficiary account informationPayment failed because the originator identity doesn’t have required information about the beneficiary’s account where the funds will be received. Create a new beneficiary identity with the required CdtrAcct object and try again.400USER_ERROR
USR_158Missing beneficiary namePayment failed because the beneficiary identity doesn’t contain the beneficiary’s name. Create a new beneficiary identity with the required Cdtr.Nm field (institution) or the Cdtr.StrdNm field (individual) and try again.400USER_ERROR
USR_159Missing beneficiary account identifier and typePayment failed because the beneficiary’s unique account identifier and the identifier type are missing. Create a new beneficiary identity with this information in the CdtrAcct.Id.Othr field and try again.400USER_ERROR
USR_160Missing beneficiary account identifierPayment failed because the beneficiary’s unique account identifier is missing. Create a new beneficiary identity with this information in the CdtrAcct.Id.Othr.Id field and try again.400USER_ERROR
USR_164Invalid payment amountThe payment amount you specified is greater than the maximum allowed amount. Try again with a smaller payment amount.400USER_ERROR
USR_165Invalid payment amountThe payment amount you specified is less than the minimum allowed amount. Try again with a larger payment amount.400USER_ERROR
USR_166Incorrect account numberPayment failed because the account number you provided doesn’t match the beneficiary’s account number.400USER_ERROR
USR_167Invalid originator identity IDUnable to find originator with the originatorIdentityId provided. Try again with a valid originator ID.400USER_ERROR
USR_168Invalid beneficiary identity IDUnable to find beneficiary with the beneficiaryIdentityId provided. Try again with a valid beneficiary ID.400USER_ERROR
USR_169Unable to find payment destinationPayment failed because the beneficiary’s account you specified could not be found. Try again with valid beneficiary information.400USER_ERROR
USR_171Incorrect request data formatPayment failed because one or more fields in the request contain incorrectly formatted data. Try again with correctly formatted request parameters.400USER_ERROR
USR_172Inactive beneficiary accountPayment failed because the beneficiary account you specified for this payment is inactive. Try again with a valid and active beneficiary account.400USER_ERROR
USR_173Conflicting beneficiary name infoPayment failed because both Cdtr.Nm and Cdtr.StrdNm fields are populated in the beneficiary identity information. Only one of these fields must be present.400USER_ERROR
USR_174Invalid beneficiary account informationPayment failed because there are one or more errors in the beneficiary account information. Try again with valid beneficiary account information.400USER_ERROR
USR_175Invalid beneficiary routing numberPayment failed because the bank routing number provided is invalid. Try again with a valid bank routing number.400USER_ERROR
USR_176Missing required fields in originator or beneficiary identityThe 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.500CONFIGURATION_ERROR
USR_177Invalid data in originator or beneficiary identityThe payment failed because one or more fields in the originator or beneficiary identity contain invalid data. Check the identity details and try again.500CONFIGURATION_ERROR
USR_178Invalid beneficiary bank detailsPayout 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.400USER_ERROR
USR_179Invalid originator account numberThe originator's account number is invalid or missing. Verify the account number and resubmit the payment.400USER_ERROR
USR_180Invalid beneficiary account numberThe beneficiary's account number is invalid or missing. Verify the account number and resubmit the payment.400USER_ERROR
USR_181Invalid or excessive beneficiary name lengthThe beneficiary name or address is missing, or the combined length of the name and address exceeds the maximum allowed 140 characters.400USER_ERROR
USR_182Invalid or excessive originator name lengthThe originator name or address is missing, or the combined length of the name and address exceeds the maximum allowed 140 characters.400USER_ERROR
USR_183Missing party name informationThe originator or beneficiary name is missing. Verify that both names are provided and resubmit the payment.400USER_ERROR
USR_201Transaction limit reachedPayment failed because you have already made the maximum number of transactions in a 24-hr period. Try again later.400USER_ERROR
USR_202Transaction amount limit exceededThe transaction amount you requested is greater than the allowed maximum per transaction.400USER_ERROR
USR_203Insufficient creditPayment failed because the payment amount is higher than your available credit amount.400USER_ERROR
USR_204Invoice past duePayment failed because you have a past-due invoice. If you have already submitted a payment confirmation, try again later or contact technical support.400USER_ERROR
USR_205Insufficient balancePayment failed due to insufficient balance. Add funds to your account and try again.400USER_ERROR
USR_206Too many pending direct debit transactionsPayment failed because you have too many pending direct debit transactions. Try again after some of the pending transactions are complete.400USER_ERROR
USR_251Request parameter missingThe request parameter is missing. Please provide the required parameter and try again.400USER_ERROR
USR_351File not foundUnable to find file with the specified file ID. Try again with a valid file ID.404USER_ERROR
USR_352File access deniedThis file is not available to your organization.403USER_ERROR
USR_353Invalid file nameInvalid file name. Please ensure your file name uses only letters, numbers, hyphens, underscores, and spaces.400USER_ERROR
SYS_001Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_011Quote creation failedUnable to create quote due to an internal server error.500SYSTEM_ERROR
SYS_012Quote creation failedUnable to create quote due to an internal server error.500SYSTEM_ERROR
SYS_013Quote creation failedUnable to create quote due to an internal server error.500SYSTEM_ERROR
SYS_014Quote creation failedUnable to create quote due to an internal server error.500SYSTEM_ERROR
SYS_015Quote creation failedUnable to create quote due to an internal server error.500SYSTEM_ERROR
SYS_051Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_052Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_053Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_054Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_055Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_056Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_057Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_058Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_059Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_060Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_061Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_062Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_063Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_064Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_065Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_066Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_067Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_068Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_069Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_070Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_071Payment rejectedUnable to process the request as Ripple rejected this payment.500SYSTEM_ERROR
SYS_072Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_073Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_074Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_075Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_076Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_077Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_078Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_079Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_080Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_081Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_082Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_083Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_084Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_085Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_086Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_087Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_088Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_089Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_090Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_091Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_092Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_093Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_094Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_095Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_096Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_097Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_098Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_099Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_100Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_101Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_102Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_103Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_104Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_105Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_106Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_107Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_108Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_109Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_110Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_111Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_112Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_113Account closedThe beneficiary account has been permanently closed and cannot receive payments.500SYSTEM_ERROR
SYS_114Account frozen or blockedThe account is frozen or blocked from receiving payments.500SYSTEM_ERROR
SYS_115Account type invalidThe account type cannot receive this type of payment or currency.500SYSTEM_ERROR
SYS_116Compliance policy rejectionThe beneficiary bank rejected the payment due to compliance rules, such as purpose restrictions or amount thresholds.500SYSTEM_ERROR
SYS_117Regulatory blocked paymentThe payment violates a regulation in the destination country, such as currency controls or transaction limits.500SYSTEM_ERROR
SYS_118Beneficiary authorization requiredThe beneficiary must authorize the receipt of funds before they can be credited.500SYSTEM_ERROR
SYS_119Beneficiary refused paymentThe beneficiary explicitly requested that the funds be returned.500SYSTEM_ERROR
SYS_120Bank-initiated returnThe destination bank returned the funds on behalf of their customer or based on internal policy.500SYSTEM_ERROR
SYS_121Duplicate transactionThe payment was identified as a duplicate of a previously processed transaction.500SYSTEM_ERROR
SYS_122Undisclosed return reasonThe return was processed without a specific reason provided by the destination institution.500SYSTEM_ERROR
SYS_123Callback listener retry exhaustedThe callback listener exhausted its retry after failure to process the event.500SYSTEM_ERROR
SYS_201Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_202Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_203Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_204Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_207Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_208Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_209Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_210Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_213Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_214Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_215Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_216Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_217Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_218Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_219Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_220Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_221Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_222Invalid or missing transaction identifierThe 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.500SYSTEM_ERROR
SYS_223Internal server errorPayment temporarily unavailable for this corridor. Please contact support for more information.500SYSTEM_ERROR
SYS_225Internal server errorPayment processing time has exceeded the maximum allowed limit.500SYSTEM_ERROR
SYS_301Internal server errorUnable to process the request due to an internal server error.500SYSTEM_ERROR
SYS_351Internal server errorAn error occurred while retrieving the document. Please try again later.500SYSTEM_ERROR