Skip to main content

Documentation

Issued Card Errors

Error Code

Description

ERROR_ACTIVATE_BLOCKED_CARD

The request tried to activate an issued card, but the card was blocked. The request was rejected. Corrective action: Contact Rapyd Client Support.

ERROR_ACTIVATE_CARD_NOT_PERSONALIZED

The request tried to activate a bulk-issued card, but the card was not personalized. The request was rejected. Corrective action: Personalize the card.

ERROR_ACTIVATE_ISSUED_CARD

The request tried to activate an issued card, but the card was not found. The request was rejected. Corrective action: For 'card_number', use the number of an issued card.

ERROR_AUTHORIZATION_INVALID_AMOUNT

The request tried to simulate an authorization operation on a card transaction, but the amount was not valid. The request was rejected. Corrective action: Set 'amount' to a positive decimal number.

ERROR_AUTHORIZATION_INVALID_CURRENCY

The request tried to simulate an authorization operation on a card transaction, but the currency was not valid. The request was rejected. Corrective action: Set 'currency' to a 3-letter ISO 4217 code.

ERROR_AUTHORIZATION_INVALID_FINANCIAL_IMPACT

The request tried to simulate an adjustment of a card transaction, but the financial impact was not valid. The request was rejected. Corrective action: Set 'financial_impact' to 'credit' or 'debit'.

ERROR_AUTHORIZATION_MISSING_AMOUNT

The request tried to simulate an authorization operation on a card transaction, but the amount was not found. The request was rejected. Corrective action: Set 'amount' to a positive decimal number.

ERROR_AUTHORIZATION_MISSING_CARD_ID

The request tried to simulate an authorization operation on a card transaction, but the card was not found. The request was rejected. Corrective action: Set 'card_id' to the card ID, a string starting with 'card'.

ERROR_AUTHORIZATION_MISSING_CARD_TRANSACTION_ID

The request tried to simulate an adjustment of a card transaction, but the transaction was not found. The request was rejected. Corrective action: Set 'card_transaction_id' to the ID of the transaction, a string starting with 'cit'.

ERROR_AUTHORIZATION_MISSING_CURRENCY

The request tried to simulate an authorization operation on a card transaction, but the currency was not found. The request was rejected. Corrective action: Set 'currency' to a 3-letter ISO 4217 code.

ERROR_AUTHORIZATION_MISSING_FINANCIAL_IMPACT

The request tried to simulate an authorization operation on a card transaction, but the financial impact was not found. The request was rejected. Corrective action: Set 'financial_impact' to 'credit' or 'debit'.

ERROR_CARD_AUTHORIZATION

The request tried to simulate an authorization operation on a card transaction, but the card was not active. The request was rejected. Corrective action: Run 'Activate Issued Card'.

ERROR_CARD_NOT_FOUND

The request attempted to retrieve data on a non-existent card or a card that is not linked to your account. The request was rejected. Corrective action: Check the card token and rerun the request with the correct card details.

ERROR_CREATE_ISSUED_CARD

The request tried to personalize a card, but the card was already personalized to another wallet contact. The request was rejected. Corrective action: For 'card_number', use the card number of a different card that was issued in bulk.

ERROR_EWALLET_ADDRESS_NOT_FOUND

The request tried to issue a card to a wallet contact, but the contact does not have an address. The request was rejected. Corrective action: Use 'Update Wallet Contact' to add an 'address' object to the contact.

ERROR_EWALLET_CONTACT_LAST_NAME_NOT_FOUND

The request tried to issue a card to a contact on a wallet, but the contact was a personal contact and did not have a last name. The request was rejected. Corrective action: Update the contact and set 'last_name', or use a business contact.

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_GET_CARD_ISSUING_TRANSACTION

The request attempted an operation that requires a transaction for an issued card, but the transaction was not found. The request was rejected. Corrective action: Use the ID of an issued card, which is a string starting with 'card', and the ID of a transaction created on that card, which is a string starting with 'cit'.

ERROR_GET_LIST_CARD_PROGRAM

The request tried to list transactions for an issued card, but the 'page_size' query parameter was not valid. The request was rejected. Corrective action: Set 'page_size' to a positive integer.

ERROR_ISSUE_CARD_CONTACT_COUNTRY_NOT_VALID

