developer:reference

Quick Reference Guides

Test Credit Card Numbers

The following list of test credit card numbers maybe used either on the Test Account or in Test Mode. The use of live credit card information in a test environment is strongly discourage. 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.

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

CVV2 Responses

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

CAVV Responses

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

Card Level Responses

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

Decline Responses

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

Fraud Profiler Response

Card Number Expiration Profiler Response
4000301411112224 0914 review
4000301511112223 0914 reject

Referral Response

Card Number Expiration CVV2 Code AVS Response CVV2 Response CAVV Response Card Level
4000300111112229 0914 999 - -

Slow Processing Cards

Card Number Expiration Processing Time
4000000011112226 0914 5s
4000000011112234 0914 15s
4000000011112242 0914 30s
4000000011112259 0914 45s
4000000011112267 0914 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.

AVS Result Codes

The following is a list of result codes for the Address Verification System (AVS) and what each one indicates. These codes are returned in the UMavsResultCode variable, and serve to provide developers with greater control over the AVS system. Many developers may choose to capture and display the UMavsResult variable instead. The UMavsResult variable contains the meaning of the code, rather than the code itself. Most merchants will receive the codes listed in the code column but depending on the platform they are using, they may receive codes listed in the Alternates column.

AVS Code Alternate Description
YYY Y, YYA, YYD Address: Match & 5 Digit Zip: Match
NYZ Z Address: No Match & 5 Digit Zip: Match
YNA A, YNY Address: Match & 5 Digit Zip: No Match
NNN N, NN Address: No Match & 5 Digit Zip: No Match
YYX X Address: Match & 9 Digit Zip: Match
NYW W Address: No Match & 9 Digit Zip: Match
XXW Card Number Not On File
XXU Address Information not verified for domestic transaction
XXR R, U, E Retry / System Unavailable
XXS S Service Not Supported
XXE Address Verification Not Allowed For Card Type
XXG G, C, I Global Non-AVS participant
YYG B, M International Address: Match & Zip: Not Compatible
GGG D International Address: Match & Zip: Match
YGG P International Address: No Compatible & Zip: Match

Card ID Result Codes

The following is a list of result codes for the CVV2/CVC2/CID verification system and what each one indicates. These codes are returned in the UMcvv2ResultCode variable and provide developers with greater control over the CVV2 system. Many developers choose to capture and display the UMcvv2Result variable instead. The UMcvv2Result variable contains the meaning of the code rather than the code itself.

Code Meaning
M Match
N No Match
P Not Processed
S Should be on card but not so indicated
U Issuer Not Certified
X No response from association
(blank) No CVV2/CVC data available for transaction.

Errors by Code

