Testing

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.

NUMBERBRANDCVCDATE
4242 4242 4242 4242VisaAny 3 digitsAny future date
5555 5555 5555 4444MastercardAny 3 digitsAny 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 CodeRemind details
approve_with_idThe payment cannot be authorized.
call_issuerThe card has been declined for an unknown reason.
card_not_supportedThe card does not support this type of purchase.
card_velocity_exceededThe customer has exceeded the balance or credit limit available on their card.
currency_not_supportedThe card does not support the specified currency.
do_not_honorThe card has been declined for an unknown reason.
do_not_try_againThe card has been declined for an unknown reason.
duplicate_transactionA transaction with identical amount and credit card information was submitted very recently.
expired_cardThe card has expired.
generic_declineThe card has been declined for an unknown reason.
incorrect_numberThe card number is incorrect.
incorrect_cvcThe CVC number is incorrect.
insufficient_fundsThe card has insufficient funds to complete the purchase.
invalid_accountThe card, or account the card is connected to, is invalid.
invalid_amountThe payment amount is invalid, or exceeds the amount that is allowed.
invalid_cvcThe CVC number is incorrect.
invalid_expiry_yearThe expiration year invalid.
invalid_numberThe card number is incorrect.
invalid_pinThe PIN entered is incorrect. This decline code only applies to payments made with a card reader.
issuer_not_availableThe card issuer could not be reached, so the payment could not be authorized.
lost_cardThe payment has been declined because the card is reported lost.
new_account_information_av-ailableThe card, or account the card is connected to, is invalid
no_action_takenThe card has been declined for an unknown reason.
not_permittedThe payment is not permitted.
pickup_cardThe card cannot be used to make this payment (it is possible it has been reported lost or stolen).
pin_try_exceededThe allowable number of PIN tries has been exceeded.
processing_errorAn error occurred while processing the card.
reenter_transactionThe payment could not be processed by the issuer for an unknown reason.
restricted_cardThe card cannot be used to make this payment (it is possible it has been reported lost or stolen).
revocation_of_all_authorizationsThe card has been declined for an unknown reason.
revocation_of_authorizationThe card has been declined for an unknown reason.
security_violationThe card has been declined for an unknown reason.
service_not_allowedThe card has been declined for an unknown reason.
stolen_cardThe payment has been declined because the card is reported stolen.
stop_payment_orderThe card has been declined for an unknown reason.
transaction_not_allowedThe card has been declined for an unknown reason.
try_again_laterThe card has been declined for an unknown reason.
withdrawal_count_limit_exceededThe customer has exceeded the balance or credit limit available on their card.
unknown_errorThe card has been declined for an unknown reason.
payment_failedPayment failed
card_errorYour request has invalid parameters
bid_errorYour request has invalid parameters
addreess_errorYour request has invalid parameters
name_errorYour request has invalid parameters
country_id_errorYour request has invalid parameters
fraudulentThe payment has potentially fraudulent
cvc_requiredThe cvc number is required by bank
suggest_to_routingTransaction scope cannot be covered. Please try another routing
payment_method_not_supportYour account does not support the payment method you requested (charge/auths)