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