The request tried to issue a card to a wallet contact, but the country of the contact is not valid for this card program. The request was rejected. Corrective action: Use ‘Update Wallet Contact' to update 'address.country'.

ERROR_ISSUE_CARD_CONTACT_DATA_NOT_VALID

The request tried to issue a card to a wallet contact, but required data in the contact is not valid. The request was rejected. Corrective action: Use 'Update Wallet Contact' to correct the values of all of the fields listed at the end of the error code. For more information, see the API Reference.

ERROR_ISSUE_CARD_CONTACT_DATE_OF_BIRTH_NOT_VERIFIED

The request tried to issue a card to a wallet contact, but the contact's date of birth could not be verified. The request was rejected. Corrective action: Use 'Update Wallet Contact' to correct the 'date_of_birth' field.

ERROR_ISSUE_CARD_CONTACT_ID_NUMBER_NOT_VERIFIED

The request tried to issue a card to a wallet contact, but the contact's identification number could not be verified. The request was rejected. Corrective action: Resubmit the request after one minute. If the error persists, contact Client Support.

ERROR_ISSUE_CARD_CONTACT_ID_TYPE_NOT_VALID

The request tried to issue a card, but the identification type required by the card program was not provided. The request was rejected. Corrective action: Use 'Update Wallet Contact' to set 'identification_type' to 'ID'.

ERROR_ISSUE_CARD_CONTACT_STREET_ADDRESS_NOT_VALID

The request tried to issue a card to a wallet contact, but the card program requires a specific format for the street address in the contact. The request was rejected. Corrective action: Use 'Update Wallet Contact' to correct the value of the 'line_1' field mentioned at the end of the error code. The street name appears first, then an optional comma, and then the house or building number. If there is no number, use '0'.

ERROR_ISSUE_CARD_MISSING_CONTACT_DATA

The request tried to issue a card to a wallet contact, but required data is missing from the contact. The request was rejected. Corrective action: Use 'Update Wallet Contact' to add valid values to all of the fields listed at the end of the error code. For more information, see the API Reference.

ERROR_ISSUE_CARD_CONTACT_MISSING_ID_NUMBER

The request tried to issue a card to a wallet contact, but identification number required by the card program was not provided. The request was rejected. Corrective action: Use 'Update Wallet Contact' to add a valid value to the ‘identification_number’ field.

ERROR_ISSUE_CARD_CONTACT_MOTHERS_NAME_NOT_VERIFIED

The request tried to issue a card to a wallet contact, but the name of the contact's mother could not be verified. The request was rejected. Corrective action: Use 'Update Wallet Contact' to correct the 'mothers_name' field.

ERROR_ISSUE_CARD_CONTACT_NAME_NOT_VERIFIED

The request tried to issue a card to a wallet contact, but the contact's name could not be verified. The request was rejected. Corrective action: Use 'Update Wallet Contact' to correct the 'first_name' and 'last_name' fields.

ERROR_ISSUE_CARD_CONTACT_STREET_ADDRESS_NOT_VALID

The request tried to issue a card to a wallet contact, but the card program requires a specific format for the street address in the contact. The request was rejected. Corrective action: Use 'Update Wallet Contact' to correct the value of the 'line_1' field mentioned at the end of the error code. The street name appears first, then an optional comma, and then the house or building number.

ERROR_ISSUE_CARD_MISSING_CONTACT_DATA

The request tried to issue a card to a wallet contact, but required data is missing from the contact. The request was rejected. Corrective action: Use 'Update Wallet Contact' to add valid values to all of the fields listed at the end of the error code. For more information, see the API Reference.

ERROR_ISSUE_CARD_PERSONAL_CONTACT_MISSING

The request tried to issue a card to a business contact, but the company wallet does not have any personal contacts. The request was rejected. Corrective action: Run 'Add Contact to Wallet' and complete the identity verification process.

ERROR_ISSUE_CARD_PERSONAL_CONTACT_NOT_VERIFIED

The request tried to issue a card to a business contact, but none of the personal contacts in the company wallet has permissions to run transactions. The request was rejected. Corrective action: Complete the identity verification process for one of the personal contacts.

ERROR_ISSUE_CARD_PERSONAL_CONTACT_TYPE_MISMATCH

