Pourquoi les prélèvements SEPA échouent sur Mollie
Les codes motif SEPA derrière les prélèvements Mollie échoués, où les lire dans l’API, ceux que Mollie retente ou annule, et que faire pour chacun.
Un prélèvement SEPA sur Mollie n’échoue pas comme une carte. Il n’y a pas de refus instantané : la banque répond plus tard, avec un code court tiré du rulebook SEPA, comme AM04 ou MD06. Ce code est l’information la plus utile que vous recevez. Il vous dit si une nouvelle tentative peut marcher, si le client doit agir, et s’il a en fait demandé à être remboursé.
Ce guide passe en revue les codes motif que vous verrez sur Mollie, où les trouver dans l’API, comment les abonnements Mollie réagissent à chacun, et que faire ensuite. Il s’en tient à la documentation de Mollie : la référence Get payment (détails du prélèvement SEPA), le guide Recurring payments, le guide SEPA Direct Debit et les articles du centre d’aide de Mollie Why did my SEPA direct debit payment fail? et What is a SEPA Direct Debit chargeback? (tous consultés en novembre 2026). Quand nous avons utilisé le client API officiel de Mollie pour confirmer un champ, nous le disons. Pour une vue plus large des nouvelles tentatives, des webhooks et de la demande de nouveau paiement, voir comment gérer les paiements récurrents échoués avec Mollie.
Où se trouve le motif
Un prélèvement SEPA échoué a le statut failed. Le motif se trouve dans l’objet details du paiement. La référence Get payment de Mollie documente ces champs du prélèvement SEPA, et le client Node.js officiel de Mollie reprend les mêmes descriptions :
| Champ | Contenu |
|---|---|
details.bankReasonCode |
Seulement si le paiement a échoué : le code motif officiel. Mollie renvoie au European Payments Council pour la description complète de chaque code. |
details.bankReason |
Seulement si le paiement a échoué : une description textuelle du motif. |
details.dueDate |
La date estimée du débit sur le compte du client. |
details.signatureDate |
La date de signature du mandat par le client, quand elle est vérifiée. |
details.consumerName, consumerAccount, consumerBic |
Le titulaire du compte, l’IBAN et le BIC. |
Les webhooks classiques de Mollie n’envoient que l’ID du paiement. Votre handler récupère le paiement, voit failed et lit bankReasonCode. Stockez le code avec le paiement : vous en aurez besoin pour décider quoi faire, puis pour voir quels échecs vous récupérez.
Un remboursement (un client qui demande à sa banque de lui rendre son argent) est différent. Il apparaît comme un chargeback sur un paiement qui avait réussi, avec ses propres reason.code et reason.description, que Mollie ne remplit que pour les chargebacks de prélèvement SEPA. Nous le traitons dans les chargebacks sur Mollie.
Les codes, et ce que chacun signifie pour vous
Le centre d’aide et le guide des paiements récurrents de Mollie listent les codes qui comptent le plus. « Comportement de l’abonnement » est ce que, selon le guide des paiements récurrents, Mollie fait d’un abonnement quand un prélèvement échoue pour ce motif.
| Code | Signification | Comportement de l’abonnement | Que faire |
|---|---|---|---|
AM04 |
Provision insuffisante (les banques envoient parfois MS03 pour ce cas) |
Peut être retenté | Laissez du temps ; envoyez un rappel ; proposez un autre moyen s’il continue d’échouer |
MS03 |
Motif non précisé | Annulé après des échecs répétés | Traitez-le d’abord comme une provision insuffisante ; contactez le client s’il se répète |
AC01 |
Numéro de compte incorrect (IBAN invalide) | Annulé immédiatement | Demandez de nouvelles coordonnées de paiement |
AC04 |
Compte clôturé | Annulé immédiatement | Demandez de nouvelles coordonnées de paiement |
MD07 |
Débiteur décédé | Annulé immédiatement | Arrêtez d’encaisser ; traitez avec tact |
MD01 |
Pas de mandat | Annulé après des échecs répétés | Vérifiez le mandat ; demandez au client d’en remettre un en place |
MS02 |
Refus du débiteur | Annulé après des échecs répétés | Contactez le client : il veut peut-être arrêter |
MD06 |
Remboursement demandé par le client | Annulé après plusieurs occurrences (le guide de Mollie dit après 3 fois) | Un remboursement : voir plus bas |
Trois groupes ressortent de ce tableau :
- Problèmes d’argent (
AM04, parfoisMS03). Le compte va bien ; l’argent n’était pas là ce jour-là. Ce sont les paiements que vous pouvez récupérer en attendant et en relançant. - Problèmes de compte (
AC01,AC04,MD07). Retenter le même IBAN ne peut pas marcher. Mollie annule l’abonnement tout de suite : il vous faut un nouveau moyen de paiement et un nouvel abonnement. - Décisions du client (
MS02,MD06, souventMD01). Le client, ou sa banque en son nom, a refusé ou réclamé le prélèvement. Retenter sans lui parler est le chemin le plus court vers un second remboursement.
Deux sources, deux seuils
La documentation de Mollie n’est pas tout à fait cohérente sur les nouvelles tentatives. Le guide des paiements récurrents indique qu’un paiement d’abonnement échoué peut être retenté jusqu’à 5 fois, une fois par jour, selon le moyen de paiement et le motif de l’échec, et que l’abonnement est annulé une fois les tentatives épuisées. Un article du centre d’aide plus ancien décrit des abonnements SEPA annulés après 2 échecs, hors provision insuffisante. Nous considérons le guide développeur comme la référence la plus récente, mais testez avec votre propre compte plutôt que de vous fier à l’un ou l’autre chiffre, et surveillez le statut de l’abonnement après chaque échec.
Pourquoi les remboursements méritent un traitement à part
MD06, c’est un client qui demande à être remboursé. Le centre d’aide de Mollie indique que le client dispose de 8 semaines pour le faire et qu’une fois la demande faite, vous ne pouvez pas la contester. Entre 8 semaines et 13 mois, un client peut encore déposer un Unauthorised Direct Debit Report ; la banque vérifie alors si le mandat était valide.
Un remboursement est donc rarement un problème de paiement. Les causes courantes sont un abonnement oublié, un prélèvement que le client n’a pas reconnu, ou un client qui a voulu résilier sans trouver comment. Chacune appelle un message, pas une nouvelle tentative.
Un mode d’emploi par code
Provision insuffisante (AM04)
- Laissez tourner les propres tentatives de Mollie si l’abonnement est toujours actif.
- Envoyez un email court au premier échec : le montant, l’offre, et le fait que la banque a refusé le prélèvement à cause du solde. Ne culpabilisez pas le client.
- Ajoutez un lien pour payer tout de suite par un autre moyen. Un paiement Mollie avec
sequenceTypefirstencaisse le montant et crée un nouveau mandat en une seule étape. - Si l’abonnement finit annulé, créez-en un nouveau une fois que le client a payé.
Compte clôturé ou invalide (AC01, AC04)
- Écrivez le jour même. L’abonnement est déjà annulé : attendre ne sert à rien.
- Demandez au client de payer via un nouveau premier paiement. Il peut choisir une carte ou un autre compte.
- Créez un nouvel abonnement sur le nouveau mandat, qui commence après la période qu’il vient de payer.
Refus ou remboursement (MS02, MD06, MD01)
- Suspendez toute nouvelle tentative dans votre propre système.
- Demandez au client ce qui s’est passé, en termes simples, avec un moyen clair de résilier si c’est ce qu’il souhaite. Un client qui peut résilier facilement a moins de raisons de faire annuler un prélèvement.
- N’encaissez à nouveau qu’avec son accord, via un nouveau premier paiement.
Décès (MD07)
Arrêtez tout encaissement, mettez fin à l’accès selon vos conditions et confiez tout contact à une personne. Aucune relance automatique.
Éviter le prochain échec
- Stockez le titulaire de l’IBAN et la date du mandat depuis
details, pour que le support puisse répondre vite à « c’est quoi ce prélèvement ? ». - Utilisez une description claire. La description de l’abonnement apparaît dans celle du paiement : rendez-la reconnaissable sur un relevé bancaire.
- Prévenez avant les renouvellements annuels. Un gros prélèvement inattendu est la cause classique d’un
AM04comme d’unMD06. - Rendez la résiliation facile. Une option d’annulation visible dans votre app coûte moins cher qu’un remboursement.
Le faire avec NoChurn
L’encaissement du prélèvement, les nouvelles tentatives de Mollie et les coordonnées bancaires restent chez Mollie. NoChurn se connecte à votre compte Mollie, importe clients, mandats et abonnements, et relit chaque paiement après un webhook : il voit donc le code motif. Il envoie des emails de récupération rédigés par l’IA, que vous relisez, avec un lien pour payer à nouveau et enregistrer un nouveau moyen de paiement, et affiche les remboursements en lecture seule sur la chronologie du client et dans le churn score. Les parcours d’annulation avec un bouton d’annulation en un clic toujours visible et les emails de reconquête à J30, J60 et J90 sont inclus dans toutes les offres. Voir NoChurn + Mollie.