AVS/CVC verification
It is possible in some countries to verify card address and get in response the verification result and CVC match result.
The merchant can submit sets of AVS/CVC values which should fail a transaction if AVS/CVC check result codes are in the given sets.
AVS codes
These codes will be used in AVS responses, and they will be mapped to codes of any external payment provider.
Code | Description |
---|---|
0 |
AVS result is unknown. |
1 |
AVS is not supported for this processor or card type. |
A |
Street address matches, ZIP code does not match. |
B |
Street address matches, but postal code is not verified. |
E |
A system error prevented any verification of street address or postal code. |
M |
Street address and postal code match. |
N |
Street address and postal code do not match. |
O |
Address does not match. |
P |
Postal code matches, but street address is not verified. |
W |
Street address does not match, ZIP code matches. |
U |
Address information is unavailable. |
AE1 |
Cardholder name is incorrect, but ZIP code matches. |
AE2 |
Cardholder name is incorrect, but street and ZIP code match. |
AE3 |
Cardholder name is incorrect, but street matches. |
AE4 |
Cardholder name matches. |
AE5 |
Cardholder name and ZIP code match. |
AE6 |
Cardholder name, street, and ZIP code match. |
AE7 |
Cardholder name and street match. |
CVC codes
These codes will be used in CVC responses, and they will be mapped to codes of any external payment provider.
Code | Description |
---|---|
0 |
CVC result is unknown. |
1 |
Card verification is not supported for this processor or card type. |
D |
Card verification is performed, and CVD was invalid. |
E |
A system error prevented any CVC verification. |
M |
Card verification code matches. |
N |
Card verification code is not matched. |
P |
Card verification is not performed, CVD was not on the card. Not all cards have a CVD value encoded. |
S |
Should have been present. |
U |
Card verification is not supported by the issuing bank. |
X |
No CVV2 information is available. |
Y |
Card verification is performed, and CVD was valid. |
Cancel transactions based on AVS/ CVC check results
These cancellation codes must be sent in the request parameters for payment, authorization and payment token, so that transactions are automatically canceled in case of match of AVS/CVC verification results to one of these codes.
Request example
{
...
"amount":100,
"currency":"USD",
...
"additional_data": {
"avs_cvc_verification": {
"cvc_verification" : {
"reject_codes": ["N"]
},
"avs_verification" : {
"reject_codes": ["N","B","P"]
}
}
}
...
}
Get AVS/ CVC check result
Look for the avs_cvc_verification
section in a eComCharge response to know AVS/CVC verification result.
Response example
{
...
"uid":"1-2d4b20c72a",
"status":"failed",
"amount":100,
...
"avs_cvc_verification": {
"cvc_verification" : {
"result_code": "N"
},
"avs_verification" : {
"result_code": "N"
}
}
...
}
Testing
To test different AVS/CVC response codes you should send in requests data as follows:
AVS verification testing
To emulate different AVS codes, send a digit (at any position) listed in the table in billing_address.address
and billing_address.zip
.
Address digit | Zip digit | AVS response code |
---|---|---|
0 | 0 | 0 |
2 | 2 | A |
3 | 3 | B |
4 | 4 | E |
5 | 5 | M |
6 | 6 | N |
7 | 7 | O |
8 | 8 | P |
9 | 9 | W |
10 | 10 | U |
11 | 11 | AE1 |
12 | 12 | AE2 |
13 | 13 | AE3 |
14 | 14 | AE4 |
15 | 15 | AE5 |
16 | 16 | AE6 |
17 | 17 | AE7 |
18 | 18 | AE7 |
19 | 19 | AE7 |
20 | 20 | AE7 |
Any other data | Any other data | 1 |
CVC verification testing
To emulate CVC verification codes, submit CVC codes from the table below.
CVC | CVC response code |
---|---|
000 | 0 |
111 | Y |
222 | D |
333 | E |
444 | M |
555 | N |
666 | P |
777 | S |
888 | U |
999 | X |
Any other data | 1 |