Premiers pas avec Smart DisputesVersion bêta publique

Découvrez comment configurer Stripe Smart Disputes pour lutter automatiquement contre les litiges et améliorer vos taux de litiges remportés.

Smart Disputes compile et soumet automatiquement des dossiers de preuves de haute qualité en votre nom avant la date limite du litige. Cela vous aide à récupérer des revenus que vous pourriez autrement perdre en raison de délais expirés ou de soumissions incomplètes, tout en vous laissant le contrôle total pour examiner, modifier ou soumettre vos propres preuves.

Aucune configuration supplémentaire n’est nécessaire après avoir inscrit votre compte à Smart Disputes. Stripe crée et soumet automatiquement des dossiers de preuves lorsque suffisamment de données sont disponibles. Vous pouvez également améliorer manuellement ces dossiers afin d’optimiser les performances.

Comment fonctionne Smart Disputes

Une fois que vous avez reçu une notification vous informant d’un litige :

Stripe crée automatiquement des dossiers de preuves pour chaque litige éligible.
Vous conservez le contrôle total et vous pouvez :
- Soumettez vos propres preuves ou le paquet Smart Dispute manuellement.
- Acceptez le litige.
- Faites confiance à Smart Disputes pour soumettre automatiquement les preuves avant la date limite de litige.
- Améliorez vos chances de remporter le litige en ajoutant des preuves à votre paquet Smart Disputes.

Si vous ne prenez aucune mesure, Smart Disputes soumet automatiquement le dossier afin que vous ne manquiez pas l’occasion de contester un litige. Si vous préférez, vous pouvez intervenir manuellement en le soumettant avant la date limite ou en ajoutant des preuves supplémentaires afin d’augmenter vos chances de remporter le litige :

En cas de litige pour lequel un dossier est déjà disponible, Stripe peut recommander d’ajouter des preuves supplémentaires (par exemple, des détails sur l’exécution de la commande ou des logs de communication) afin d’augmenter vos chances de remporter les litiges. Cependant, cela n’est pas obligatoire.
Pour d’autres litiges, l’ajout des preuves recommandées peut les rendre éligibles à la soumission de Smart Disputes. Pour en savoir plus ci-dessous, consultez l’état des disponibilités.

Utiliser Smart Disputes avec l’API

Si vous gérez les litiges par voie programmatique, mettez à jour votre intégration pour tirer parti de Smart Disputes.

Méthode de soumission prévue

L’API Disputes comprend une valeur intended_submission_method pour déterminer si c’est vous ou Stripe à soumettre le preuve du litige. Consultez la rubrique Mettre à jour une API de litige pour plus d’informations.

Champ	Description
prefer_manual	Paramètre par défaut. Stripe envoie vos preuves si vous en avez ajouté. Si vous ne l’avez pas encore fait, Stripe vous envoie un paquet Smart Disputes (le cas échéant).
prefer_smart_disputes	Stripe combine vos preuves avec les preuves générées par Smart Disputes et soumet le paquet le plus solide possible. Recommandé pour maximiser les taux de litiges remportés.

Pour obtenir les meilleurs résultats, réglez la valeur intended_submission_method sur prefer_smart_disputes lors de la mise à jour d’un litige. Lorsque vous ajoutez des preuves, Stripe les fusionne avec les données générées automatiquement par Smart Disputes pour créer un paquet unique et complet.

Améliorez les performances de Smart Disputes

Smart Disputes repose sur la qualité des données. Plus Stripe dispose de données sur les transactions et les clients, plus vos dossiers de preuves sont solides.

Fournir davantage de données au moment de la facturation

Smart Disputes utilise un moteur de règles basé sur l’IA pour extraire des preuves à partir de vos données transactionnelles, des données internes de Stripe, de l’historique des performances gagnantes et des données des titulaires de carte. L’ajout de données supplémentaires lors de la création des frais aide Stripe à générer des dossiers de preuves plus complets et plus convaincants.

Collectez les signaux de fraude

Assurez-vous que votre intégration inclut stripe.js, ou utilise Radar Sessions pour envoyer des informations du navigateur à Stripe.

Si vous créez des paiements via l’API, incluez autant de champs que possible :

