本页介绍了如何使用交易事件为评估添加注释,以优化特定于您网站的模型。
为获得最佳性能,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 } }
后续步骤
- 如要了解用户账号保护功能,请参阅用户账号保护功能。