為評估結果加上交易事件註解

本頁面說明如何使用交易事件標註評估,以改善網站專屬模型。

如要達到最佳成效,就必須讓 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_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 表示交易因詐欺而進入退款程序,且商家已選擇提出申訴。原因 範例包括 Google 探索的 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
  }
}

後續步驟