注释:该 API 仅用于预览用途并会随时更改。
豁免评估
POST
您的请求到 exemptions:assess
操作链接。
评估示例请求
POST https://try.access.worldpay.com/exemptions/assessment
风险评估请求正文:
Copied!
参数 | 必需 | 描述 |
---|---|---|
transactionReference | 评估参考号。例如,电子商务订单代码。 | |
merchant.entity | 作为加入流程的一部分而创建,用于在 Access Worldpay 中发送评估请求。 | |
instruction | 包含与评估相关的所有支付信息的对象。 | |
instruction.paymentInstrument | 包含卡详情或 Token 位置的对象。 | |
paymentInstrument.type | 所使用的 paymentInstrument 的识别码。type : card/front
type : card/tokenized
| |
paymentInstrument.billingAddress | 包含账单邮寄地址信息的对象。如果已包括,则您必须至少要发送:
| |
instruction.value | 包含有关订单值信息的对象。 | |
value.currency | 三位数货币代码。 请参见 | |
value.amount | 订单金额。这是一个包含小数位的整数,e.g.,如果小数位是二,则 250 就表示 2.50.您可以在我们的 当应用 riskProfile 时,Access Payments 请求中的支付金额与评估请求中的金额必须匹配。 | |
deviceData.collectionReference | 利用 Threatmatrix 注释:如果没有提供值,则仍会执行评估,但不会受益于其他的风险分析或基于该值的任何手动规则(e.g.地点)。 |
评估请求中的附加字段
如果您有这些数据,我们建议您提供,因为它可以提高豁免评估的准确性。
共有三个 riskData
对象可供您纳入请求中:
其他账户 riskData
参数的描述:
参数 | 必需 | 描述 |
---|---|---|
account | 包含所有客户账户相关风险数据的对象。 | |
account.email | 客户的电邮地址。 | |
account.dateOfBirth | 客户的出生日期。 |
其他交易 riskData
参数的描述:
参数 | 必需 | 描述 |
---|---|---|
transaction | 包含所有客户交易相关风险数据的对象。 | |
transaction.firstName | 客户的名字。 | |
transaction.lastName | 客户的姓氏。 | |
transaction.phoneNumber | 客户的电话号码。 |
其他运输 riskData
参数的描述:
参数 | 必需 | 描述 |
---|---|---|
shipping | 包含与订单发货方式相关的所有数据的对象。 | |
shipping.firstName | 收货地址上使用的名字 | |
shipping.lastName | 收货地址上使用的姓氏 | |
shipping.address | 包含收货地址信息的对象。如果已包括,则您必须至少要发送:
|
评估响应
最佳实践:Access Worldpay 在服务响应的头文件中返回 WP-CorrelationId
。我们强烈建议您将此记录下来。我们使用 WP-CorrelationId
来检查个性化服务请求。
该响应包含您的 assessment
请求的结果。
Copied!
参数 | 描述 |
---|---|
outcome | 豁免的建议:
outcomes 以及如何再现这些结果的更多信息,请参见 |
exemption.placement |
|
exemption.type | 要应用的豁免类型
|
riskProfile.href | 可以在支付授权请求中使用的资源,该请求显示了豁免评估结果。用于:
|
应用豁免
应用提供给riskProfile
。这样将执行两项功能:
- 将豁免应用于支付请求。
- 可让数据模型从结果中学习,从而改进未来的评估请求。
即使未提供豁免,您也应该在支付请求中应用 riskProfile。
软拒绝
在应用到支付时豁免不成功的情况下(已认可 + 已授权),发卡机构将采用软拒绝(
后续步骤