Répondre aux litiges en utilisant l'API

Vous pouvez répondre aux litiges sur le Dashboard Stripe. Nous vous guiderons pas à pas pour soumettre des preuves optimales pour chaque motif de litige.

Vous pouvez également gérer les litiges de manière programmatique à l’aide de l’API. Avec l’API, vous pouvez soumettre des preuves, répondre aux litiges et recevoir des événements relatifs aux litiges à l’aide de webhooks.

Récupérer un litige

Pour plus d’informations sur un litige, récupérez un objet Dispute :

curl https://api.stripe.com/v1/disputes/
{{DISPUTE_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

La réponse contient des informations à propos du litige ainsi que toute réponse ou preuve qui a déjà été fournie.

{
  object: "dispute"
  id: "{{DISPUTE_ID}}",
  charge: "ch_5Q4BjL06oPWwho",
  evidence: {
    customer_name: "Jane Austen",
    customer_purchase_ip: "127.0.0.1",
    product_description: "Widget ABC, color: red",
    shipping_tracking_number: "Z01234567890",
    uncategorized_text: "Additional notes and comments",
  },
  evidence_details: {
    due_by: 1403047735,
    submission_count: 1
  }
  ...
}

Mettre à jour un litige

Vous mettez à jour l’objet Dispute et passez les preuves structurées avec le paramètre evidence.

curl https://api.stripe.com/v1/disputes/
{{DISPUTE_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  --data-urlencode "evidence[customer_email_address]"="email@example.com" \
  -d "evidence[shipping_date]"=2024-02-01 \
  -d "evidence[shipping_documentation]"=
{{FILE_ID}}

Pour afficher tous les champs disponibles pour le paramètre de preuve, voir Preuves du litige. Vous pouvez fournir deux types de preuves, selon le champ que vous mettez à jour :

• Preuves textuelles, telles que customer_email et service_date. Ces preuves se composent d’une chaîne de texte.
• Preuves sur fichier, telles que service_documentationet customer_communication. Elles sont constituées d’un ID d’objet file_upload.

Vous pouvez fournir des documents ou des images (par exemple, un contrat ou une capture d’écran) comme preuve du litige en utilisant l’API de chargement de fichier. Vous devez d’abord charger un document avec le motif dispute_evidence, ce qui génère un objet File_upload que vous pouvez utiliser pour soumettre une preuve. Assurez-vous que le fichier respecte les recommandations de Stripe avant de le charger dans le cadre de la soumission d’une preuve.

Si vous souhaitez soumettre un seul fichier ou une grande quantité de texte brut comme preuve, utilisez uncategorized_text ou uncategorized_file. Cependant, remplissez le plus de champs possible pour maximiser vos chances d’infirmer le litige.

Plusieurs litiges sur un seul paiement

Bien que ce ne soit pas habituel, il est possible qu’un client conteste le même paiement plus d’une fois. Par exemple, un client peut contester le paiement de l’un des articles de sa commande s’il a été endommagé lors de la livraison, puis déposer un second litige concernant un autre article de la même commande parce qu’il ne fonctionne pas correctement.

Stripe attribue un identifiant unique à tous les litiges, qu’ils soient ou non liés à un seul paiement. Lorsque vous répertoriez les litiges, vous pouvez filtrer les résultats pour n’afficher que les litiges relatifs à un paiement donné en indiquant l’id du PaymentIntent ou du Charge et en appliquant le filtre payment_intent ou charge.

curl -G https://api.stripe.com/v1/disputes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d payment_intent={{PAYMENT_INTENT_ID}}

Lorsqu’un paiement fait l’objet de plusieurs litiges, utilisez l’id fourni pour chaque litige de la liste pour vous assurer que vous répondez au bon litige. pour ce faire, indiquez son id lorsque vous récupérez ou mettez à jour le litige.