地址验证服务
地址验证服务 (AVS) 是一项安全功能，将付款人输入的账单地址与发卡机构保留的记录进行比较。 AVS 响应代码 (response.cardholderVerification.avs.gatewayCode) 在交易响应消息中返回，指示地址匹配程度或匹配失败。
网关根据您在 Merchant Administration 中的配置检查响应代码并采取适当的措施（允许正常处理付款、自动拒绝付款或等待您手动确定如何处理）。 还可以根据从风险管理服务收到的风险评估结果来拒绝交易，该结果在评估期间使用 AVS 响应。 欲了解更多信息，请联系 your payment service provider。
如果您配置为使用 AVS，则会对您发送的所有卡交易进行 AVS 检查。
支持的方法和交易
| 集成方法 | 付款方式 | 交易 |
|---|---|---|
|
|
|
- 仅部分收单行支持 AVS。 此外，并非所有银行都支持 AVS。 如果发卡银行不支持 AVS，则交易请求中传递的任何 AVS 数据都将被忽略。
- 您可以使用返回特定 AVS 检查结果的测试卡来测试您的集成。 有关详细信息，请参阅 测试卡。
在开始使用 AVS 之前，请在 ARC Pay Gateway 的“交易筛选 > AVS 规则”菜单中配置 Merchant Administration 对特定 AVS 结果必须做出何种反应的规则。
发送交易请求时，请在请求中包含尽可能多的有关付款人姓名和账单地址的详细信息。 此外，如果您想要覆盖在 Merchant Administration 中定义的规则，在请求中加入包含新规则的 order.transactionFiltering.avsResponseCodeRules 对象。
示例请求和响应
此部分详细介绍示例 AVS 请求和响应。
带有 AVS 数据的 PAY 请求示例
{
"apiOperation": "PAY",
"billing": {
"address": {
"postcodeZip": "CR1 012",
"street": "Leamington Street"
}
},
"order": {
"amount": "100.00",
"currency": "EUR",
"transactionFiltering": {
"avsResponseCodeRules": [
{
"avsResponseCode": "ADDRESS_MATCH",
"action": "NO_ACTION"
},
{
"avsResponseCode": "ADDRESS_ZIP_MATCH",
"action": "NO_ACTION"
},
{
"avsResponseCode": "NAME_ADDRESS_MATCH",
"action": "REVIEW"
},
{
"avsResponseCode": "NAME_MATCH",
"action": "NO_ACTION"
},
{
"avsResponseCode": "NAME_ZIP_MATCH",
"action": "REJECT"
},
{
"avsResponseCode": "NOT_AVAILABLE",
"action": "REVIEW"
},
{
"avsResponseCode": "NOT_REQUESTED",
"action": "NO_ACTION"
},
{
"avsResponseCode": "NOT_VERIFIED",
"action": "REJECT"
},
{
"avsResponseCode": "NO_MATCH",
"action": "REVIEW"
},
{
"avsResponseCode": "SERVICE_NOT_AVAILABLE_RETRY",
"action": "NO_ACTION"
},
{
"avsResponseCode": "SERVICE_NOT_SUPPORTED",
"action": "REJECT"
},
{
"avsResponseCode": "ZIP_MATCH",
"action": "REVIEW"
}
]
}
},
"sourceOfFunds": {
"provided": {
"card": {
"expiry": {
"month": "05",
"year": "20"
},
"number": "<16-digit card number>",
"nameOnCard": "TESTNAME"
}
},
"type": "CARD"
}
}
响应中的 AVS 结果示例
交易响应在 response 对象中包含 AVS 检查的结果：
response.gatewayCode
Summary of the result of the operation.response.gatewayRecommendation
Action taken by the gateway based on the result.
"acquirerCode": "0000",
"cardSecurityCode": {
"acquirerCode": "M",
"gatewayCode": "MATCH"
},
"cardholderVerification": {
"avs": {
"acquirerCode": "M",
"gatewayCode": "ADDRESS_ZIP_MATCH"
}
},
"gatewayCode": "APPROVED",
"gatewayRecommendation": "NO_ACTION"
}