{"__v":9,"_id":"56673f95ee53940d0051629d","category":{"__v":29,"_id":"5665dfa0e93ae70d00b96a2a","pages":["5665dfca1b6559190020ae7d","5665e000e93ae70d00b96a2c","5665e0a9e93ae70d00b96a32","5665e0c7d8a06b170063f311","5665e12bd7490819006a503f","5665e1431b6559190020ae86","5665e16f63109d0d0036ba19","5665e192b6c0f60d00eae53d","5665e29ed8a06b170063f315","5665e2b9d7490819006a5044","566630b03360850d00336cb6","566631547cc81e0d00253f1a","566631b38744940d004c3eff","5666328b2342100d007dcbf7","566729ab5d00370d00ede6c2","56672a86f672550d0008523a","56672fd9ee53940d00516267","5667335f5d00370d00ede6db","566735cf6819320d000c2f05","5667362b32dd550d00f3924b","5667373d6819320d000c2f0a","566737c232dd550d00f3924e","5667380ad784a70d00397ce1","56673ee86819320d000c2f1b","56673f95ee53940d0051629d","56673feed784a70d00397cec","5667431e66debc1700503f6a","5667436d66debc1700503f6d","566745066819320d000c2f3d"],"project":"56450a342229d7170010928a","version":"56450a342229d7170010928d","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-12-07T19:36:00.783Z","from_sync":false,"order":2,"slug":"configuration","title":"Configuration"},"parentDoc":null,"project":"56450a342229d7170010928a","user":"55648cf93b87582b003ab8b1","version":{"__v":9,"_id":"56450a342229d7170010928d","project":"56450a342229d7170010928a","createdAt":"2015-11-12T21:52:52.685Z","releaseDate":"2015-11-12T21:52:52.684Z","categories":["56450a352229d7170010928e","56450a472c74cf1900da48ca","565def2677f0090d005819bb","5665dfa0e93ae70d00b96a2a","5665e3db1b6559190020ae8c","5665e47763109d0d0036ba5a","5690123f18c3920d00be8b1c","56944016d8c04d1700e5ae20","569447891005590d0062cace"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"createdAt":"2015-12-08T20:37:41.088Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":20,"body":"## Test Credit Card Numbers\n\nWhen 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.\n\n### Success\n\n- ####4111-1111-1111-1111\n  Success.\n- ####4222-2222-2222-2220\n  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.*\n\n### Declined\n\n- ####4000-0000-0000-0002\n  Declined by the gateway.\n- ####4000-0000-0000-0010\n  AVS failed on street address and postal code.\n- ####4000-0000-0000-0028\n  AVS failed on street address.\n- ####4000-0000-0000-0036\n  AVS failed on postal code.\n- ####4000-0000-0000-0044\n  Advanced Verification failed (Secure 3D, etc).\n- ####4000-0000-0000-0051\n  Card number declined.\n- ####4000-0000-0000-0069\n  Expired card or expiration date does not match.\n- ####4000-0000-0000-0077\n  Insufficient funds.\n- ####4000-0000-0000-0085\n  Did not pass your fraud filters.\n- ####4000-0000-0000-0093\n  Originating from fraudulent IP address.\n- ####4000-0000-0000-0101\n  CVV / Security code did not match.\n- ####4000-0000-0000-0119\n  Declined by issuing bank, customer needs to contact their bank.\n- ####4000-0000-0000-0200\n  Invalid data or parameter.\n- ####4222-2222-2222-2222\n  Invalid card number (Fails the Luhn algorithm check).\n- ####4000-0000-0000-0226\n  Invalid expiration date.\n- ####4000-0000-0000-0309\n  Gateway Timeout.\n- ####4000-0000-0000-0317\n  Duplicate transaction.\n- ####4000-0000-0000-0325\n  Card type not accepted.\n- ####4000-0000-0000-0341\n  'Declined by Gateway' error will be thrown, but Recurly will allow you to store card regardless.\n\n<p>*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.</p>\n\n### Other Successful Numbers\n\n- ####1\n  Short test card number.\n- ####378282246310005\n  American Express.\n- ####371449635398431\n  American Express.\n- ####378734493671000\n  American Express Corporate.\n- ####30569309025904\n  Diners Club.\n- ####38520000023237\n  Diners Club.\n- ####6011111111111117\n  Discover.\n- ####6011000990139424\n  Discover.\n- ####3530111333300000\n  JCB.\n- ####3566002020360505\n  JCB.\n- ####5555555555554444\n  MasterCard.\n- ####5105105105105100\n  MasterCard.\n- ####4012888888881881\n  Visa.\n- ####4222222222222\n  Visa.\n\nAll our test credit card numbers pass the Luhn validation algorithm, except the **Invalid credit card number**.\n\n## Test Bank Account Numbers (ACH)\n\nTo 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.\n\n### Routing Number\n\n- ####123456780\n  This is the only routing number that will work in sandbox mode. This routing number will return the \"BANK OF RECURLY\".\n\n### Success Bank Account Number\n\n- ####111111111\n  Settled\n\n### Declined Bank Account Number\n\n- ####111111112\n  Transaction was cancelled by the bank.\n- ####111111113\n  Transaction was cancelled by the bank.\n- ####111111114\n  Will first be successful and then will issue a chargeback.\n- ####111111115\n  If refunded, will be a successful refund.\n- ####111111116\n  If refunded, will be a declined refund.","excerpt":"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.\n\nThe errors triggered below are also returned by the API. Please see the transaction error codes for more information.","slug":"test","type":"basic","title":"Test Gateway"}

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. 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.* ### 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-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. <p>*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.</p> ### Other Successful Numbers - ####1 Short test card number. - ####378282246310005 American Express. - ####371449635398431 American Express. - ####378734493671000 American Express Corporate. - ####30569309025904 Diners Club. - ####38520000023237 Diners Club. - ####6011111111111117 Discover. - ####6011000990139424 Discover. - ####3530111333300000 JCB. - ####3566002020360505 JCB. - ####5555555555554444 MasterCard. - ####5105105105105100 MasterCard. - ####4012888888881881 Visa. - ####4222222222222 Visa. All our test credit card numbers pass the Luhn validation algorithm, except the **Invalid credit card number**. ## 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. ### 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.