Simulating AVS Responses
By default, all transactions will have an AVS response of "MATCH" (address information matches). In order to simulate a different response, add a single prefix code from the table below in front of the value you include for the street parameter.
| Prefix | AVS Code | Description |
|---|---|---|
| 10 | MATCH | Both the address and zip code match |
| 11, 16 | MATCH_ADDRESS_ONLY | Address matches, but zip code does not |
| 12, 17 | MATCH_ZIP_ONLY | Zip code matches, but address does not |
| 13 | NO_MATCH | No part of the address matches |
| 18 | NOT_PROCESSED | Address information is unavailable |
| 15 | UNKNOWN | Unknown response from issuer/bank |
{
"merchantRefNum": "f421c552-b975-4b72-ae85-b7e1c539dec2",
"transactionType": "PAYMENT",
"amount": 567,
"threeDs": {
"merchantUrl": "https://example.com",
"deviceChannel": "BROWSER",
"messageCategory": "PAYMENT",
"transactionIntent": "GOODS_OR_SERVICE_PURCHASE",
"authenticationPurpose": "PAYMENT_TRANSACTION"
},
"accountId": "1002409460",
"card": {
"cardNum": "4000000000002503",
"cardExpiry": {
"month": "02",
"year": "2026"
},
"cvv": 111,
"holderName": "John Doe"
},
"profile": {
"firstName": "John",
"lastName": "Doe",
"email": "john.doe@paysafe.com"
},
"paymentType": "CARD",
"currencyCode": "USD",
"customerIp": "172.0.0.1",
"billingDetails": {
"nickName": "Home",
"street": "12 5335 Gate Pkwy",
"city": "Jacksonville",
"zip": "32256",
"country": "US",
"state": "FL"
}
"returnLinks": [
{
"rel": "on_completed",
"href": "https://www.example.com/completed/",
"method": "GET"
},
{
"rel": "on_failed",
"href": "https://www.example.com/failed/",
"method": "GET"
},
{
"rel": "default",
"href": "https://www.example.com/failed/",
"method": "GET"
}
]
}
{
"id": "74deece7-ce5e-46a5-9586-6690f5a68704",
"accountId": "1002409460",
"paymentType": "CARD",
"paymentHandleToken": "SCAy8OxApGCV1iVB",
"merchantRefNum": "f421c552-b975-4b72-ae85-b7e1c539dec2",
"currencyCode": "USD",
"txnTime": "2024-10-18T09:56:51Z",
"billingDetails": {
"nickName": "Home",
"street": "12 5335 Gate Pkwy",
"city": "Jacksonville",
"zip": "32256",
"state": "FL",
"country": "US"
},
"customerIp": "172.0.0.1",
"status": "INITIATED",
"links": [
{
"method": "GET",
"rel": "redirect_payment",
"href": "https://hosted.test.paysafe.com/cardadapter/v1/authentication/app/index.html?id=74deece7-ce5e-46a5-9586-6690f5a68704"
}
],
"amount": 567,
"action": "REDIRECT",
"usage": "SINGLE_USE",
"timeToLiveSeconds": 299,
"transactionType": "PAYMENT",
"executionMode": "SYNCHRONOUS",
"profile": {
"locale": "en",
"firstName": "John",
"lastName": "Doe",
"email": "john.doe@paysafe.com"
},
"card": {
"cardExpiry": {
"month": "2",
"year": "2026"
},
"holderName": "John Doe",
"cardType": "VI",
"cardBin": "400000",
"lastDigits": "2503",
"cardCategory": "DEBIT",
"issuingCountry": "US"
},
"returnLinks": [
{
"method": "GET",
"rel": "on_completed",
"href": "https://www.example.com/completed/"
},
{
"method": "GET",
"rel": "on_failed",
"href": "https://www.example.com/failed/"
},
{
"method": "GET",
"rel": "default",
"href": "https://www.example.com/failed/"
}
],
"skip3ds": false,
"threeDs": {
"merchantUrl": "https://example.com",
"deviceChannel": "BROWSER",
"messageCategory": "PAYMENT",
"transactionIntent": "GOODS_OR_SERVICE_PURCHASE",
"authenticationPurpose": "PAYMENT_TRANSACTION"
}
}
{
"merchantRefNum": "6ec5009e-0479-466b-919d-70242e453022",
"amount": 567,
"currencyCode": "USD",
"dupCheck": true,
"settleWithAuth": true,
"paymentHandleToken": "SCAy8OxApGCV1iVB",
"customerIp": "127.0.0.1",
"description": "Paysafe Casino"
}
{
"id": "30061d15-80d0-4edd-a8d8-6af5ea2daabb",
"paymentType": "CARD",
"paymentHandleToken": "SCAy8OxApGCV1iVB",
"merchantRefNum": "6ec5009e-0479-466b-919d-70242e453022",
"currencyCode": "USD",
"settleWithAuth": true,
"txnTime": "2024-10-18T09:57:15Z",
"billingDetails": {
"nickName": "Home",
"street": "12 5335 Gate Pkwy",
"city": "Jacksonville",
"zip": "32256",
"state": "FL",
"country": "US"
},
"customerIp": "127.0.0.1",
"status": "COMPLETED",
"amount": 567,
"preAuth": false,
"description": "Paysafe Casino",
"availableToSettle": 0,
"gatewayResponse": {
"authCode": "250603",
"avsResponse": "MATCH_ZIP_ONLY",
"cvvVerification": "MATCH",
"serializable": true
},
"merchantDescriptor": {
"dynamicDescriptor": "Merchant Test Descriptor"
},
"settlements": [
{
"merchantRefNum": "6ec5009e-0479-466b-919d-70242e453022",
"amount": 567,
"id": "30061d15-80d0-4edd-a8d8-6af5ea2daabb",
"availableToRefund": 567,
"txnTime": 1729245435000,
"status": "PENDING",
"gatewayReconciliationId": "2335305570"
}
],
"authentication": {
"id": "7d1a1c04-8efa-4475-8d16-95f425606425",
"eci": "5",
"cavv": "AAIBBYNoEwAAACcKhAJkdQAAAAA=",
"status": "COMPLETED",
"threeDResult": "Y",
"threeDSecureVersion": "2.2.0",
"directoryServerTransactionId": "e538a10f-2929-468f-a8a7-76441a947f90"
},
"profile": {
"locale": "en",
"firstName": "John",
"lastName": "Doe",
"email": "john.doe@paysafe.com"
},
"card": {
"cardExpiry": {
"month": "2",
"year": "2026"
},
"holderName": "John Doe",
"cardType": "VI",
"cardBin": "400000",
"lastDigits": "2503",
"cardCategory": "DEBIT",
"issuingCountry": "US"
}
}
Was this page helpful?
On this Page