# Error
Errors have the following structure.
# Error
Property | Type | Description | Optional |
---|---|---|---|
status | number | Status code of the Error. | |
type | string | Type of the Error. | |
error | Error code | Switchable string defining the type of the error. | Yes |
description | string | Yes | |
content | any | Yes |
# Error codes
- 3ds problem
- 3-D Secure problem.
- 3ds authentication failure
- 3-D Secure failure.
- acquirer error
- An unknown Card Network (Acquirer) error occured, possibly due to connection issues.
- amount limit
- The amount limit is exceeded.
- authentication required
- Additional authentication required. The Card Network (Acquirer) configuration might be incorrect.
- authorization not found
- The authorization could not be found in the database.
- backend problem
- A Card Network (Acquirer) problem occured.
- blocked merchant
- The cardholder has blocked this merchant from using the card.
- card declined
- Your card was declined by issuer or card scheme.
- card lost or stolen
- Your card has been reported lost or stolen.
- card restricted
- Your card is restricted.
- card expired
- Your card has expired.
- insufficient funds
- There is insufficient funds on the card.
- invalid card number
- The card number is invalid. Please enter a valid number.
- invalid csc
- Invalid CVC code.
- invalid currency
- Invalid currency.
- invalid descriptor
- The transaction contains incorrect statement text and could not be completed.
- invalid expire date
- Invalid Expire date.
- invalid input
- The card details are incorrect. Please enter valid card details and try again.
- invalid transaction
- The transaction contains incorrect information.
- merchant not found
- Merchant could not be found.
- rule violation
- The Card Network (Acquirer) rules are not met.
- suspected fraud
- Your card was declined due to suspected fraud.
- unauthorized
- No further information due to security.
- unknown error
- An unknown error occured. Ensure that your card details are correct and try again.
- unsupported card
- Your card is not supported. Please try another card.
- Your card doesn't support required 3D secure verification. Please try another card.
- verification required
- If you receive a verification required error, 3D secure needs to be performed.
# Error responses
To test potential error responses, use pan 4200000000000000
for visa, or
5555550000004444
for mastercard together with an amount from the list below.
Amount | Error code | Description | Response status |
---|---|---|---|
13.11 | invalid card number | Invalid card number. | 400 |
400.00 | invalid input | General input error. | 400 |
401.11 | unsupported card | Unsupported card scheme. | 400 |
401.40 | invalid currency | Invalid currency. | 400 |
401.50 | invalid descriptor | Invalid text on statement. | 400 |
401.90 | invalid transaction | Invalid transaction. | 400 |
402.00 | rule violation | Acquirer rule violation. | 400 |
403.00 | 3ds problem | 3-D Secure problem. | 400 |
403.10 | 3ds authentication failure | 3-D Secure authentication failure. | 400 |
404.10 | card declined | Declined by issuer or card scheme. | 400 |
404.13 | insufficient funds | Insufficient funds. | 400 |
404.14 | suspected fraud | Suspected fraud. | 400 |
404.15 | amount limit | Amount limit exceeded. | 400 |
404.20 | blocked merchant | Merchant blocked by cardholder. | 400 |
← Reference Test cards →