本頁面說明如何使用交易事件標註評估,以改善網站專屬模型。
如要達到最佳成效,就必須讓 reCAPTCHA Fraud Prevention 掌握交易的付款生命週期事件。因此,建議您為使用交易資料建立的評估項目傳送註解。舉例來說,在下列情況下,您可以將交易資訊提供給 reCAPTCHA Fraud Prevention 做為交易事件:
付款服務供應商接受或拒絕交易。
商家核發退款。
發卡機構提出退款申請。
如要進一步瞭解如何傳送註解,請參閱「為評估作業加上註解」。
建議您在系統中加入相應的邏輯,在資料可用時 (例如交易狀態變更時),自動發出這些要求。
建立評估並納入交易資料後,reCAPTCHA Fraud Prevention 會傳回判定結果和評估名稱。在付款生命週期的下列重要階段發生交易事件時,為評估加上註解:
事件類型 | 說明 | 原因範例 | 值範例 |
---|---|---|---|
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 |
表示交易因詐欺而進入退款程序,且商家已選擇提出申訴。原因
範例包括 Google 探索的 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 } }
後續步驟
- 如要瞭解使用者帳戶保護功能,請參閱使用者帳戶保護功能。