使用交易事件注解评估

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

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

后续步骤