使用交易事件注解评估

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

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

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

  • 商家发放退款。

  • 付款工具签发机构提交退款申请。

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

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

在您创建包含交易数据的评估后，Transaction Defense 会返回判决和评估名称。在付款生命周期的以下重要阶段发生交易事件时，为评估添加注解：

事件类型 说明 原因示例 值示例
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
  }
}

后续步骤