Test card numbers

You can use the following card numbers to trigger specific scenarios at the gateway, such as declines and partial transactions. Your gateway will need to be set up with a Rapid Connect processor, which should be the default setting. You can verify this setting by calling the GET v3/merchants/{mid}/gateway endpoint and verifying that the paymentGatewayApi value begins with fdcrcip. If the value is blackhole, email [email protected] to request this be changed to Rapid Connect.

Card

Account number

Response code

Response

Discover

6011 3610 0000 6668

0

Success (approve)

Visa

4005 5780 0333 3335

2

Approve for partial amounts

Visa

4005 5717 0222 2222

500

Decline

You may use any three digits for the CVV and any future date for the expiration.

📘

NOTE

The Ecommerce API declines partial auth transactions. In the above list, the Visa test card number for partial amount approvals will be declined.

Simulating successful transactions

In test mode, you can use the following test cards to simulate a successful transaction.

Card

Account number

American Express

3782 822463 10005

American Express

3714 496353 98431

Diners Club

3056 93090 25904

Diners Club

3852 00000 23237

Discover

6011 0009 9013 9424

JCB

3566 0020 2036 0505

Visa

4242 4242 4242 4242

Visa (debit)

4000 0566 5566 5556

📘

NOTE

By default, passing address or CVC data with the card number will cause the address and CVC checks to succeed. If not specified, the value of the checks will be null. Any expiration date in the future will be considered valid.

Simulating declines

Use the following test cards to have the payment gateway return a decline response.

Card

Account number

Amex

3759 876540 00004

Mastercard

5424 1802 7333 3333

Visa

4264 2815 1111 7771

Testing specific error codes

The following table gives suggestions for testing some specific error codes:

Error code

incorrect_number

Use a card number that fails the Luhn check (for example, 4242 4242 4242 4241)

invalid_expiry_month

Use an invalid month number such as 13

invalid_expiry_year

Use a year in the past such as 1970

invalid_cvc

Use a two-digit number such as 99


Did this page help you?