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 | card-type element is required | Retry with the card-type element |
| 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 | 3D security authentication is required. | Retry with 3D Secure authentication. |
| 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_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. |
| 14002 | CARD_LOST_OR_STOLEN | The card is lost or stolen. | Retry with a different card or decline the transaction. |
| 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. |
| 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. | Do not retry. |
| 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. |
| 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 has exceeded. | Retry with different payment method, retry later, or decline the transaction. |
| 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 issues 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. |
| 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 | The transaction failed because there is no strong customer authentication. | Check the card details and try again. |
| 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. |
| 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 is 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. |
| 20031 | MISSING_RELEVANT_METHOD_FOR_SHOPPER | Shopper has no relevant 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. |
| 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. | Create a new tax quote and retry the transaction. |
| - | USER_NOT_AUTHORIZED | User is not authorized to retrieve tax reference. | The tax quote is expired. Create a new tax quote and retry the transaction. |
| - | CREDIT_CARD_DETAILS_PLAIN_AND_ENCRYPTED | Shopper credit card cannot contain both plain and encrypted details. | Retry with correct details. |
| - | CREDIT_CARD_ENCRYPTED_NUMBER_REQUIRED | Encrypted Field 'Encrypted Card Number' is required. | Retry with encrypted card number. |
| - | CREDIT_CARD_ENCRYPTED_SECURITY_CODE_REQUIRED | Encrypted Field 'Encrypted Security Code' is required. | Retry with encrypted security code. |