# 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.
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