Suivre les litiges
Consulter vos litiges et les suivre par leurs webhooks.
Consulter les litiges
Récupérer un litige le renvoie avec sa transaction, son client et son fil de messages complet.
https://api.wajub.com/disputes/{id}https://api.wajub.com/disputes| Paramètre de requête | Valeurs acceptées |
|---|---|
per_page | De 1 à 100, 25 par défaut |
status | open, under_review, won, lost |
search | Texte libre sur l'id, le motif et la description du litige |
date_from, date_to | Dates, date_to pas antérieure à date_from |
cursor | Passe à la pagination par curseur |
Au-delà des champs évidents, un litige porte la description du payeur, votre
merchant_response, les justificatifs que vous avez déposés dans evidence, resolved_at une
fois terminé, et metadata.
Comment due_date est fixé
Chaque litige porte due_date, l'échéance avant laquelle répondre. Sur un litige ouvert depuis
Pocket, c'est sept jours après l'ouverture. Sur une rétrofacturation, c'est l'échéance du
prestataire quand il en envoie une, sept jours après l'ouverture sinon. Passé son échéance, un
litige Pocket reste ouvert jusqu'à ce que Wajub tranche.
Webhooks
Sept événements, et ceux qui méritent une action sont les issues, plus le rappel.
| Événement | Déclenché quand |
|---|---|
dispute.created | Un litige a été ouvert, par un payeur ou à partir d'une rétrofacturation. Lisez-le et décidez comment répondre |
dispute.updated | Un champ a changé, y compris à chaque changement de statut |
dispute.won | Résolu en votre faveur, rien ne quitte votre solde |
dispute.lost | Résolu contre vous, le montant est débité |
dispute.closed | Envoyé avec dispute.lost. Un litige gagné ne l'envoie pas |
dispute.deadline_approaching | L'échéance est dans deux jours et le litige est encore open ou under_review. Envoyé une seule fois, avec metadata.reminded_at renseigné ; répondez maintenant |
dispute.deleted | L'enregistrement du litige a été supprimé |
dispute.deadline_approaching est envoyé en live comme en sandbox, pour chaque litige qui a une
due_date : litiges Pocket et rétrofacturations à l'identique. L'écriture de metadata.reminded_at
sur le litige envoie aussi un dispute.updated à côté.
Une perte vous envoie trois webhooks
Le passage en lost émet dispute.updated, dispute.lost et dispute.closed, dans cet ordre,
pour le même événement. Choisissez-en un pour agir, dispute.lost, et laissez passer les deux
autres. Agir aussi sur dispute.closed débitera deux fois votre propre comptabilité.
dispute.createdévénementDédupliquez sur X-Wajub-Delivery-Id, comme partout ailleurs. L'enregistrement et la vérification
de signature sont décrits dans Webhooks.