AVS（Address Verification Service）功能说明
1. 功能简介
AVS（Address Verification Service， 地址验证服务）是一项用于验证持卡人账单地址的服务。当商户在支付请求中上送账单地址信息时，系统将根据卡组织或支付渠道的返回结果执行 AVS 检查，从而优化授权判断并提高交易稳定性。
2. 启用方式
在请求报文最外层添加字段：
"allowAvsCheck": trueallowAvsCheck = false：不启用 AVS（即使参数齐全也不会检查）allowAvsCheck = true：启用 AVS
3. 必填字段说明
启用 AVS 时，需在userInfo.billingAddress中上送以下字段：
| 字段 | 是否必填 | 规则 |
|---|---|---|
| billingAddress.addressLine1 | M | 长度 10–20 字节（≤50 字符，超过 20 字节将截断） |
| billingAddress.postalCode | M | 长度固定 9 字节（≤16 字符，超过 9 字节将截断） |
| billingAddress.country | M | ISO-3166-1 alpha-3，例如：HKG |
| billingAddress.city | O | 视具体场景与业务需要，可选上送 |
说明：某些接口可能会要求 city 为必填，但通用规范中将其视为可选字段。若相关接口有更严格要求，请以接口规范为准。
示例请求：
{
"allowAvsCheck": true,
"userInfo": {
"billingAddress": {
"country": "USA",
"addressLine1": "123 Main Street",
"postalCode": "10001",
"city": "New York"
}
}
}
4. 响应字段说明
启用 AVS 且成功触发检查后，交易响应与回调中将新增以下字段（位于 pspTransInfo）:
| 字段 | 说明 |
|---|---|
| avsCheckResultRaw | 渠道返回的原始 AVS 码 |
| avsCheckResult | 系统内部映射后的标准化结果（平台展示此字段） |
5. 平台展示
在平台的交易详情页，新增 AVS 信息模块：
6. 最佳实践
- 完整、规范填写账单地址有助于进一步提升交易成功率
- 若未按要求发送必要字段，系统可能会返回参数校验错误