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

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

如要達到最佳成效，就必須讓 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
  }
}

後續步驟