Numeric Code Description Additional Information
00001 Password/Username Incorrect. Sent by login screen when the username and/or the password are incorrect.
00002 Access to page denied. The user has attempted to access a page they don't have permission to access.
00003 Transaction type [type] not supported. Please contact support. Is returned by /console/vterm.php when an unknown transaction type (sale, credit, etc) is attempted.
00004 Processing gateway currently offline. Please try back in a few moments. Return by processing engine when the gateway cannot establish a connection with the processing backend.
00005 Error in verification module [module]. Please contact support. The given fraud module was did not load correctly. An upgrade may be in progress.
00006 Merchant not found. The system was not able to locate the requested merchant.
00007 Merchant has been deactivated. Merchant account has been marked as deactivate. Contact USAePay customer service.
00008 Unable to retrieve current batch. Failed to get the id of the current batch. Typically this indicates that the merchant account is not active or batches are out of sync. Verify all merchant account info provided to usaepay.
00009 Unable To Create Transaction. Please Contact Support. Internal database error, system may be in the process of failing over to backup database server. Retry transaction.
00010 Unable To Allocate Transaction Slot. Please contact support. Internal database error, system may be in the process of failing over to backup database server. Retry transaction.
00011 Invalid Card Number (1) The cardnumber contains illegal characters. A card number may only include numbers.
00012 Invalid Card Number (2) Card Number was not between 13 and 16 digits.
00013 Invalid Card Number (3) Cardnumber failed Luhn Mod-10 Checkdigit Method (ISO 2894/ANSI 4.13)
00014 Invalid Credit Card Number (1) Cardnumber passed length, format and checkdigit tests but didn't match any of the cardnumber profiles enabled in the system. Contact USAePay to verify support of cardtype.
00015 Invalid expiration date. Must be in MMYY format. Expiration contains invalid characters (nothing but numbers allowed)
00016 Invalid expiration date. Must be in MMYY format. Could not guess format of date. It wasn't MMYY or MMYYYY or MMDDYYYY or even MMDDYY format.
00017 Credit card has expired. The credit card expiration date has passed.
00018 Gateway temporarily offline. Please try again shortly. Unable to contact processor backend. Failed bank link maybe in the process of coming back up. Retry transaction.
00019 Gateway temporarily offline for maintenance. Please try again in a few minutes. Processor backend is offline for maintenance. Retry transaction.
00020 User not configured correctly, please contact support. User not configured correctly. Remove the user and readd.
00021 Invalid username. The merchant didn't type in a valid username when adding a new user.
00022 You do not have access to this page. The user tried to access a page they don't have permission to access.
00023 Specified source key not found. The source key provided did not match any of the currently active keys.
00024 Transaction already voided. The transaction was already marked as voided and wasn't going to be settled anyway.
00025 Unable to find transaction in batch. The batchid on the transaction references a batch that doesn't exist. If there isn't a valid batch then trying to void a transaction isn't going to do much.
00026 The batch has already been closed. Please apply a credit instead. The specified transaction has already been settled. Once a transaction has been sent in for settlement it can not be voided.
00027 Gateway temporarily offline. Please try again shortly. (2) Error communicating with the processing backend. Retry transaction.
00028 Unable to verify source. VerifySource couldn't find the source or the source was disabled.
00029 Unable to generate security key. VerifySource wasn't able to create a source on the fly. Trouble finding a key.
00030 Source has been blocked from processing transactions. Merchant has disabled the specified source key.
00031 Duplicate transaction, wait at least [minutes] minutes before trying again. The duplicate transaction fraud module detected a dupe.
00032 The maximum order amount is $[amount]. Fraud module response.
00033 The minimum order amount is $[amount]. Fraud module response.
00034 Your billing information does not match your credit card. Please check with your bank. AVS Response fraud module blocked this transaction.
00035 Unable to locate transaction. Was not able to find the requested transaction for voiding.
00036 Gateway temporarily offline for maintenance. Please try again in a few minutes. VeriCheck link has been brought down for maintenance. Retry transaction.
00037 Customer Name not submitted. Cardholder field was blank.
00038 Invalid Routing Number. Check Routing number did not meet requirement of 9 digits.
00039 Invalid Checking Account Number. Check Account number is not at least 4 digits long.
00040 Merchant does not currently support check transactions. The merchant doesn't have a valid tax id or password entered for check processing.
00041 Check processing temporarily offline. Please try again shortly. Internal system error encountered while communicating with check processor. Please contact USAePay support.
00042 Temporarily unable to process transaction. Please try again shortly. A corrupted response (unparsable) was received from vericheck.
00043 Transaction Requires Voice Authentication. Please Call-In. Processor returned a referral.
00044 Merchant not configured properly (CardAuth) The merchant has payment authentication enabled but does not have a processorid/merchantid entered.
00045 Auth service unavailable. Internal system error was encountered while connecting to authentication platform. Contact USAePay support.
00046 Auth service unavailable (6). A corrupted response was received from the authentication platform.
00050 Invalid SSN. Social Security number must be 9 digits.
00070 Transaction exceeds maximum amount. Transaction exceeds the maximum allowable amount of $99,999.
00071 Transaction out of balance. Transaction does not add up correctly: subtotal + tip + tax + shipping - discount must equal the amount.
00080 Transaction type not allowed from this source. The requested command (sale, authonly, etc) was blocked by the merchant's source key. The command must be checked on source key settings screen to be accepted by the gateway.
02034 Your billing address does not match your credit card. Please check with your bank. The AVS result received from the platform was blocked by the Merchant's fraud preferences. Funds were not held for this transaction.
10001 Processing Error Please Try Again Error from FDMS Nashville. Invalid Transaction Code
10003 Merchant does not accept this type of card (1) Error from FDMS Nashville: Terminal ID not setup for settlement on this Card Type.
10004 Merchant does not accept this type of card (2) Error from FDMS Nashville: Terminal ID not setup for authorization on this Card Type.
10005 Invalid Card Expiration Date Error from FDMS Nashville Terminal ID not setup for settlement on this Card Type.
10006 Merchant does not accept this type of card (3) Error from FDMS Nashville. Invalid Process Code, Authorization Type or Card Type.
10007 Invalid amount Error from FDMS Nashville Invalid Transaction or Other Dollar Amount.
10008 Processing Error Please Try Again (08) Error from FDMS Nashville. Invalid Entry Mode.
10009 Processing Error Please Try Again (09) Error from FDMS Nashville Invalid Card Present Flag.
10010 Processing Error Please Try Again (10) Error from FDMS Nashville Invalid Customer Present Flag.
10011 Processing Error Please Try Again (11) Error from FDMS Nashville Invalid Transaction Count Value.
10012 Processing Error Please Try Again (12) Error from FDMS Nashville Invalid Terminal Type.
10013 Processing Error Please Try Again (13) Error from FDMS Nashville Invalid Terminal Capability.
10014 Processing Error Please Try Again (14) Error from FDMS Nashville Invalid Source ID.
10015 Processing Error Please Try Again (15) Error from FDMS Nashville Invalid Summary ID.
10016 Processing Error Please Try Again (16) Error from FDMS Nashville Invalid Mag Strip Data.
10017 Invalid Invoice Number (17) Error from FDMS Nashville Invalid Invoice Number.
10018 Invalid Transaction Date or Time (18) Error from FDMS Nashville Invalid Transaction Date or Time.
10019 Processing Error Please Try Again (19) Error from FDMS Nashville Invalid bankcard merchant number in First Data database.
10020 Processing Error Please Try Again (20) Error from FDMS Nashville File Access Error in First Data database.
10026 Merchant has been deactivated (26) Error from FDMS Nashville Terminal flagged as Inactive in First Data database.
10027 Invalid Merchant Account (27) Error from FDMS Nashville. Invalid Merchant/Terminal ID combination, verify numbers are accurate.
10030 Processing Error Please Try Again (30) Error from FDMS Nashville. Unrecoverable database error from an authorization process (usually means the Merchant/Terminal ID was already in use).
10031 Processing Error Please Retry Transaction (31) Error from FDMS Nashville. Database access lock encountered, retry transaction.
10033 Processing Error Please Try Again (33) Error from FDMS Nashville. Database error in summary process, retry transaction.
10043 Sequence Error, Please Contact Support (43) Error from FDMS Nashville. Transaction ID invalid, incorrect or out of sequence.
10051 Merchant has been deactivated (51) Error from FDMS Nashville. Terminal flagged as not usable (violated) in First Data database, Call Customer Support.
10054 Merchant has not been setup correctly (54) Error from FDMS Nashville. Terminal ID not set up on First Data database for leased line access.
10057 Merchant does not support this card type (57) Error from FDMS Nashville. Terminal is not programmed for this service, call customer support.
10059 Processing Error Please Try Again (59) Error from FDMS Nashville. Settle Trans for Summary ID where earlier Summary ID still open.
10060 Invalid Account Number (60) Error from FDMS Nashville. Invalid account number found by authorization process.
10061 Processing Error Please Try Again (61) Error from FDMS Nashville. Invalid settlement data found in summary process (trans level).
10062 Processing Error Please Try Again (62) Error from FDMS Nashville. Invalid settlement data (i.e., 'future' date found, erroneous Pserve data found) (summary level).
10080 Processing Error Please Try Again (80) Error from FDMS Nashville. Invalid Payment Service data found in summary process (trans level).
10098 Processing Error Please Try Again (98) Error from FDMS Nashville. General System Error.
10099 Session timed out. Please re-login. Session timed out - (checkout timeout setting).
10100 Your account has been locked for excessive login attempts. The user failed login too many times. Their account has been locked for 60 minutes.
10101 Your username has been de-activated due to inactivity for 90 days. Please contact support to re-activate your account. VISA Cisp requires locking of accounts that have not been accessed in the past 90 days.
10102 Unable to open certificate. Unable to load required certificate. Contact Support.
10103 Unable to read certificate. Unable to load required certificate. Contact Support.
10104 Error reading certificate. Unable to load required certificate. Contact support.
10105 Unable to find original transaction. A capture or void operation was not able to locate the original transaction.
10106 You have tried too many card numbers, please contact merchant. The transaction was blocked by the MultipleCardTries module.
10107 Invalid billing zip code. The ZipCodeVerification module was not able to locate the billing zip code.
10108 Invalid shipping zip code. The ZipCodeValidation fraud module was not able to find module.
10109 Billing state does not match billing zip code. ZipCodeVerification database came up with a conflict.
10110 Billing city does not match billing zip code. ZipCodeVerification database came up with a conflict.
10111 Billing area code does not match billing zip code. ZipCodeVerification database came up with a conflict.
10112 Shipping state does not match shipping zip code. ZipCodeVerification database came up with a conflict.
10113 Shipping city does not match shipping zip code. ZipCodeVerification database came up with a conflict.
10114 Shipping area code does not match shipping zip code. ZipCodeVerification database came up with a conflict.
10115 Merchant does not accept transactions from [country]. IpCountry module blocked transaction.
10116 Unable to verify card ID number. CVV2, CID, etc result was blocked by CVVresponse fraud module.
10117 Transaction authentication required. The merchant has set a pin for this transaction but the api did not receive a UMmd5hash. They need to either upgrade their software to send the hash or they need to remove the pin on the source.
10118 Transaction authentication failed. The UMmd5hash did not match the hash that was calculated for the transaction.
10119 Unable to parse mag stripe data. Could not determine the mag data format that was sent in.
10120 Unable to locate valid installation. Please contact support. A wireless transaction came in with an install id that wasn't found in the system.
10121 Wireless key disabled. Please contact support. The install id submitted has been deleted/disabled.
10122 Wireless key mismatch. The wireless key submitted does not correspond to the source id created for this installation.
10123 Success Operation was successful. -
10124 Unsupported transaction type. Only authonly, sales and voids may be captured. An attempt was made to settle a transaction that can not be captured. This error will occur if you attempt to capture an echeck transaction.
10125 Original transaction not approved. You are trying to capture (settle) a transaction that was declined or resulted in an error. You can only capture approved transactions.
10126 Transactions has already been settled. You are trying to capture a transaction that has already been settled.
10127 Card Declined Hard decline from First Data. -
10128 Processor Error ([response]) Unknown response code from First Data Nashville.
10129 Invalid transaction data. PHP Library detected missing or invalid fields.
10130 Library Error. CURL support not found PHP Library was not able to find curl support. You must compile php with curl and openssl.
10131 Library Error. Unable to initialize CURL PHP Library was unable to initialize CURL. SSL support may be missing or incorrectly configured.
10132 Error reading from card processing gateway. PHP Library was received a bad response from the gateway.
 5.
    Errors by User Message
 6.
    Currency Codes
developer/reference.txt · Last modified: 2014/05/12 09:57 by tem

Page Tools