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

您可以使用 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 表示交易因詐欺而進入交易退單程序，且商家已選擇進入重新提交程序。原因範例包括探索的 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
  }
}

後續步驟