Circle APIs Documentation

Learn how to integrate with Circle APIs to accept traditional and stablecoin payments, embed digital wallets into your product or service, or power your internet marketplace.

Test Card Numbers

You can use the Circle API sandbox environment to exercise various types of card payment behaviors, such as authorization failure codes and address verification results.

Test Card Numbers

🚧

No Real Charges

The sandbox environment will authorize card payments made with any card number, but it will never actually verify or charge the card.

To simulate different card payments conditions and the corresponding responses, please use one of the provided test card numbers below.

Card numberCard provider
4007400000000007Visa
4007410000000006Visa
4200000000000000Visa
4757140000000001Visa
5102420000000006Mastercard
5173375000000006Mastercard
5555555555554444Mastercard

Response Codes

To trigger specific response codes, use the corresponding amounts below when creating a payment. Any amount not specified in the table will return Approved (response code 00).

AmountResponse codeResponse type
5.01payment_failedPayment failed due to unspecified error
5.04card_not_honoredContact card issuer to query why payment failed
5.05payment_not_supported_by_issuerIssuer did not support the payment
5.07payment_not_fundedInsufficient funds in account to fund payment
5.19card_invalidInvalid card number
5.41card_limit_violatedExceeded amount or frequency limits
5.43payment_deniedPayment denied by Circle Risk Service or card processor risk controls
5.51payment_fraud_detectedPayment suspected of being associated with fraud
5.54credit_card_not_allowedIssuer did not support using a credit card for payment
5.57payment_stopped_by_issuerA stop has been placed on the payment or card
5.84card_account_ineligibleIneligible account associated with card

CVV Verification

For more information on the card verification value (CVV) check see the verifying card details guide.

Setting the CVV to 000 or 999 will cause a CVV failure response.

AVS Verification

For more information on the address verification service (AVS) check see the verifying card details guide.

To trigger a particular AVS check result, set the address line 1 field to Test_X, where X is the code to be returned. The result defaults to AVS code Y otherwise.

Address Line 1 valueAVS CodeSummaryVISAMasterCard
Test_AAPartial MatchAddress matches, ZIP does not.Address matches, ZIP does not.
Test_BBPartial Match (International Transaction)Street address match. Postal code not verified because of incompatible formats. (Acquirer sent both street address and postal code)Not applicable.
Test_CCNo Match (International Transaction)Street address and postal code not verified because of incompatible formats. (Acquirer sent both street address and postal code.)Street address and postal code not verified due to incompatible formats. (Acquirer sent both street address and postal code.)
Test_DDFull Match (International Transaction)Street addresses and postal code match.Street addresses and postal codes match.
Test_FFFull Match (UK only)Street address and postal code match. Applies to U.K. only.Street address and postal code match. Applies to U.K. only.
Test_GGNot Supported (International Transaction)Address information not verified for international transaction.Address information not verified for international transaction.
Test_IINo Match (International Transaction)Address information not verified.Address information not verified.
Test_MMFull Match (International Transaction)Street addresses and postal code match.Street address and postal code match.
Test_NNNo MatchNeither address nor postal code matches.Neither address nor postal code matches.
Test_PPPartial Match (International Transaction)Postal codes match. Street address not verified because of incompatible formats. (Acquirer sent both street address and postal code.)Postal code match. Street address not verified because of incompatible formats. (Acquirer sent both street address and postal code.)
Test_RRSystem UnavailableRetry, system unable to process.Retry, system unable to process.
Test_SSNot SupportedAVS currently not supported.AVS currently not supported.
Test_UUSystem UnavailableNo data from issuer/Authorization System. Information not available.No data from issuer/Authorization System. Information not available.
Test_WWPartial Match (US only)Not applicable. If present, replaced with ”Z” by V.I.R Available for U.S. issuers only.For U.S. addresses, nine-digit postal code matches, address does not; for address outside the U.S., postal code matches, address does not.
Test_XXFull MatchNot applicable.For U.S. addresses, nine-digit postal code and address matches; for addresses outside the U.S., postal code and address match.
Test_YYFull MatchFor U.S. addresses, five-digit or nine-digit postal code and address matches.For U.S. addresses, five-digit postal code and address matches.
Test_ZZPartial MatchFor U.S. addresses, five-digit or nine-digit postal code matches, address does not.For U.S. addresses, five-digit postal code matches, address does not.

Updated 12 days ago


Test Card Numbers


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.