使用交易事件为评估添加注解

本页介绍了如何使用交易事件为评估添加注解，以优化针对特定网站的模型。

为获得最佳性能，reCAPTCHA Enterprise Fraud Prevention 需要了解交易的付款生命周期事件。因此，我们建议您为使用交易数据创建的评估发送注释。例如，在以下情况下，您可以将交易信息作为交易事件提供给 reCAPTCHA Enterprise Fraud Prevention：

  • 付款服务机构接受或拒绝交易。

  • 商家发放退款。

  • 付款签发机构办理退款。

如需详细了解如何发送注解，请参阅为评估添加注解。

我们建议您在数据可用时（例如事务状态发生变化时），在系统中自动发出这些请求，作为相应逻辑的一部分。

使用包含的交易数据创建评估后，reCAPTCHA Enterprise Fraud Prevention 会返回判定结果和评估名称。在付款生命周期的以下重要阶段，为评估添加交易事件注释：

事件类型 说明 原因示例 值示例
MERCHANT_APPROVE | MERCHANT_DENY 在您决定是否允许交易继续进行时。 IN_HOUSE 不适用
AUTHORIZATION | AUTHORIZATION_DECLINE 当您提交要处理的交易，并且发卡机构决定是否允许交易继续进行时。 82（一个原因代码，表示 CVV 不正确） 不适用
CHARGEBACK 当交易被退款时。 Card Reported Stolen 20 （表示 20 个货币单位的部分退款）

除了 CHARGEBACK 事件类型之外，还要添加发卡机构使用 reason 字段提供的退款原因代码。此外，如果交易被退回了部分款项，请在 value 字段中填写退回的金额。

在交易事件 reason 字段中，您可以添加澄清性条款以提供有关事件原因的更多背景信息，也可以提供直接从付款网络或发卡机构获取的原因代码。这些术语和代码因事件类型而异。

下表完整列出了交易事件类型：

注解原因 说明
MERCHANT_APPROVE 表示交易已获得商家批准。附带的原因可能包括 IN_HOUSE、ACCERTIFY、CYBERSOURCE 或 MANUAL_REVIEW 等字词。
MERCHANT_DENY 表示由于商家检测到风险而拒绝并完成交易。附带的原因可能包括 IN_HOUSE、ACCERTIFY、CYBERSOURCE 或 MANUAL_REVIEW 等字词。
MANUAL_REVIEW 表示出于怀疑或风险原因，正在由人工评估交易。
AUTHORIZATION 表示发卡机构授权尝试成功。
AUTHORIZATION_DECLINE 表示发卡机构尝试授权失败。随附的原因可能包括 Visa 的 54 表明卡已过期，或 82 表明 CVV 不正确。
PAYMENT_CAPTURE 表示交易已完成，因为相关款项已结清。
PAYMENT_CAPTURE_DECLINE 表示由于资金未结清而无法完成交易。
CANCEL 表示交易已取消。请说明取消原因。例如 INSUFFICIENT_INVENTORY。
CHARGEBACK_INQUIRY 表示商家收到了因交易欺诈而收到退款的咨询，商家在正式发出欺诈退款和发送正式的退款通知之前请求提供更多信息。
CHARGEBACK_ALERT 表示商家收到了由于交易欺诈而收到的退款提醒。在不涉及付款网络的情况下解决争议的过程已启动。
FRAUD_NOTIFICATION 表示由于交易似乎具有欺诈性，因此付款方式的发卡银行针对交易发出了欺诈通知。我们建议在此事件类型的 reason 字段中添加 TC40 或 SAFE 数据。对于部分退款，我们建议您在 value 字段中添加金额。
CHARGEBACK 表示付款网络告知商家，交易已由于欺诈而进入退款流程。原因代码示例包括 Google 探索的 6005 和 6041。对于部分退款，我们建议您在 value 字段中添加金额。
CHARGEBACK_REPRESENTMENT 表示交易已因欺诈而进入退款流程，并且商家已选择作为代理。原因示例包括 Google 探索的 6005 和 6041。对于部分退款，我们建议您在 value 字段中添加金额。
CHARGEBACK_REVERSE 表示交易发生了不合法的欺诈退款，因此已被撤销。对于部分退款，我们建议您在 value 字段中添加金额。
REFUND_REQUEST 表示商家已收到已完成交易的退款。对于部分退款，我们建议您在 value 字段中添加金额。原因示例：FRAUD。
REFUND_DECLINE 表示商家已收到此交易的退款申请，但他们已拒绝。对于部分退款，我们建议您在 value 字段中添加金额。原因示例：FRAUD。
REFUND 表示商家已退还已完成的交易。对于部分退款，我们建议您在 value 字段中添加金额。原因示例：PROACTIVE_FRAUD。
REFUND_REVERSE 表示已完成的交易已由商家退款，并且此退款已撤消。对于部分退款，我们建议您在 value 字段中添加金额。

以下示例展示了包含交易事件的示例注解载荷。如需了解详情，请参阅为评估添加注解。

POST https://recaptchaenterprise.googleapis.com/v1/ASSESSMENT_ID:annotate
{
  "transaction_event": {
    "event_type": "CHARGEBACK",
    "reason": "Card Reported Stolen",
    "value": 20
  }
}

后续步骤