Litige de paiement : préparer le dossier avec l'IA
Pour préparer un dossier de litige de paiement avec un agent IA, on le déclenche à la réception de l'alerte du prestataire de paiement. Il retrouve la commande dans Sylius, rassemble la preuve de livraison, les échanges avec le client et les conditions de vente acceptées, puis rédige une réponse adaptée au motif du litige. Vous relisez et vous soumettez. L'agent n'envoie jamais rien lui-même, parce qu'une réponse de litige ne se rattrape pas.
Je suis développeur Sylius et Symfony indépendant, et j'intègre des agents IA dans des boutiques en ligne. Les litiges de paiement, ou rétrofacturations, sont rares mais redoutés : ils tombent sans prévenir, le délai est court, et rassembler les pièces prend du temps. C'est un bon terrain pour un agent, à condition de bien poser ses limites. La page agents IA pour Sylius présente l'ensemble de l'approche.
Pourquoi un litige de paiement coûte-t-il autant de temps ?
Quand un client conteste un paiement auprès de sa banque, la boutique doit prouver que la vente était légitime et conforme. La documentation de Stripe sur les litiges est claire sur trois points. Le délai de réponse est limité, généralement de 7 à 21 jours selon le réseau de cartes, et sans réponse le litige est perdu. La réponse ne peut être envoyée qu'une fois : on ne peut plus la modifier ni ajouter de fichier. Et les banques n'examinent pas le contenu externe : un lien vers le suivi du colis ne compte pas, il faut joindre la pièce.
Concrètement, il faut retrouver la commande, vérifier l'adresse, récupérer le suivi du transporteur, relire les messages échangés avec le client, retrouver la version des conditions de vente en vigueur ce jour-là, puis tout mettre en forme selon le motif invoqué. Dans une petite équipe, c'est une demi-journée qui tombe toujours au mauvais moment.
Que rassemble l'agent dans Sylius ?
L'alerte arrive par un événement du prestataire, chez Stripe charge.dispute.created. Le code retrouve le paiement correspondant dans Sylius, puis la commande. L'agent reçoit alors un dossier limité à ce client et à cette commande, jamais l'accès au reste de la boutique.
| Pièce | Où l'agent la trouve | Utile surtout pour |
|---|---|---|
| Détail de la commande | Commande Sylius : articles, variantes, montants, canal | Tous les motifs |
| Adresse et client | Adresses de facturation et de livraison, compte client, commandes passées | Fraude, achat non reconnu |
| Preuve d'expédition | Expédition Sylius, numéro de suivi, événements du transporteur | Produit non reçu |
| Échanges avec le client | Boîte de contact, dossiers de service client | Produit non conforme, remboursement contesté |
| Conditions de vente | Version des CGV et de la politique de retour à la date de commande | Rétractation, remboursement |
Le motif du litige, fourni par le prestataire, guide la rédaction. Un « produit non reçu » appelle la preuve de livraison ; un « produit non conforme » appelle la description du produit au moment de l'achat et les échanges qui ont suivi ; une fraude appelle l'historique du client. L'agent rédige un exposé court et factuel, et chaque affirmation renvoie à la pièce qui la prouve. Pour que ces pièces soient les bonnes, les CGV et la politique de retour sont fournies comme documents de référence, avec leur date de version.
Et si un agent le faisait pour vous ?
Laissez votre numéro : je vous rappelle sous 24 heures ouvrées et je regarde avec vous ce qu'un agent peut prendre en charge dans votre boutique, dans votre budget.
Ce que l'agent ne fait jamais seul
L'agent ne soumet pas le dossier, n'accepte pas le litige, ne rembourse pas le client et ne lui écrit pas. Il n'a aucun outil pour le faire : ses seuls outils sont des lectures et la création d'un brouillon. Le choix de contester ou d'accepter vous revient, et l'agent se contente de donner un avis argumenté, par exemple quand aucune preuve de livraison n'existe et que la contestation semble perdue d'avance.
C'est le même principe que sur l'agent de service client que je construis en ce moment pour une boutique sous Sylius 2 : il prépare des brouillons et des actions en attente de validation, mais il n'envoie jamais de mail et ne rembourse jamais. Ces interdits sont dans le code, pas dans une consigne qu'on pourrait faire oublier. Pour approfondir ce choix, lisez l'article sur l'autonomie et la validation humaine.
Comment éviter les erreurs dans un dossier sans seconde chance ?
Trois précautions. D'abord, le code vérifie la cohérence avant de vous présenter le dossier : le montant contesté correspond à la commande, le numéro de suivi correspond à l'expédition, la date des CGV précède la commande. Ensuite, l'agent ne cite que ce qu'il a lu : un garde-fou rejette tout exposé qui mentionnerait une pièce absente du dossier. Enfin, chaque dossier préparé est tracé, avec les pièces lues, la version des règles et le modèle utilisé, ce qui permet de comparer plus tard les dossiers gagnés et perdus.
Je rejoue aussi d'anciens litiges, anonymisés, avant chaque changement de modèle ou de consigne, pour vérifier que l'agent rassemble toujours les mêmes pièces. C'est la couche des tests, détaillée dans l'article sur les cas de référence.
Et en amont du litige ?
Le meilleur litige est celui qui n'arrive pas. Une partie vient de commandes frauduleuses qu'on aurait pu repérer avant l'expédition : c'est le sujet de l'article sur les commandes suspectes. Une autre vient de colis réellement perdus, qu'un service client réactif règle avant que le client n'appelle sa banque : voyez l'article sur les colis non reçus.
Pour savoir si un agent de préparation des litiges se justifie chez vous, ou si un simple rappel suffit, je propose un diagnostic IA offert : je vous rappelle sous 24 heures ouvrées, je regarde votre prestataire de paiement et vos litiges récents, et je vous propose une solution qui rentre dans votre budget.