Clover Platform Docs

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.

CardAccount numberResponse codeResponse
Discover6011 3610 0000 66680Success (approve)
Visa4005 5780 0333 33352Approve for partial amounts
Visa4005 5717 0222 2222500Decline

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



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.

CardAccount number
American Express3782 822463 10005
American Express3714 496353 98431
Diners Club3056 93090 25904
Diners Club3852 00000 23237
Discover6011 0009 9013 9424
JCB3566 0020 2036 0505
Visa4242 4242 4242 4242
Visa (debit)4000 0566 5566 5556



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.

CardAccount number
Amex3759 876540 00004
Mastercard5424 1802 7333 3333
Visa4264 2815 1111 7771

Testing specific error codes

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

Error code
incorrect_numberUse a card number that fails the Luhn check (for example, 4242 4242 4242 4241)
invalid_expiry_monthUse an invalid month number such as 13
invalid_expiry_yearUse a year in the past such as 1970
invalid_cvcUse a two-digit number such as 99

Updated 2 months 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.