developer:sandbox

The Sandbox

The sandbox provides a full simulation of the production gateway and is the ideal way to test your integration.

Requesting a Sandbox Account

  1. To obtain a test account on our sandbox test server please go to the following URL: https://www.usaepay.com/developer/login
  2. This will bring you to a log in page.
  3. Please click on “sign up” and fill out the form COMPLETELY to obtain your login credentials.
  4. Leaving any fields blank will delay your account from being setup, regardless of the “required” note.
  5. Once you hit register you will be inside the developer section.
  6. Please click on “Request Test Account” or the direct URL is: https://www.usaepay.com/developer/request_test_acct.php
  7. Fill out the form completely and click “Request Account”
  8. You will be returned to the home section of the developer area and a message will be displayed: Request for test account sent. Once the test account request has been processed you will receive an email with a URL and login information for testing transactions. Processing time takes a few hours during regular office hours based on Pacific Standard Time. Requests on weekends may be processed with a 24 hour or more turnaround time.

Why you need a test (developer a.k.a. sandbox) account

  • If you are a developer and your client, the merchant, has not setup a live gateway account a sandbox account will allow you to develop your application without delay. The sandbox environment mimics the Merchant Console (live account) exactly so you can expect the same results when switching to the live account once it's setup. Your application will only need to swap the source key from the developer one to the live one.
  • Test Mode on our live servers is extremely limited and unfriendly in terms of developing an application. It does not generate a fake approval code other than TESTMD and it does not store a transaction record for you to look up. Further most of the result fields come back blank. This was done on purpose to keep our live server clean of test transactions and reserved for actual live transactions only. A sandbox account will generate approval codes for you, return all the variables you request as well as store a transaction record for you to report on. We keep test mode functional on the live servers because it is a legacy feature that older customers are used to.

Switching over from Development to Production

When testing and development is completed switch the source key to the key generated from the live account and change the processing URL from sandbox.usaepay.com/gate to www.usaepay.com/gate

Test Credit Card Numbers

The following list of test credit card numbers maybe used on the Test Account. The use of live credit card information in a test environment is strongly discouraged. It is recommended that the card numbers on this page be used instead.

If you need physical test cards to test a swiper or other pos device please order them here.

For more information on the response codes and their meanings see:

Please note that while the sandbox test platform does its best to simulate what you will see in production, there may be subtle differences depending on the platform being used. At this time we are only simulating the FDMS Nashville responses on the sandbox server. Also 0919 is a example expiration date to show the format, any future date in MMYY format will return the response associated with the card number.

Card Number Expiration CVV2 Code AVS Response CVV2 Response CAVV Response Card Level
4000100011112224 0919 any YYY M A
4000100111112223 0919 any YYX M A
4000100211112222 0919 any NYZ M A
4000100311112221 0919 any NYW M A
4000100411112220 0919 any YNA M A
4000100511112229 0919 any NNN M A
4000100611112228 0919 any XXW M A
4000100711112227 0919 any XXU M A
4000100811112226 0919 any XXR M A
4000100911112225 0919 any XXS M A
4000101011112222 0919 any XXE M A
4000101111112221 0919 any XXG M A
4000101211112220 0919 any YYG M A
4000101311112229 0919 any GGG M A
4000101411112228 0919 any YGG M A
4000101511112227 0919 any NN M A
4000101611112226 0919 any N/A M A

CVV2 Responses

Card Number Expiration CVV2 Code AVS Response CVV2 Response CAVV Response Card Level
4000200011112222 0919 any YYY M A
4000200111112221 0919 any YYY N A
4000200211112220 0919 any YYY P A
4000200311112229 0919 any YYY S A
4000200411112228 0919 any YYY U A
4000200511112227 0919 any YYY X A
5555444433332226 0919 any YYY M
5555444433332234 0919 any YYY N
5555444433332242 0919 any YYY P
5555444433332259 0919 any YYY S
5555444433332267 0919 any YYY U
5555444433332275 0919 any YYY X
371122223332225 0919 any YYY M
371122223332233 0919 any YYY n/a
371122223332241 0919 any CVV2 No Match (Decline)
6011222233332224 0919 any YYY M
6011222233332232 0919 any YYY N
6011222233332240 0919 any YYY P
6011222233332257 0919 any YYY S
6011222233332265 0919 any YYY U
6011222233332273 0919 any YYY X

