使用交易事件注解评估

借助 Fraud Defense 中的交易事件注释，您可以提供评估后的付款生命周期数据，例如结算、退款和退款。此反馈有助于您优化网站专属模型，并改进未来的欺诈判定。

为获得最佳性能，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
  }
}

后续步骤