# Litiges éligibles à la procédure Visa Compelling Evidence 3.0

Utilisez l'API et la procédure Compelling Evidence 3.0 de Visa pour répondre aux litiges éligibles.

Le programme Visa Compelling Evidence 3.0 (CE 3.0) a mis en place de nouveaux critères d’éligibilité permettant aux entreprises de justifier d’un historique non frauduleux avec les titulaires de cartes afin de lutter contre la fraude amicale. En soumettant des preuves pour les litiges éligibles à la procédure Visa CE 3.0, vous augmentez les chances qu’un émetteur infirme les litiges pour fraude amicale en faveur de l’entreprise.

## Litiges éligibles à la procédure Visa CE 3.0

Pour répondre à un litige via la procédure Visa CE 3.0, le litige doit répondre aux critères suivants :

- La transaction contestée doit être une transaction Visa avec [code de motif réseau](https://docs.stripe.com/api/disputes/object.md#dispute_object-payment_method_details-card-network_reason_code) 10.4.
- Il doit y avoir au moins deux transactions antérieures qui n’ont pas été contestées et quoi ont été effectuées avec le même moyen de paiement que la transaction contestée.
  - Les transactions antérieures non contestées doivent avoir eu lieu dans une période comprise entre 120 et 364 jours avant la transaction contestée.
  - Les transactions antérieures non contestées doivent avoir été réglées, ne pas avoir été contestées et ne peuvent pas être des paiements de validation.
- Vous devez fournir une [description pour le produit](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence-enhanced_evidence-visa_compelling_evidence_3-disputed_transaction-product_description) de la transaction contestée et des [descriptions pour les produits](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence-enhanced_evidence-visa_compelling_evidence_3-prior_undisputed_transactions-product_description) des transactions antérieures non contestées.
- Vous devez classer la transaction contestée en tant que `merchandise` ou `services` dans le champ [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).
- La transaction contestée et les deux transactions antérieures non contestées doivent correspondre à :
  - Deux éléments de preuve principaux (par exemple, l’adresse IP du client ayant effectué l’achat et l’empreinte de l’appareil du client).
  - Un élément de preuve principal *et* un élément de preuve secondaire (par exemple, l’ID de l’appareil du client et l’ID de compte du client).

| Principaux éléments de preuve                                   | Éléments de preuve secondaires |
| --------------------------------------------------------------- | ------------------------------ |
| Adresse IP du client ayant effectué l’achat                     | Adresse de livraison           |
| Empreinte de l’appareil du client ou ID de l’appareil du client | Adresse e-mail du client       |
|                                                                 | ID de compte du client         |

> L’empreinte de l’appareil du client *et* l’ID de l’appareil du client ne constituent pas une combinaison de preuves valide.

## L’objet Enhanced evidence

Pour soumettre des preuves via la procédure Visa CE 3.0, utilisez l’objet [enhanced evidence](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence-enhanced_evidence). Ce paramètre est contenu dans l’objet [dispute evidence](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence). Le tableau [enhanced eligibility types](https://docs.stripe.com/api/disputes/object.md#dispute_object-enhanced_eligibility_types) contient une liste des types d’éligibilité dans [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"
          }
        ]
      }
    },
  }
  ...
}
```

## L’objet Enhanced eligibility

L’objet [enhanced eligibility](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence_details-enhanced_eligibility) indique l’état de votre soumission par le biais de la procédure Visa CE 3.0. Il fait partie de l’objet [Evidence Details](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence_details) et fournit des informations détaillées sur les étapes à suivre pour s’assurer que les preuves sont soumises à Visa dans le cadre du programme Compelling Evidence 3.0.

```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"
}
```

## Preuves remplies automatiquement

Lorsque Stripe identifie une transaction contestée comme éligible à la procédure Visa CE 3.0, Stripe tente de remplir automatiquement la transaction contestée et les preuves relatives aux transactions passées non contestées. Vous pouvez également ajouter manuellement des preuves Visa CE 3.0 si vous pensez que la transaction contestée est éligible.

> Stripe doit avoir traité toutes les transactions passées non contestées.

## Cycle de vie d’une soumission de preuves

L’[état](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence_details-enhanced_eligibility-visa_compelling_evidence_3-status) Visa CE 3.0 passe à `qualified` ou `requires_action` lorsqu’un litige contient l’objet [Visa Compelling Evidence 3](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence-enhanced_evidence-visa_compelling_evidence_3) dans l’objet [enhanced evidence](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence-enhanced_evidence).

- Si l’état est défini sur `requires_action`, utilisez le tableau [required_actions](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence_details-enhanced_eligibility-visa_compelling_evidence_3-required_actions) pour connaître les preuves supplémentaires nécessaires.
- Si l’état est défini sur `qualified`, vous pouvez soumettre une preuve Visa CE 3.0.

Vous pouvez soumettre des preuves via l’API [Update Dispute](https://docs.stripe.com/api.md#update_dispute). Pour mettre à jour des preuves sans les envoyer, veillez à définir le paramètre [submit](https://docs.stripe.com/api/disputes/update.md#update_dispute-submit) sur `false`.

Après la soumission des preuves, l’état passe à `not_qualified` si les preuves ne sont pas admissibles pour la procédure Visa CE 3.0. Les preuves sont tout de même envoyées, mais pas par l’intermédiaire de cette procédure.

Si vous avez soumis des preuves admissibles, suivez l’état du litige dans le champ [état du litige](https://docs.stripe.com/api/disputes/object.md#dispute_object-status) pour savoir si vous l’avez remporté ou perdu.

> Pour augmenter vos chances de remporter un litige, remplissez l’objet [Dispute Evidence](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence) (et pas seulement l’objet [Enhanced Evidence](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence-enhanced_evidence)). Ces preuves seront utilisées si votre soumission via la procédure Visa CE 3.0 est refusée et votre litige sera soumis via la procédure de soumission de preuves standard.

## Tests

Pour tester l’intégration Visa CE 3.0, utilisez la carte bancaire suivante, qui crée un litige éligible à la procédure Visa CE 3.0 :

| Méthode de test          | Token                              |
| ------------------------ | ---------------------------------- |
| Numéro de carte bancaire | 4000000404000038                   |
| PaymentMethod            | `pm_card_createCe3EligibleDispute` |
| Token                    | `tok_createCe3EligibleDispute`     |

Lorsque vous fournissez des preuves pour ce litige, vous pouvez soumettre deux transactions de l’environnement de test dans le champ [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).

> Dans les environnements de test, vous pouvez utiliser deux transactions de test pour `prior_undisputed_transactions`. Pendant le test, Stripe ne valide pas le moyen de paiement ou la date des transactions précédentes.

Nous validons les éléments de preuve primaires et secondaires conformément aux règles Visa CE 3.0.

L’[état Visa CE 3.0](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence_details-enhanced_eligibility-visa_compelling_evidence_3-status) devient `qualified` ou `requires_action` selon la preuve fournie.

Après l’envoi des preuves, l’[état Visa CE 3.0](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence_details-enhanced_eligibility-visa_compelling_evidence_3-status) prend la valeur suivante :

- `not_qualified` : la preuve ne remplit pas les conditions requises pour la procédure Visa CE 3.0.
- `qualified` : la preuve remplit les conditions requises pour la procédure Visa CE 3.0.

> L’[état Visa CE 3.0](https://docs.stripe.com/api/disputes/object.md#dispute_object-evidence_details-enhanced_eligibility-visa_compelling_evidence_3-status) n’a pas d’incidence sur l’[état du litige](https://docs.stripe.com/api/disputes/object.md#dispute_object-status).
> 
> Afin de simuler un état `won` ou `lost` pour l’ensemble du litige, définissez [uncategorized_text](https://docs.stripe.com/api/disputes/update.md#update_dispute-evidence-uncategorized_text) sur `winning_evidence` ou `losing_evidence` comme indiqué sur la page [Tests](https://docs.stripe.com/testing.md?testing-method=card-numbers#evidence).