
Understanding AVS Fields
Credit card companies use Address Verification Systems (AVS) to verify the identity of their customers (for example, matching the street address number and zip code with the street address and zip code provided by the cardholders). Forte uses a more robust address verification system that provides verification checks on credit card account numbers, zip codes, street numbers, states, area codes, and emails. The AVS fields (such as those contained within the response
object of the Forte web services) indicate the method and result of a verification check through the following value:
X1X2X3X4X5
Where,
Value | Type of Verification Check |
---|---|
X1 | Credit Card Account and Zip Code |
X2 | Credit Card Account and Street Number |
X3 | State and Zip Code |
X4 | State and Area Code |
X5 | Anonymous Email |
To determine the avs_code
value, use the following digits to determine what types of checks the system performed:
Digit | Description |
---|---|
0 | Do not perform check |
1 | Check only; do not decline on fail |
2 | Check and decline on fail |
For example, an avs_code
of 22000
indicates that the system only performed the credit card account/zip code (X1) and the credit card account/street number (X2) checks. The system did not perform verification checks on the state/zip code, state/area code, and anonymous email values (X3–X5).
To determine avs_result
value, use the following digits to determine which checks passed, failed, or were not performed:
Digit | Description |
---|---|
0 | Check not performed |
3 | Passed |
4 | Failed |
For example, an avs_result
of 00334
indicates that the verification checks on the state/zip code (X3) and state/area code (X4) both passed; however, the check on the anonymous email (X5) failed. Whether or not this customer's transaction is declined depends upon the method that was used to perform the checks.