使用交易事件注解评估

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

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

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

  • 商家发放退款。

  • 付款发卡机构提出退款。

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

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

在您创建包含交易数据的评估后，reCAPTCHA 欺诈防范会返回判定结果和评估名称。在付款生命周期的以下重要阶段（发生时）使用交易事件为评估添加注解：

事件类型 说明 原因示例 值示例
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 表示付款网络通知商家，由于存在欺诈行为，交易已进入退单流程。原因代码示例包括 Discover 的 6005 和 6041。对于部分退款，我们建议您在 value 字段中添加金额。
CHARGEBACK_REPRESENTMENT 表示交易因欺诈而进入了退单流程，并且商家已选择进入代表申诉流程。原因示例包括 Discover 的 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
  }
}

后续步骤