Learn about the different methods to test your integration before going live.
This page includes test card numbers and other information to make sure your integration works as planned. Use it to trigger different flows in your integration and ensure they are handled accordingly.
Basic test card numbers
Genuine card information cannot be used in test mode. Instead, use any of the following test card numbers, a valid expiration date in the future, and any random CVC number, to create a successful payment.
| NUMBER | BRAND | CVC | DATE |
|---|---|---|---|
| 4242 4242 4242 4242 | Visa | Any 3 digits | Any future date |
| 5555 5555 5555 4444 | Mastercard | Any 3 digits | Any future date |
Payments API and Refunds API Error Codes
If an error occurs, endpoints return a list of error objects describing the issues encountered. Each error object includes the following elements:
- Error code identifies the error type.
- Remind details elaborates on what caused the error and includes the error type.
| Error Code | Remind details |
|---|---|
| approve_with_id | The payment cannot be authorized. |
| call_issuer | The card has been declined for an unknown reason. |
| card_not_supported | The card does not support this type of purchase. |
| card_velocity_exceeded | The customer has exceeded the balance or credit limit available on their card. |
| currency_not_supported | The card does not support the specified currency. |
| do_not_honor | The card has been declined for an unknown reason. |
| do_not_try_again | The card has been declined for an unknown reason. |
| duplicate_transaction | A transaction with identical amount and credit card information was submitted very recently. |
| expired_card | The card has expired. |
| generic_decline | The card has been declined for an unknown reason. |
| incorrect_number | The card number is incorrect. |
| incorrect_cvc | The CVC number is incorrect. |
| insufficient_funds | The card has insufficient funds to complete the purchase. |
| invalid_account | The card, or account the card is connected to, is invalid. |
| invalid_amount | The payment amount is invalid, or exceeds the amount that is allowed. |
| invalid_cvc | The CVC number is incorrect. |
| invalid_expiry_year | The expiration year invalid. |
| invalid_number | The card number is incorrect. |
| invalid_pin | The PIN entered is incorrect. This decline code only applies to payments made with a card reader. |
| issuer_not_available | The card issuer could not be reached, so the payment could not be authorized. |
| lost_card | The payment has been declined because the card is reported lost. |
| new_account_information_av-ailable | The card, or account the card is connected to, is invalid |
| no_action_taken | The card has been declined for an unknown reason. |
| not_permitted | The payment is not permitted. |
| pickup_card | The card cannot be used to make this payment (it is possible it has been reported lost or stolen). |
| pin_try_exceeded | The allowable number of PIN tries has been exceeded. |
| processing_error | An error occurred while processing the card. |
| reenter_transaction | The payment could not be processed by the issuer for an unknown reason. |
| restricted_card | The card cannot be used to make this payment (it is possible it has been reported lost or stolen). |
| revocation_of_all_authorizations | The card has been declined for an unknown reason. |
| revocation_of_authorization | The card has been declined for an unknown reason. |
| security_violation | The card has been declined for an unknown reason. |
| service_not_allowed | The card has been declined for an unknown reason. |
| stolen_card | The payment has been declined because the card is reported stolen. |
| stop_payment_order | The card has been declined for an unknown reason. |
| transaction_not_allowed | The card has been declined for an unknown reason. |
| try_again_later | The card has been declined for an unknown reason. |
| withdrawal_count_limit_exceeded | The customer has exceeded the balance or credit limit available on their card. |
| unknown_error | The card has been declined for an unknown reason. |
| payment_failed | Payment failed |
| card_error | Your request has invalid parameters |
| bid_error | Your request has invalid parameters |
| addreess_error | Your request has invalid parameters |
| name_error | Your request has invalid parameters |
| country_id_error | Your request has invalid parameters |
| fraudulent | The payment has potentially fraudulent |
| cvc_required | The cvc number is required by bank |
| suggest_to_routing | Transaction scope cannot be covered. Please try another routing |
| payment_method_not_support | Your account does not support the payment method you requested (charge/auths) |
| invalid_account | The card, or account the card is connected to, is invalid. The customer needs to contact their card issuer to check that the card is working correctly. |