Visa Compelling Evidence 3.0 の対象となる不審請求の申請
API と Visa の Compelling Evidence 3.0 を使用して対象となる不審請求の申請に対応します。
Visa Compelling Evidence 3.0 (CE 3.0) には、ビジネスがフレンドリー詐欺に対抗するためにカード保有者との不正利用ではない過去の取引を提示できる新しい適格条件が含まれています。Visa CE 3.0 の対象となる不審請求の申請に対して適格な反証資料を提出すると、カード発行会社がフレンドリー詐欺に関する申請をビジネスの意向に沿ったかたちで覆すことができる確率を高められます。
Visa CE 3.0 の対象となる不審請求の申請
Visa CE 3.0 を使用して不審請求の申請に対応するには、不審請求の申請が以下の条件を満たしている必要があります。
- 不審請求が申請された取引は、ネットワークの理由コード 10.4 の Visa 取引である必要があります。
- 不審請求が申請された取引と同じ支払い方法を使用する、少なくとも 2 件の不審請求が申請されていない過去の取引が必要です。
- 過去の不審請求が申請されていない取引は、不審請求が申請された取引の 120 日から 365 日前のものである必要があります。
- 過去の不審請求が申請されていない取引は、支払い済みで、不審請求が申請されておらず、検証用の支払い以外である必要があります。
- 不審請求が申請された取引の product description と、過去の不審請求が申請されていない取引の product descriptions で、説明を提供する必要があります。
- 不審請求が申請された取引を、merchandise_or_services フィールドの
merchandise
またはservices
で分類する必要があります。 - 不審請求が申請された取引と、2 件の過去の不審請求が申請されていない取引は、以下のいずれかに一致する必要があります。
- 2 つの主要な反証資料 (たとえば、顧客の購入 IP と、顧客のデバイスフィンガープリント)。
- 1 つの主要な反証資料「および」1 つの二次的な反証資料 (たとえば、顧客のデバイス ID と、顧客のアカウント ID)。
主要な反証資料 | 二次的な反証資料 |
---|---|
顧客の購入 IP | 配送先住所 |
顧客のデバイスフィンガープリントまたは顧客のデバイス ID | 顧客のメールアドレス |
顧客のアカウント ID |
注
顧客のデバイスフィンガープリント「と」顧客のデバイス ID は、有効な組み合わせの反証資料ではありません。
Enhanced Evidence オブジェクト
Visa CE 3.0 を使用して反証資料を提出するには、Enhanced Evidence (高度な反証資料) オブジェクトを使用します。これは Dispute Evidence (不審請求の申請に対する反証資料) オブジェクト内にあります。Enhanced Eligibility Types (高度な適格性タイプ) 配列には、Enhanced Evidence の適格性タイプの一覧が格納されます。
{ "id": "du_TFCU9xJ2Gsj7BAiAoQok8Icp", "charge": "ch_vEUUPELhHVkPbMN1md3B0vG7", "enhanced_eligibility_types": ["visa_compelling_evidence_3"], "evidence": { "enhanced_evidence": { "visa_compelling_evidence_3": { "disputed_transaction": { "customer_email_address": "test@example.com", "customer_purchase_ip": "123.123.123.123", "merchandise_or_services": "merchandise", "product_description": "Widget ABC, color: green", }, "prior_undisputed_transactions": [ { "charge": "ch_nE8T8mUOoy9zkkOQLHuLsr3Z", "customer_email_address": "test@example.com", "customer_purchase_ip": "123.123.123.123", "product_description": "Widget DEF, color: blue" }, { "charge": "ch_PcE97JB902XNTc1JpyBFmMTF", "customer_email_address": "test@example.com", "customer_purchase_ip": "123.123.123.123", "product_description": "Widget XYZ, color: yellow" } ] } }, } ... }
Enhanced Eligibility オブジェクト
Enhanced Eligibility (高度な適格性) オブジェクトは、Visa CE 3.0 の提出ステータスを示します。このオブジェクトは Evidence Details (反証資料の詳細) オブジェクト内にあり、反証資料が CE 3.0 として Visa に送信されたことを確認するために必要なステップに関する詳細情報を提供します。
{ "enhanced_eligibility_types": ["visa_compelling_evidence_3"], "evidence_details": { "due_by": 1708387199, "enhanced_eligibility": { "visa_compelling_evidence_3": { "partner_rejected_details": null, "required_actions": [ "missing_merchandise_or_services", "missing_disputed_transaction_description" ], "status": "requires_action" } }, "has_evidence": false, "past_due": false, "submission_count": 0 }, "payment_method_details": { "card": { "brand": "visa", "network_reason_code": "10.4" }, "type": "card" }, "reason": "fraudulent", "status": "needs_response" }
自動入力される反証資料
Stripe が、不審請求の申請が行われた取引が Visa CE 3.0 の対象であると認めた場合、Stripe はその不審請求が申請された取引と、不審請求が申請されていない以前の取引から得られた反証資料の自動入力を試行します。不審請求が申請された取引が適格であると考えられる場合は、Visa CE 3.0 の反証資料を手動で追加する選択もできます。
注
Stripe は過去の不審請求が申請されていないすべての取引を処理している必要があります。
提出のライフサイクル
Visa CE 3.0 の status (ステータス) は、不審請求の申請の Enhanced Evidence (高度な反証資料) オブジェクト内に Visa Compelling Evidence 3 オブジェクトが入力されたときに、qualified
または requires_
になります。
- ステータスが
requires_
の場合、required_actions 配列を使用して、その他の必要な反証資料を把握します。action - ステータスが
qualified
の場合は、Visa CE 3.0 の反証資料を提出する準備ができています。
Update Dispute API を使用して、反証資料を提出できます。反証資料を提出せずに更新するには、必ず submit パラメーターを false
に設定してください。
反証資料の提出後に、その反証資料が Visa CE 3.0 の要件を満たさない場合、ステータスは not_
に変わります。反証資料の提出は続けられますが、Visa CE 3.0 は使用されません。
要件を満たす反証資料を提出した場合は、不審請求の申請のステータスフィールドで不審請求の申請のステータスを追跡し、主張が認められたかどうかを確認します。
注
不審請求の申請に対して、主張が認められる確率を高めるには、Enhanced Evidence (高度な反証資料) オブジェクトだけではなく、Dispute Evidence (不審請求の申請に対する反証資料) オブジェクトにも入力してください。この反証資料は、Visa CE 3.0 の提出が承認されなかった場合に使用され、標準の反証資料の提出フローで提出されます。
テスト
Visa CE 3.0 の連携をテストするには、次のテストカードを使用します。このカードは、Visa CE 3.0 の対象となる不審請求の申請を作成します。
テスト方法 | トークン |
---|---|
カード番号 | |
PaymentMethod | pm_ |
トークン | tok_ |
この不審請求の申請の反証資料を提出する際は、prior_undisputed_transactions.charge フィールドでテスト環境の任意の取引を 2 件提出できます。
注
テスト環境では、テスト環境の任意の 2 件の取引を prior_
として使用できます。 Stripeは、テスト環境で以前の取引の支払い方法や取引日の検証を行いません。
Visa CE 3.0 ルールに従って、一次および二次の反証資料の要素が検証されます。
Visa CE 3.0 status は、提出された反証資料に応じて、qualified
または requires_
を適宜反映します。
反証資料を提出すると、Visa CE 3.0 status は以下のようになります。
not_
: 反証資料は Visa CE 3.0 の要件を満たしていません。qualified qualified
: 反証資料は Visa CE 3.0 の要件を満たしています。
注
Visa CE 3.0 status は、dispute status には影響しません。
不審請求の申請全体の won
または lost
の状態をシミュレーションするには、テストで説明したように、uncategorized_text を winning_
または losing_
に設定します。