CAVV Responses

Card Number Expiration CVV2 Code AVS Response CVV2 Response CAVV Response Card Level
4000600011112223 0919 any YYY M 1 A
4000600111112222 0919 any YYY M 2 A
4000600211112221 0919 any YYY M 3 A
4000600311112220 0919 any YYY M 4 A
4000600411112229 0919 any YYY M 6 A
4000600511112228 0919 any YYY M 7 A
4000600611112227 0919 any YYY M 8 A
4000600711112226 0919 any YYY M 9 A
4000600811112225 0919 any YYY M A A
4000600911112224 0919 any YYY M B A
4000601011112221 0919 any YYY M C A
4000601111112220 0919 any YYY M D A

Card Level Responses

Card Number Expiration CVV2 Code AVS Response CVV2 Response CAVV Response Card Level
4000700011112221 0919 any YYY M A
4000700111112220 0919 any YYY M B
4000700211112229 0919 any YYY M C
4000700311112228 0919 any YYY M D
4000700411112227 0919 any YYY M G
4000700511112226 0919 any YYY M H
4000700611112225 0919 any YYY M I
4000700711112224 0919 any YYY M K
4000700811112223 0919 any YYY M S
4000700911112222 0919 any YYY M U
4000701011112229 0919 any YYY M G1
4000701111112228 0919 any YYY M G2
4000701211112227 0919 any YYY M J1
4000701311112226 0919 any YYY M J2
4000701411112225 0919 any YYY M J3
4000701511112224 0919 any YYY M J4
4000701611112223 0919 any YYY M K1
4000701711112222 0919 any YYY M S1
4000701811112221 0919 any YYY M S2
4000701911112220 0919 any YYY M S3

Decline Responses

Card Number Expiration CVV2 Code Decline Code Message
4000300011112220 0919 any - Declined
4000300001112222 0919 any 04 Pickup Card
4000300211112228 0919 any 05 Do not Honor
4000300311112227 0919 any 12 Invalid Transaction
4000300411112226 0919 any 15 Invalid Issuer
4000300511112225 0919 any 25 Unable to locate Record
4000300611112224 0919 any 51 Insufficient funds
4000300711112223 0919 any 55 Invalid Pin
4000300811112222 0919 any 57 Transaction Not Permitted
4000300911112221 0919 any 62 Restricted Card
4000301011112228 0919 any 65 Excess withdrawal count
4000301111112227 0919 any 75 Allowable number of pin tries exceeded
4000301211112226 0919 any 78 No checking account
4000301311112225 0919 any 97 Declined for CVV failure

Referral Response

Card Number Expiration CVV2 Code AVS Response CVV2 Response CAVV Response Card Level
4000300111112229 0919 any - -

Partial Authorization Cards

Card Number Expiration Authorized Amount
4000000011112275 0919 50%
4000000011112283 0919 75%

Slow Processing Cards

Card Number Expiration Processing Time
4000000011112226 0919 5s
4000000011112234 0919 15s
4000000011112242 0919 30s
4000000011112259 0919 45s
4000000011112267 0919 60s

Test Check ACH Data

The following list of test check information is made available for testing check processing functionality on our Sandbox system. The account data should not be used in production.

Routing Account Amount Response Reason
987654321 Any Any Error Invalid routing Number
Any Any 5.99 Decline Returned check for this account
Any Any 9999.99 ManagerApproval Warning: You have exceeded your allocated monthly transaction volume
* Any other combination of 9 digit routing number and account number will return an approval.
developer/sandbox.txt · Last modified: 2014/05/12 09:59 by tem

Page Tools