# 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 を使用して不審請求の申請に対応するには、不審請求の申請が以下の条件を満たしている必要があります。

- 不審請求が申請された取引は、[ネットワークの理由コード](https://docs.stripe.com/api/disputes/object.md#dispute_object-payment_method_details-card-network_reason_code) 10.4 の Visa 取引である必要があります。
- 不審請求が申請された取引と同じ支払い方法を使用する、少なくとも 2 件の不審請求が申請されていない過去の取引が必要です。
  - 過去の不審請求が申請されていない取引は、不審請求が申請された取引の 120～364 日以内である必要があります。
  - 過去の不審請求が申請されていない取引は、支払い済みで、不審請求が申請されておらず、検証用の支払い以外である必要があります。
- 不審請求が申請された取引の [product description](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence-enhanced_evidence-visa_compelling_evidence_3-disputed_transaction-product_description) と、過去の不審請求が申請されていない取引の [product descriptions](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence-enhanced_evidence-visa_compelling_evidence_3-prior_undisputed_transactions-product_description) で、説明を提供する必要があります。
- 不審請求が申請された取引を、[merchandise_or_services](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence-enhanced_evidence-visa_compelling_evidence_3-disputed_transaction-merchandise_or_services) フィールドの `merchandise` または `services` で分類する必要があります。
- 不審請求が申請された取引と、2 件の過去の不審請求が申請されていない取引は、以下のいずれかに一致する必要があります。
  - 2 つの主要な反証資料 (たとえば、顧客の購入 IP と、顧客のデバイスフィンガープリント)。
  - 1 つの主要な反証資料「および」1 つの二次的な反証資料 (たとえば、顧客のデバイス ID と、顧客のアカウント ID)。

| 主要な反証資料 | 二次的な反証資料 |
| --- | --- |
| 顧客の購入 IP | 配送先住所 |
| 顧客のデバイスフィンガープリントまたは顧客のデバイス ID | 顧客のメールアドレス |
|  | 顧客のアカウント ID |

> 顧客のデバイスフィンガープリント「と」顧客のデバイス ID は、有効な組み合わせの反証資料ではありません。

## Enhanced Evidence オブジェクト

Visa CE 3.0 を使用して反証資料を提出するには、[Enhanced Evidence (高度な反証資料)](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence-enhanced_evidence) オブジェクトを使用します。これは [Dispute Evidence (不審請求の申請に対する反証資料)](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence) オブジェクト内にあります。[Enhanced Eligibility Types (高度な適格性タイプ)](https://docs.stripe.com/api/disputes/object.md#dispute_object-enhanced_eligibility_types) 配列には、[Enhanced Evidence](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence-enhanced_evidence) の適格性タイプの一覧が格納されます。

```json
{
  "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 (高度な適格性)](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence_details-enhanced_eligibility) オブジェクトは、Visa CE 3.0 の提出ステータスを示します。このオブジェクトは [Evidence Details (反証資料の詳細)](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence_details) オブジェクト内にあり、反証資料が CE 3.0 として Visa に送信されたことを確認するために必要なステップに関する詳細情報を提供します。

```json
{
  "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 (ステータス)](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence_details-enhanced_eligibility-visa_compelling_evidence_3-status) は、不審請求の申請の [Enhanced Evidence (高度な反証資料)](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence-enhanced_evidence) オブジェクト内に [Visa Compelling Evidence 3](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence-enhanced_evidence-visa_compelling_evidence_3) オブジェクトが入力されたときに、`qualified` または `requires_action` になります。

- ステータスが `requires_action` の場合、[required_actions](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence_details-enhanced_eligibility-visa_compelling_evidence_3-required_actions) 配列を使用して、その他の必要な反証資料を把握します。
- ステータスが `qualified` の場合は、Visa CE 3.0 の反証資料を提出する準備ができています。

[Update Dispute](https://docs.stripe.com/api.md#update_dispute) API を使用して、反証資料を提出できます。反証資料を提出せずに更新するには、必ず [submit](https://docs.stripe.com/api/disputes/update.md#update_dispute-submit) パラメーターを `false` に設定してください。

反証資料の提出後に、その反証資料が Visa CE 3.0 の要件を満たさない場合、ステータスは `not_qualified` に変わります。反証資料の提出は続けられますが、Visa CE 3.0 は使用されません。

適切な反証資料を提出した場合は、[不審請求の申し立てステータス](https://docs.stripe.com/api/disputes/object.md#dispute_object-status)フィールドで不審請求の申し立てのステータスを追跡し、反証成功したか失敗したかを確認してください。

> 不審請求の申請に対して、主張が認められる確率を高めるには、[Enhanced Evidence (高度な反証資料)](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence-enhanced_evidence) オブジェクトだけではなく、[Dispute Evidence (不審請求の申請に対する反証資料)](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence) オブジェクトにも入力してください。この反証資料は、Visa CE 3.0 の提出が承認されなかった場合に使用され、標準の反証資料の提出フローで提出されます。

## テスト

Visa CE 3.0 の連携をテストするには、次のテストカードを使用します。このカードは、Visa CE 3.0 の対象となる不審請求の申請を作成します。

| テスト方法 | トークン |
| --- | --- |
| カード番号 | 4000000404000038 |
| PaymentMethod | `pm_card_createCe3EligibleDispute` |
| トークン | `tok_createCe3EligibleDispute` |

この不審請求の申し立ての反証資料を提供する場合は、[prior_undisputed_transactions.charge](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence-enhanced_evidence-visa_compelling_evidence_3-prior_undisputed_transactions-charge) フィールドで任意の 2 つのテスト環境用取引を送信します。

> テスト環境では、任意の 2 つのテスト取引を `prior_undisputed_transactions` として使用します。テスト中に Stripe が以前の取引の決済手段や取引日を検証することはありません。

Visa CE 3.0 ルールに従って、一次および二次の反証資料要素が検証されます。

[Visa CE 3.0 status](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence_details-enhanced_eligibility-visa_compelling_evidence_3-status) は、提出された反証資料に応じて、`qualified` または `requires_action` を適宜反映します。

反証資料を提出すると、[Visa CE 3.0 status](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence_details-enhanced_eligibility-visa_compelling_evidence_3-status) は以下のようになります。

- `not_qualified`: 反証資料は Visa CE 3.0 の要件を満たしていません。
- `qualified`: 反証資料は Visa CE 3.0 の要件を満たしています。

> [Visa CE 3.0 status](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence_details-enhanced_eligibility-visa_compelling_evidence_3-status) は、[dispute status](https://docs.stripe.com/api/disputes/object.md#dispute_object-status) には影響しません。
> 
> 不審請求の申請全体の `won` または `lost` の状態をシミュレーションするには、[テスト](https://docs.stripe.com/testing.md?testing-method=card-numbers#evidence)で説明したように、[uncategorized_text](https://docs.stripe.com/api/disputes/update.md#update_dispute-evidence-uncategorized_text) を `winning_evidence` または `losing_evidence` に設定します。