Test card numbers

Merchants can use the following card numbers to trigger specific scenarios at the gateway, such as declines and partial transactions. A gateway will need to be setup with a Rapid Connect processor, which must be the default setting. Verify this setting by calling the GET v3/merchants/{mid}/gateway endpoint and confirm 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.

Ecomm test cards for AVS success scenarios

To test Address Verification Service (AVS) success scenarios, use one of the following test card numbers with any U.S. zip code:

Card Brand

PAN

Visa

4761530001111126

Master Card

5204245250003294

Amex

375186917371340

Discover

6011000050617475

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

Ad hoc testing

In addition to the Unit and Certification test scripts in your SDK, Clover has established functionality that allows you to create your own test cases. The following test card examples are provided for this purpose and should only be used with the "Test Merchants" generated as part of their developer account on Clover's Sandbox.

Card

Account number

PIN Debit

4017779991113335

Visa

4761530001111118

EBT

5076800002222223

MasterCard

5137221111116668

Discover

6011208701117775

Amex

371030089111338

Diners Club

36185900011112

JCB

3566002345432153

For all cards

Transactions in the amount of $45.67 will receive a "No Host Response" to simulate time-out reversal testing. Therefore:

  • Transactions below $100.00 will receive an Approved response.
  • Transactions above $100.00 will receive a specific Error response.

The transaction amount sent in the transaction request message is used to determine which error response code will be received in your response. To request an error response code, the last three digits of the transaction amount should be the response code you want to receive. For example, if you need to receive a response message with a 116 response code, then the request message could contain a transaction amount of $101.16. Likewise, if you need to receive a response message with a 318 response code, then the request message could contain a transaction amount of $403.18.


Did this page help you?