付款人数据质量
Quick Reference
What每笔银行卡交易的付款人数据都经过检查和规范
Why收单机构收到一致的数据，减少争议，无需集成工作
DifficultyBeginner
Prerequisites创建交易
继续发送您现有的交易请求。 在到达收单机构之前，我们会检查每个付款人字段，修正能够确定的内容，并准确告诉您发生了什么。
为什么重要
付款人数据在结账页面和收单机构之间容易受损：邮编丢失前导零，门牌号留在街道中，州以全称到达。每一处不一致都会让真实买家显得不那么可信。
这种成本是可以衡量的。在我们历史上超过 25 万笔已批准交易中，地址字段不一致的交易被争议的比例约为字段一致交易的两倍（1.73% 对 0.82%）。
一笔交易的变化
| 字段 | 您发送 | 收单机构收到 |
|---|---|---|
| 街道 | 200 Main St | 200 Main St |
| 门牌号 | 空 | 200 |
| 城市 | Boston | Boston |
| 州 | Massachusetts | MA |
| 邮编 | 2108 | 02108 |
您将获得
| 无需集成工作 | 在您的账户上启用，请求保持不变。 |
| 所有收单机构数据一致 | 每个字段都按该收单机构要求的格式发送。 |
| 可靠的地址 | 美国邮编不可用时，从官方邮政数据获得正确邮编。在已知邮编地址的测试中，191 个结果中有 190 个正确。 |
| 争议处理更有力 | 买家资料在多次购买之间保持一致，这正是申诉拒付所需要的。 |
| 完整可见 | 每笔交易都按字段说明检查和更改了什么。 |
| 不影响结账速度 | 检查只需微秒。唯一的外部确认仅在买家首次出现不可用邮编时进行，限时约一秒，且绝不会阻止交易。 |
批准始终由发卡行决定。此功能消除的是可以避免的疑点。
工作原理
- 规范。 国家、州、电话和门牌号采用预期格式。
- 检查。 将邮编、城市和州与公开参考数据相互比对。
- 仅在确定时更正。 只有当同一买家的其他数据确认正确值时，字段才会更改。
- 记录。 原始请求保持不变，每项更改都记录规则和来源。
查看处理结果
交易响应和 Webhook 包含 data_quality 对象，其中只有状态，绝不包含付款人数据。
"data_quality": {
"version": "1",
"mode": "standard",
"fields": {
"payer_address.postal_code": { "status": "certified", "rule": "US-CERT-01", "source": "postal_authority" },
"payer_address.address_number": { "status": "normalized", "rule": "ADDR-NUM-01", "source": "street" },
"payer_cell_phone": { "status": "valid" }
},
"flags": []
}
| 状态 | 含义 |
|---|---|
valid | 通过检查 |
normalized | 信息相同，格式已规范 |
corrected | 买家的其他数据确认了正确值，因此已更正 |
certified | 已通过官方邮政数据确认 |
unverified | 已提供但无法确认；已知时由 reason 说明 |
missing | 未发送 |
flags 仅供参考，可能新增，请勿编写遇到未知信号就失败的逻辑。
由您掌控
可选，按交易设置：
"data_quality": { "mode": "standard" }
| 模式 | 结果 |
|---|---|
standard | 检查并更正。默认值。 |
validate_only | 仅报告，数据按原样发送。 |
off | 此交易不使用该功能。 |
绝不执行的操作
- 绝不虚构姓名、证件、地址或设备数据。
- 绝不改写买家的姓名或城市。
- 绝不更改您发送的请求。
如果收单机构要求的字段不存在（如门牌号），则使用其接受的值，并将该字段标记为 unverified。
发挥最大效果
数据越接近买家，效果越好：发送结账时填写的邮编和州、买家的公网 IP，以及从买家设备读取的浏览器数据。
如何启用
联系您的客户经理，无需修改代码。