Recurly Test Gateway
When you first create your Recurly account, it will be configured to use the Test Gateway. This allows you to start testing Recurly without setting up any payment gateway details. Some Hosted Pages Settings will utilize the Test Gateway configurations to always allow for testing credit cards and ACH. If you have configurations to hide or show specific fields, test those after your gateway has been configured.
The errors triggered below are also returned by the API. Please see the transaction error codes for more information.
Test Credit Card Numbers
When you're using the Test Gateway, you may test the service with the following credit card numbers below. A 4 digit CVV must be used for American Express card numbers, all other card numbers may use a 3 digit CVV.
Success
4111-1111-1111-1111
Success.
4222-2222-2222-2220
Success, but flagged for Fraud Review by the gateway. Note: the fraud review is only relevant to PayPal gateways when in production mode. This does not impact test transactions.
4000000000002024
Successful purchase with a declined refund
Declined
4000-0000-0000-0002
Declined by the gateway.
4000-0000-0000-0010
AVS failed on street address and postal code.
4000-0000-0000-0028
AVS failed on street address.
4000-0000-0000-0036
AVS failed on postal code.
4000-0000-0000-0044
Advanced Verification failed (Secure 3D, etc).
4000-0000-0000-0051
Card number declined.
4000-0000-0000-0069
Expired card or expiration date does not match.
4000-0000-0000-0077
Insufficient funds.
4000-0000-0000-0085
Did not pass your fraud filters.
4000-0000-0000-0093
Originating from fraudulent IP address.
4000-0000-0000-1190
Declined due to a fraud risk score.
4000-0000-0000-0101
CVV / Security code did not match.
4000-0000-0000-0119
Declined by issuing bank, customer needs to contact their bank.
4000-0000-0000-0200
Invalid data or parameter.
4222-2222-2222-2222
Invalid card number (Fails the Luhn algorithm check).
4000-0000-0000-0226
Invalid expiration date.
4000-0000-0000-0309
Gateway Timeout.
4000-0000-0000-0317
Duplicate transaction.
4000-0000-0000-0325
Card type not accepted.
4000-0000-0000-0341
'Declined by Gateway' error will be thrown, but Recurly will allow you to store card regardless.
*Please note:* With a real gateway, it is difficult to trigger the **Expiration date does not match** error. Most issuing banks do not validate the expiration date when processing a transaction. Instead, they use CVV and address information for more reliable fraud protection.
Other Successful Numbers
378282246310005
American Express.
371449635398431
American Express.
378734493671000
American Express Corporate.
30569309025904
Diners Club.
38520000023237
Diners Club.
6011000990139424
Discover.
3530111333300000
JCB.
3566002020360505
JCB.
5555555555554444
MasterCard.
5105105105105100
MasterCard.
2223000048400011
MasterCard.
4012888888881881
Visa.
4222222222222
Visa.
All our test credit card numbers pass the Luhn validation algorithm, except the Invalid credit card number.
3DS2 Test Cards
The test cards listed below should only be used to test the 3DS2 challenge flows. 3DS2 integration steps, and more information on how to use these cards, can be found in our guide here.
4000000000003220
This card will trigger the 3DS2 challenge flow.
4000000000003063
This card will trigger the device fingerprint flow.
4222222222222220
This card will trigger an approved transaction requiring fraud review (frictionless flow).
4000008400001629
This card can be used to test the 3DS2 dunning flow.
Test Bank Account Numbers (ACH)
To test ACH, you can add bank account details through the API, the Hosted Account Management pages or using the "Make a Payment" button on the hosted invoice page. You will not be able to add bank account details through the Admin due to NACHA regulations on merchant access to customer account information.
Testing ACH does not test your Check Commerce connection, but uses an internal Recurly test gateway to simulate the transaction responses and invoice states you will get with ACH payments and refunds.
Routing Number
123456780
This is the only routing number that will work in sandbox mode. This routing number will return the "BANK OF RECURLY".
Success Bank Account Number
111111111
Settled
Declined Bank Account Number
111111112
Transaction was cancelled by the bank.
111111113
Transaction was cancelled by the bank.
111111114
Will first be successful and then will issue a chargeback.
111111115
If refunded, will be a successful refund.
111111116
If refunded, will be a declined refund.
Updated almost 2 years ago