The request tried to issue a card to a personal contact, but the card program type is 'business'. The request was rejected. Corrective action: For 'card_program', use the ID of a personal card program.

ERROR_ISSUED_CARD

The request tried to issue a card, but the contact was not found. The request was rejected. Corrective action: For 'ewallet_contact', use the ID of a valid wallet contact, a string starting with 'cont'.

ERROR_ISSUED_CARD_ALREADY_ACTIVATED

The request tried to activate an issued card, but the card was already activated. The request was rejected. Corrective action: None. Determine why there were multiple attempts to activate the card.

ERROR_ISSUED_CARD_BLOCKED

The request attempted an action on an issued card, but the card is blocked. The request was rejected. Corrective action: Unblock the card.

ERROR_ISSUED_CARD_PIN_NUMBER_NOT_VALID

The request tried to set a PIN number for an issued card, but the PIN number was not valid. The request was rejected. Corrective action: Set 'new_pin' to a numeric string.

ERROR_ISSUED_CARD_PIN_FORMAT_NOT_VALID

The request tried to set a PIN for an issued card, but the format of the PIN was not valid. The request was rejected. Corrective action: Set 'new_pin' to a numeric string.

ERROR_ISSUED_CARD_STATUS_NOT_SUPPORTED

The request tried to update the status of an issued card, but the value provided was not valid. The request was rejected. Corrective action: Set 'status' to 'block' or 'unblock'.

ERROR_ISSUING_DEPOSIT

The request tried to simulate a deposit to a virtual account number that was issued to a wallet in the sandbox, but the virtual account was not found. The request was rejected. Corrective action: For 'issued_bank_account', use the ID of a Virtual Account Number that was issued to a wallet, which is a string starting with 'issuing'.

ERROR_MISSING_PIN_NUMBER

The request tried to set a PIN for an issued card, but the new PIN was not found. The request was rejected. Corrective action: Set 'new_pin' to a numeric string.

ERROR_MISSING_EWALLET_CONTACT_EWALLET_ID

The request attempted an operation that requires a wallet contact, but the contact was not found. The request was rejected. Corrective action: For 'ewalletcontact', use the ID of a valid wallet contact, a string starting with 'cont'._

ERROR_PERSONALIZE_ISSUED_CARD

The request tried to personalize an issued card, but the card was already personalized or the card number was not found. The request was rejected. Corrective action: Set 'card_number' to a valid card number.

ERROR_READ_CARD_ISSUED_DETAILS

The request attempted an operation that requires an issued card, but the card was not activated. The request was rejected. Corrective action: Activate the card.

ERROR_SIMULATE_CLEARING_FINANCIAL_IMPACT_NOT_VALID

The request tried to simulate a clearing operation on a card transaction, but the preceding simulated authorization was a credit transaction. The request was rejected. Corrective action: None. A credit transaction is complete on completion of the authorization.

ERROR_SIMULATE_CLEARING_MISSING_FIELD_FOR_FEE

The request tried to simulate a clearing operation on a card transaction, but only 'category' or 'fee_amount' was set. The request was rejected. Corrective action: Set both fields

ERROR_UPDATE_CARD_CVV_NOT_UPDATABLE

The request tried to update the CVV of a card, but this value cannot be updated. The request was rejected. Corrective action: None. Determine why an attempt was made to update the CVV.

ERROR_UPDATE_ISSUED_CARD_STATUS

The request tried to update the status of an issued card, but the card number was not found or not recognized. The request was rejected. Corrective action: For 'card_number', use the number of an issued card.

INVALID_EWALLET_TOKEN

The request tried to issue a virtual account number to a wallet, but the wallet ID was missing from the request. The request was rejected. Corrective action: In the 'ewallet' field, provide the ID of a valid wallet, a string starting with 'ewallet_'.

INVALID_ISSUED_CARD_CHANGE_STATUS

The request tried to block or unblock a card, but the card is already in that status, or it has not been activated or personalized. The request was rejected. Corrective action: If the card was issued in bulk, personalize it. If the card was issued through the API, activate it.

NOT_SUPPORTED_CARD_NUMBER_FOR_PERSONALIZE

The request tried to personalize a card, but the card was not issued in bulk. The request was rejected. Corrective action: For 'card_number', use the card number of a valid card that was issued in bulk.