The following errors can be returned in response to a Card Transaction request. For details on how to address the error, refer to the Action column.
| Code | Name | Description | Action |
|---|---|---|---|
| 7 | INVALID_TRANSACTION_TYPE | Transaction type is invalid. Note: HTTP status is 403 Forbidden | Retry after validating request. If issue persists, contact BlueSnap Support. |
| 30 | MISSING_SHOPPER_OR_CARD_HOLDER | No card holder or vaulted shopper ID | Retry with card holder info or vaulted shopper ID. |
| 85 | INVALID_HTTP_METHOD | CAPTURE transactions should be sent using an HTTP PUT method | Retry with HTTP PUT method. |
| 90 | MISSING_CARD_TYPE | cardType element is required | Retry with the cardType element |
| 10000 | BLS_NO_SUCH_SHOPPER_PAYMENT_METHOD | Shopper has no relevant saved payment method. For example, CC. | Update the vaulted shopper with a relevant payment method or include the payment method in the Auth Only or Auth Capture request. |
| 10000 | INVALID_API_VERSION | The API version passed in the request is invalid. | Retry with correct API version. |
| 10000 | PAYMENT_GENERAL_FAILURE | A general payment failure has occurred. | Retry. If issue persists, contact BlueSnap Support. |
| 10001 | VALIDATION_GENERAL_FAILURE | The resource passed in the request has violated validation rules. Additional information about the specific issue is provided in the error description. | Retry with correct resource. |
| 10001 | INVALID_MERCHANT_TRANSACTION_ID | Merchant-transaction-id should be up to 50 characters | Retry with correct merchant transaction ID. |
| 10001 | INVALID_RECURRING_TRANSACTION | recurring-transaction element is missing or invalid | Retry with recurring transaction element. |
| 10001 | MERCHANT_CONFIGURATION_ERROR | Merchant Configuration Error | Contact BlueSnap Support. |
| 10001 | MISSING_CARD_TYPE | card-type element is required | Retry with card type element. |
| 11001 | XSS_EXCEPTION | User input suspected as malicious. | Do not retry. |
| 14002 | THREE_D_SECURITY_AUTHENTICATION_REQUIRED | Soft Decline due to no 3D Secure Authentication. | Retry with 3D Secure Authentication. Note: You may also implement Strong Customer Authentication (shopper challenge) here |
| 14002 | ACCOUNT_CLOSED | Payment processing failure because account is closed. | Do not retry. |
| 14002 | AUTHORIZATION_AMOUNT_ALREADY_REVERSED | Payment processing failure because the authorization has already been reversed. | Do not retry. |
| 14002 | AUTHORIZATION_AMOUNT_NOT_VALID | Payment processing failure due to invalid amount for this transaction. | Retry with correct amount. If issue persists, decline the transaction. |
| 14002 | AUTHORIZATION_EXPIRED | Payment processing failure because the authorization has expired. | Do not retry. |
| 14002 | AUTHORIZATION_REVOKED | Authorization has been revoked for recurring transaction. | Do not retry. |
| 14002 | AUTHORIZATION_NOT_FOUND | Payment processing failure because the authorization was not found. | Do not retry. |
| 14002 | BLS_CONNECTION_PROBLEM | Your payment request could not be successfully completed. | Do not retry. |
| 14002 | CALL_ISSUER | Payment processing failure due to an unspecified error. Please contact the issuing bank. | Do not retry this card. |
| 14002 | CARD_LOST_OR_STOLEN | The card is lost or stolen. | Retry with a different card or decline the transaction. Do not retry this card. |
| 14002 | CVV_ERROR | Payment processing failure due to CVV error. | Retry with correct CVV code. |
| 14002 | DO_NOT_HONOR | Payment processing failure due to issuing bank decline. | Retry with different payment method or retry again in 24 hours. |
| 14002 | EXPIRED_CARD | Payment processing failure due to expired card. | Retry with correct expiration date. If issue persists, retry with different payment method or decline the transaction. Do not retry this card. |
| 14002 | GENERAL_PAYMENT_PROCESSING_ERROR | Payment processing failure due to an unspecified error. Description will contain the error code and message sent by the processor, if applicable. | Retry. If issue persists, contact BlueSnap Support. |
| 14002 | HIGH_RISK_ERROR | Payment processing failure due to high risk. | Retry with a different payment method or retry in 24 hours. |
| 14002 | INCORRECT_INFORMATION | Payment processing failure due to incorrect information. Description will contain additional information about the specific error. | Do not retry. |
| 14002 | INCORRECT_SETUP | Payment processing failure due to incorrect setup. | Contact BlueSnap Support. |
| 14002 | INSUFFICIENT_FUNDS | Payment processing failure due to insufficient funds. | Retry with different payment method, retry later, or decline the transaction. |
| 14002 | INVALID_AMOUNT | Payment processing failure due to invalid amount for this transaction. | Retry with correct amount. If issue persists, decline the transaction. |
| 14002 | INVALID_CARD_NUMBER | Payment processing failure due to invalid card number. | Retry with correct card number. If issue persists, retry with different payment method or decline the transaction. Do not retry this card. |
| 14002 | INVALID_CARD_TYPE | Payment processing failure due to invalid card type. | Retry with correct card number or different payment method, or decline the transaction. |
| 14002 | INVALID_PIN_OR_PW_OR_ID_ERROR | Payment processing failure due to invalid PIN, password, or ID error. | Retry with correct PIN, password, or ID. If issue persists, contact BlueSnap Support. |
| 14002 | INVALID_TRANSACTION | Payment processing failure because this transaction is not allowed by the issuer. | Do not retry. |
| 14002 | LIMIT_EXCEEDED | Payment processing failure because card limit was exceeded. | Retry with different payment method, retry later, or decline the transaction. |
| 14002 | NEW_ACCOUNT_INFORMATION_AVAILABLE | Payment processing failure because account is no longer active. | Retry with a different card. |
| 14002 | PICKUP_CARD | Payment processing failure. The card has been reported lost or stolen and should be removed from use. | Do not retry. |
| 14002 | PROCESSING_AMOUNT_ERROR | Payment processing failure due to invalid amount for this transaction. | Retry with correct amount. If issue persists, decline the transaction. |
| 14002 | PROCESSING_DUPLICATE | Payment processing failure due to duplication. The transaction is a duplicate of a previously submitted transaction. | Do not retry. |
| 14002 | PROCESSING_GENERAL_DECLINE | Payment processing failure due to an unspecified error returned. | Retry. If issue persists, contact the issuing bank or decline the transaction. |
| 14002 | PROCESSING_TIMEOUT | Payment processing failure due to timeout. | Retry. If issue persists, contact BlueSnap Support. |
| 14002 | PROCESSING_TRANSACTION_NOT_AUTHORIZED | Payment processing failure because the transaction is unauthorized. | Do not retry. |
| 14002 | REFUND_FAILED | A general payment failure has occurred for this refund. | Retry. If issue persists, contact BlueSnap Support. |
| 14002 | RESTRICTED_CARD | Payment processing failure due to restricted card. | Do not retry. |
| 14002 | STRONG_CUSTOMER_AUTHENTICATION_REQUIRED | Soft Decline due to no Strong Customer Authentication (shopper challenge) | Retry with 3D Secure and Strong Customer Authentication (shopper challenge) |
| 14002 | SYSTEM_TECHNICAL_ERROR | Payment processing failure due to problematic transaction. | Do not retry. |
| 14002 | THE_ISSUER_IS_UNAVAILABLE_OR_OFFLINE | Payment processing failure because the issuer is unavailable or offline. | Retry. |
| 14002 | THREE_D_SECURE_FAILURE | Payment processing failure due to 3D secure failure. | Do not retry. |
| 14011 | PAYMENT_METHOD_NOT_SUPPORTED | Payment processing failure because the attempted operation is not supported for this payment method. | Do not retry. |
| 14016 | NO_AVAILABLE_PROCESSORS | There are no available processors for the specific request. | Contact BlueSnap Support. |
| 15008 | SHOPPER_NOT_FOUND | The Shopper ID passed in the request was not found. | Retry with correct vaulted shopper ID. |
| 15012 | SHOPPER_COUNTRY_OFAC_SANCTIONED | One of the shopper's countries was defined as OFAC sanctioned. | Do not retry. |
| 16003 | MULTIPLE_PAYMENT_METHODS_NON_SELECTED | Shopper has multiple payment methods, but none is selected. | Retry with specified payment method. |
| 16006 | PAYMENT_METHOD_LIMIT_REACHED | Shopper has reached limit on adding new payment methods. | |
| 20002 | MULTIPLE_TRANSACTIONS_FOUND | Transaction retrieval service failure. Multiple transactions found with merchant transaction ID: ${merchantTransactionId}. | Retry with correct merchant transaction ID. If issue persists, contact BlueSnap Support. |
| 20003 | TRANSACTION_LOCKED | Transaction ${transactionType} failed. Transaction locked. | Contact BlueSnap Support. |
| 20004 | TRANSACTION_PAYMENT_METHOD_NOT_SUPPORTED | Payment method is not supported. | Retry with different payment method or decline the transaction. |
| 20005 | TRANSACTION_NOT_AUTHORIZED | Transaction is not authorized. | Retry Auth request with correct details. |
| 20006 | TRANSACTION_ALREADY_EXISTS | Transaction AUTH_REVERSAL FAILED. Transaction already exists. | Do not retry. |
| 20007 | TRANSACTION_EXPIRED | Transaction has expired. | Do not retry. Create new transaction request. |
| 20008 | TRANSACTION_ID_REQUIRED | Transaction ID is required. | Retry with transaction ID. |
| 20009 | INVALID_TRANSACTION_ID | Transaction ID is invalid. | Retry with correct transaction ID. |
| 20010 | TRANSACTION_ALREADY_CAPTURED | Transaction was already captured. | Do not retry. |
| 20017 | TRANSACTION_CARD_NOT_VALID | Transaction CAPTURE failed. Card is no longer valid. | Retry with different card information. |
| 20031 | MISSING_RELEVANT_METHOD_FOR_SHOPPER | Shopper has no relevant saved payment method. For example, CC. | Update the vaulted shopper with a relevant payment method. or Include the payment method in the Auth Only or Auth Capture request. |
| 20036 | CREDIT_CARD_DETAILS_PLAIN_AND_ENCRYPTED | Shopper credit card cannot contain both plain and encrypted details. | Retry with correct details. |
| 20036 | CREDIT_CARD_ENCRYPTED_NUMBER_REQUIRED | Encrypted Field 'Encrypted Card Number' is required. | Retry with encrypted card number. |
| 20036 | CREDIT_CARD_ENCRYPTED_SECURITY_CODE_REQUIRED | Encrypted Field 'Encrypted Security Code' is required. | Retry with encrypted security code. |
| 24012 | USER_NOT_AUTHORIZED | User is not authorized to perform the requested action | |
| 43008 | EXTERNAL_TAX_SERVICE_MISMATCH_CURRENCY | The given currency must match the original tax quote currency. | Retry the transaction with the same currency as the tax quote. or Create a new tax quote with the desired currency and retry the transaction. |
| 43009 | EXTERNAL_TAX_SERVICE_UNEXPECTED_TOTAL_PAYMENT | The given total payment must match the original total calculated in the given tax quote reference. | Retry with the correct amount. |
| 43010 | EXTERNAL_TAX_SERVICE_TAX_REFERENCE_ALREADY_USED | The given tax reference was already in use. For example: the tax quote was not created by merchant trying to use it, the tax quote is expired, or the tax quote is non-existent. | Create a new tax quote and retry the transaction. |