Objet	Champ	Description
paiement_intent, frais,client	payment_intent.customer[email], charge.billing_details[email], charge.customer[email]	Adresse e-mail du client
paiement_intent, frais,client	payment_intent.customer[phone], charge.billing_details[phone], charge.customer[phone]	Numéro de téléphone du client
paiement_intent, frais, carte	paiement_intent. client[adresse], débiter.client[adresse], débiter.facturation_details[adresse], carte bancaire[address_*]	Adresse de facturation du client
paiement_intent, frais, carte	payment_intent.customer[name], charge.billing_details[name], charge.customer[name], card[name], card.customer[name]	Nom du client
paiement_intent, paiement, produit	payment_intent.amount_details[line_items], checkout[line_items]	Fournir des postes détaillés sur chaque transaction
paiement, produit	checkout.line_items.data.price[product], product[images], product[url], product[description]	Informations sur le produit, y compris les images et les descriptions
paiement_intent, frais, client, expédition	payment_intent.shipping[address], charge.shipping[address], customer.shipping[address]	Adresse de livraison d’un produit physique
paiement_intent, frais, client, expédition	paiement_intent.shipping[tracking_number], débiter.shipping[tracking_number], client.shipping[tracking_number]	Le numéro de suivi d’un produit physique
paiement_intent, frais, client, expédition	payment_intent.shipping[carrier], charge.shipping[carrier], customer.shipping[carrier]	Le service de livraison qui a expédié un produit physique, tel que Fedex, UPS, USPS, etc.
paiement_intent, frais, client, expédition	payment_intent.shipping[phone], charge.shipping[phone], customer.shipping[phone]	Numéro de téléphone du bénéficiaire du colis
paiement_intent, frais	payment_intent[receipt_email], charge[receipt_email]	Adresse e-mail à laquelle le reçu de ce paiement a été envoyé.

La fourniture de ces données aide Stripe à établir des preuves qui confirment l’identité du titulaire de la carte et la légitimité de la transaction. Elles sont combinées à d’autres données provenant de l’ensemble du réseau Stripe.

Fournir plus de données en cas de litige

Même après la création d’un litige, vous pouvez améliorer l’efficacité de Smart Disputes en fournissant des preuves supplémentaires.

Si vous gérez les litiges via l’API, Stripe met à votre disposition deux informations qui vous aideront à comprendre et à influencer l’éligibilité aux Smart Disputes :

Champs de preuve recommandés : l’objet Dispute inclut un tableau smart_disputes.recommended_evidence qui répertorie quels champs (ou groupes de champs) renforceraient le paquet ou rendraient le litige éligible aux Smart Disputes. Ces champs sont générés dynamiquement en fonction du motif du litige et des règles du réseau.
Disponibilité (état du paquet) : le litige comprend une valeur smart_disputes.status qui indique s’il existe actuellement un paquet Smart Disputes pour le litige :

Champ	Description
disponible	Un paquet Smart Disputes est prêt et peut être soumis automatiquement.
requires_evidence	Un dossier Smart Disputes devient disponible si vous fournissez les preuves requises énumérées dans le champ `recommended_evidence`. En fournissant les champs obligatoires, le litige est déplacé vers `available`.
non disponible	Le litige n’est pas disponible pour Smart Disputes. Le fait de fournir des champs supplémentaires ne changera pas cet état.

Si smart_disputes.status n’est pasavailable et vous avez la valeur intended_submission_method définie surprefer_smart_disputes, Stripe revient à soumettre tout preuve manuelle que vous avez fournie (comme un paquet manuel) jusqu’à ce que la valeur de smart_disputes.status soitavailable.

Vous pouvez également ajouter des champs de preuve personnalisés comme vous le faites aujourd’hui à l’aide de l’endpoint Update Dispute, même s’ils ne font pas partie du tableau recommended_evidence. Assurez-vous que la valeur intended_submission_method est définie surprefer_smart_disputes.

Exemple : lecture des preuves recommandées + état

GET /v1/disputes/{dispute_id} renvoie à la fois les champs recommandés et l’état actuel du paquet :

{
  "id": "dp_123",
  "amount": 1000,
  "reason": "fraudulent",
  "smart_disputes": {
    "status": "requires_evidence",
    "recommended_evidence": [
        ["shipping_carrier", "tracking_number"],    // group — both required together
        ["customer_email"]                         // single required field
     ]
  },
}

Dans cet exemple :

L’état du litige intelligent est requires_evidence.
Fournir soit un customer_email _ou les deux éléments _shipping_carrier ettracking_number oblige Stripe à réévaluer le litige et, (si les règles définies sont satisfaites), à mettre à jour le smart_disputes.status vers available.

Exemple : définition de la valeur intended_submission_method et soumission des preuves recommandées

Dans cet exemple :

intended_submission_method est défini sur prefer_smart_disputes, sélectionnant les litiges intelligents comme option prioritaire.
Les deux champs de preuve recommandés (shipping_tracking_number etshipping_carrier) sont fournis.
La fourniture des preuves recommandées oblige Stripe à réévaluer le litige et à mettre à jour le smart_disputes.status àavailable (si les règles de portée sont satisfaites).

Après avoir soumis un litige, vous pouvez consulter la méthode de soumission via le paramètre evidence_details.submission_method de l’objet Dispute.