Entity Errors
API entities such as payments and cards are processed asynchronously after the initial create request is made. If a problem occurs while processing the request, the errorCode property is set on the entity and can be retrieved either by polling the GET endpoint or via a notification.
Payment Error Codes
| Code | Description |
|---|---|
| payment_failed | Payment failed due to an unknown reason |
| payment_fraud_detected | Suspected fraud detected by Issuing bank. Please instruct your user to contact their bank directly to resolve |
| payment_denied | Payment denied by Circle Risk Service, see payment riskReasonCode for more details |
| payment_not_supported_by_issuer | Issuer bank was unable to process the transaction |
| payment_not_funded | There were insufficient funds to cover the payment amount |
| payment_stopped_by_issuer | A stop has been placed by the issuer or customer |
| payment_canceled | Payment was canceled |
| payment_failed_balance_check | Payment failed the Plaid balance check due to insufficient funds |
| payment_unprocessable | The provided encryptedData could not be processed |
| card_failed | The payment failed due to a problem with the card such as an incorrect card number |
| card_invalid | The card number was invalid |
| card_cvv_invalid | Incorrect CVV value provided |
| card_expired | Card expired |
| card_limit_violated | The amount or frequency of payments exceeded card limits |
| card_not_honored | The issuing bank did not approve the payment |
| card_account_ineligible | The card is not linked to an eligible bank account |
| card_restricted | Transaction not permitted to cardholder. Issuer has declined the transaction because the card cannot be used for this type of transaction. Please instruct your user to use a different payment method |
| unauthorized_transaction | The user has advised the bank that the payment was not authorized |
| bank_account_ineligible | The account is not eligible and no other default account was found |
| bank_transaction_error | The bank reported an error processing the transaction |
| invalid_account_number | The account number is invalid or missing |
| invalid_wire_rtn | The wire routing number is invalid |
| ref_id_invalid | Push payment reference Id not recognized |
| account_name_mismatch | Account name does not match Circle resource account name |
| account_number_mismatch | Push payment account number does not match Circle resource account number |
| account_ineligible | Ineligible fiat account due to invalid type or state |
| customer_name_mismatch | Customer full name doesn't match sender name |
| institution_name_mismatch | Institution name doesn't match sender name |
Card Verification Error Codes
| Code | Description |
|---|---|
| verification_failed | Verification failed due to an unknown reason |
| verification_fraud_detected | Card suspected to be used for fraud |
| risk_denied | Card denied by Circle Risk Service, see riskEvaluation for more details |
| verification_not_supported_by_issuer | Issuer bank was unable to process the transaction |
| verification_stopped_by_issuer | A stop has been placed on the card |
| card_failed | Verification failed due to a problem with the card such as the card number does not exist |
| card_invalid | The card number was invalid |
| card_address_mismatch | The billing address provided in the card creation request did not match the one recorded by the issuer bank |
| card_zip_mismatch | The postal code provided in the card creation request did not match the one recorded by the issuer bank |
| card_cvv_invalid | Incorrect CVV value provided |
| card_expired | Card expired |
| card_not_honored | The issuing bank did not authorize the card |
| card_account_ineligible | The card is not linked to an eligible bank account |
| card_limit_violated | The amount or frequency of payments exceeded card limits |
| card_cvv_required | The cvv is either incorrect or missing |
| three_d_secure_not_supported | 3DS transactions are not supported by the issuing bank |
| three_d_secure_required | 3DS is required by the issuing bank |
| three_d_secure_failure | The customer failed the 3DS authentication step |
| three_d_secure_action_expired | The customer took too long to finish the 3DS process. This typically expires after 15 minutes |
| three_d_secure_invalid_request | The 3DS request was submitted with invalid parameters |
Payout Error Codes
| Code | Description |
|---|---|
| insufficient_funds | Exchange insufficient funds |
| transaction_denied | The transaction was denied as the fiat account is not verified |
| transaction_failed | Transaction failed due to an unknown reason |
| transaction_returned | The transaction was returned |
| bank_transaction_error | The bank reported an error processing the transaction |
| fiat_account_limit_exceeded | The Fiat account limit exceeded |
| invalid_bank_account_number | The bank account number is invalid or missing |
| invalid_wire_rtn | The wire routing number is invalid |
| sen_not_supported | account_number_to must be a valid SEN account |
Transfer Error Codes
| Code | Description |
|---|---|
| transfer_failed | The transfer failed due to unknown reasons |
| transfer_denied | The transfer was denied by Circle Risk Service, see transfer riskEvaluation for more details |
| blockchain_error | There was an error processing the transfer on-chain |
| insufficient_funds | There was not enough funding to cover the transfer amount |
Updated 4 days ago