General Errors
Error Code | Description |
|---|---|
EMAIL_IS_VERIFIED | The request tried to verify the email address of a white level user, but the email was already verified. The request was rejected. Corrective action: Determine why an attempt was made to verify the same email twice. |
ERROR_AMOUNT_MUST_BE_POSITIVE | The request attempted an operation that requires an amount, but the amount was negative or zero. The request was rejected. Corrective action: Use a positive decimal number. |
ERROR_AMOUNT_NOT_VALID | The request tried to create a transaction, but the amount was not valid. The request was rejected. Corrective action: Set the amount to a positive decimal number. |
ERROR_BANK_IDENTIFIER_MISMATCH | The request attempted an operation that requires both an account number and a bank identifier, but the bank portion of the account number does not match the bank identifier. The request was rejected. Corrective action: Verify the account number and bank identifier and retry. |
ERROR_CARD_EXPIRED | The request attempted an operation that requires a card, but the card expired. The request was rejected. Corrective action: Advise the cardholder to contact the issuer. |
ERROR_CARD_NOT_AUTHENTICATED | The request tried to use a card ID, but the cardholder has not completed the 3DS verification process. The request was rejected. Corrective action: None. Create a new card ID and wait for the cardholder to complete the 3DS process. To create a new card ID, use 'Create Payment', 'Add Payment Method to Customer' or 'Create Card Token - Hosted Page'. |
ERROR_CARD_TRANSACTION_AMOUNT | The request attempted an operation to move funds to or from a card, but the transaction amount exceeds the limits set by the card issuer. The request was rejected. Corrective action: Advise the cardholder to contact the issuer. |
ERROR_CARD_TRANSACTION_FREQUENCY | The request attempted an operation to move funds to or from a card, but the number of times this operation has been attempted exceeds the limits set by the card issuer. The request was rejected. Corrective action: Advise the cardholder to contact the issuer. |
ERROR_CSV_FILE_NOT_VALID | The request tried to upload a CSV file, but there was a problem with the format of the file. The request was rejected. Corrective action: Use a file that has correct CSV formatting. |
ERROR_CURRENCY_NOT_AUTHORIZED | The request attempted an operation that requires a currency, but the client is not authorized to use this currency for this action. The request was rejected. Corrective action: Contact Client Support. |
ERROR_DATA_NOT_FOUND_IN_RELATED_OBJECT | The request attempted an operation that requires data from an object that is referenced in the request by ID, but the data is missing. The request was rejected. Corrective action: Update the related object. |
ERROR_DAYS_UNTIL_DUE_NOT_VALID | The request tried to set or update the 'days_until_due' parameter in an invoice or subscription, but the value was not valid. The request was rejected. Corrective action: Set 'days_until_due' to a positive integer. |
ERROR_DUPLICATE_TRANSACTION | The request attempted an operation, but the action was attempted before and completed. The request was rejected. Corrective action: None. Determine why a duplicate attempt was made. |
ERROR_GET_CARD | The request attempted an operation that requires a card ID, but the card was not found. The request was rejected. Corrective action: In the 'card' field, provide the ID or card number of a valid card. |
ERROR_LIST_PAYMENTS_PAYOUTS_QUERY_MISMATCH | The request tried to list payments or payouts filtered with query parameters, but the query parameters were mutually incompatible. The request was rejected. Corrective action: Use any combination of 'created_before' and 'created_after' or any combination of 'ending_before' and 'starting_after'. |
ERROR_MISSING_COUNTRY | The request attempted an operation that requires a country, but the country was not found. The request was rejected. Corrective action: For 'country', use the 2-letter ISO 3166-1 ALPHA-2 code, in uppercase letters. |
ERROR_REQUEST_TIMED_OUT | The request attempted an action, but it timed out. The request was probably not processed. Corrective action: Contact Rapyd Client Support. |
ERROR_STATEMENT_DESCRIPTOR_TOO_LONG | The request attempted an operation that uses a statement descriptor, but it contained too many characters. The request was rejected. Corrective action: For the 'statement_descriptor' body parameter, use a string of 1-22 alphanumeric characters and spaces.** |
ERROR_UNSUPPORTED_CURRENCY | The request attempted an operation that requires a currency, but the value is not supported. The request was rejected. Corrective action: Use a supported currency. |
ERROR_WRONG_CARD_TYPE | The request attempted an operation that requires a card, but the card number did not match the card brand. The request was rejected. Corrective action: Use the correct payment method type for the card number. |
ERROR_ZERO_AMOUNT | The request attempted an operation that would result in a zero-amount transaction. The request was rejected. Corrective action: Adjust the split or the amount so that the final amounts are all greater than zero. |
INVALID_ACCESS_KEY | The request was rejected due to an authentication issue. Corrective action: Check the status of your account in the 'Account Details' page of the Client Portal. |
INVALID_ADDRESS_FORMAT | The request attempted an operation that requires an address, but the request provided an array of addresses. The request was rejected. Corrective action: Use a single 'address' object. |
INVALID_AMOUNT | The request attempted an operation that requires an amount, but the amount was not found, was not a valid number or was out of bounds. The request was rejected. Corrective action: Use the correct amount. |
INVALID_COUNTRY | The request attempted an operation that requires a country, but the value was missing or not recognized. The request was rejected. Corrective action: Use the correct 2-letter ISO 3166-1 ALPHA-2 code for the country, in uppercase letters. |
INVALID_COUNTRY_CODE | The request attempted an operation that requires a country code, but the country code was missing or not recognized. The request was rejected. Corrective action: Use the 2-letter ISO 3166-1 ALPHA-2 country code in uppercase letters. |
INVALID_CURRENCY | The request attempted an operation that requires a currency, but the value was missing or not recognized. The request was rejected. Corrective action: Use the correct 3-letter ISO 4217 code for the currency in uppercase letters. |
INVALID_CUSTOMER_EMAIL | The request attempted an operation that requires a valid email address, but the information was not in proper email address format. The request was rejected. Corrective action: Use the correct format for an email address. |
INVALID_DESCRIPTION | The request attempted an operation that requires a description, but the description was not found. The request was rejected. Corrective action: In the 'description' field, provide a description of the operation. |
INVALID_FIELDS | The request attempted an operation, but one of the fields contained a value that is not valid. The request was rejected. Corrective action: The name of the field appears at the end of the response code. Use a valid value. |
INVALID_FIRST_NAME | The request tried to perform an operation that requires the first name of an individual, but the 'first_name' field was blank or invalid. The request was rejected. Corrective action: Provide a valid first name. |
INVALID_LIMIT | The request tried to retrieve a list of objects, but the 'limit' query parameter was not set to a valid value. The request was rejected. Corrective action: Set 'limit' to an integer between 1 and 100. |
INVALID_NAME | The request attempted an operation that requires a name, but the 'name' field was missing, empty or not recognized. The request was rejected. Corrective action: Use a valid string. |
INVALID_PAGE_NUMBER | The request attempted a GET operation that requires a page number, but the value was not recognized. The request was rejected. Corrective action: For 'page_number', use a positive integer. |
INVALID_PAGE_SIZE | The request attempted a list operation that requires the size of the page to return, but the page size was not a valid number. The request was rejected. Corrective action: For the 'page_size' query parameter, use a positive integer. |
INVALID_PARAMETER | The request attempted to retrieve records, but one of the query parameters did not have a valid value. The request was rejected. Corrective action: Use a valid value. The name of the affected parameter appears at the end of the error code. See the API Reference for details. |
INVALID_PHONE_NUMBER | The request attempted an operation that requires a phone number, but the phone number was missing or not recognized. The request was rejected. Corrective action: Use the correct number in E.164 format. |
INVALID_REGEX_FIELDS | The request attempted an operation, but one or more of the required fields did not match the expected regular expression pattern. The request was rejected. Corrective action: Use the correct regular expression pattern for all of the fields that are listed at the end of the response code. |
INVALID_ROUTING_NUMBER | The request attempted an operation that requires a bank routing number, but the number was not recognized. The request was rejected. Corrective action: Use a valid bank routing number. |
INVALID_TOKEN | The request tried to perform an operation that requires the ID of an object, but the object was not found. The request was rejected. Corrective action: Use a valid 'id' for this operation. |
MISSING_CURRENCIES | The request attempted an operation that requires a currency, but the currency was not found. The request was rejected. Corrective action: Use the three-letter ISO 4217 code, in uppercase letters. |
MISSING_FIELDS | The request attempted an operation, but one or more required fields were missing. The request was rejected. Corrective action: Provide all of the fields that are listed at the end of the error code. For more information, see the API Reference. |
MISSING_INVALID_PARAMETERS | A parameter is missing or contains an invalid value. The request was rejected. Corrective action: Check all input parameters. |
REQUEST_DECLINED | Your request was declined. For more information, please contact Rapyd Customer Service. |
REQUEST_UNDER_REVIEW | Your request is under review by Rapyd's operations department. For more information, please contact Rapyd Customer Service. |
SERVICE_TEMPORARILY_UNAVAILABLE | The request attempted an operation, but the service is temporarily unavailable. The request was rejected. Corrective action: Retry in a few minutes. If the problem persists, contact Rapyd Client Support. |
UNAUTHENTICATED_API_CALL | The request was rejected due to an authentication issue. Corrective action: Check the status of your account in the 'Account Details' page of the Client Portal. |