使用交易事件注解评估

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

为获得最佳性能,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_HOUSEACCERTIFYCYBERSOURCEMANUAL_REVIEW 等字词。
MERCHANT_DENY 表示由于商家检测到风险,交易遭拒并已结束。附带的原因可能包括 以IN_HOUSEACCERTIFYCYBERSOURCEMANUAL_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 中包含 TC40SAFE 数据 此事件类型的另一个字段。对于部分退款,我们建议您 在 value 字段中添加金额。
CHARGEBACK 表示付款网络通知商家,由于存在欺诈行为,交易已进入退单流程。原因代码示例包括 Discover 的 60056041。对于部分退款, 建议您在value字段中填写一个金额
CHARGEBACK_REPRESENTMENT 表示交易因欺诈而进入了退单流程,并且商家已选择进入代表申诉流程。原因示例包括 Discover 的 60056041。对于部分退款,我们建议您在 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
  }
}

后续步骤