Payment Retries recharge automatiquement les paiements de renouvellement d’abonnement échoués selon un calendrier à intervalles croissants. Lorsqu’une nouvelle tentative réussit, l’abonnement revient à
active, sans action du client ni travail d’intégration.Que sont les réessais de paiement ?
Lorsqu’un paiement de renouvellement d’abonnement échoue, l’abonnement passe àon_hold, ou à past_due si vous définissez une période de grâce. Lorsque Payment Retries est activé, Dodo Payments débite à nouveau le moyen de paiement enregistré du client selon un calendrier, jusqu’à ce qu’un débit réussisse ou que la fenêtre de récupération se ferme.
Les nouvelles tentatives récupèrent les revenus perdus à cause d’échecs temporaires, comme une retenue temporaire sur la carte, des fonds insuffisants que le client approvisionne ultérieurement, ou une erreur réseau transitoire. Le client ne reçoit aucun e-mail et n’a rien à modifier.
Payment Retries s’applique uniquement aux paiements de renouvellement d’abonnement. Le premier paiement d’un abonnement (configuration du mandat), les paiements ponctuels, les frais liés à un changement de plan et les frais à la demande ne font pas l’objet de nouvelles tentatives.
Fonctionnement des réessais de paiement
1
Renewal fails
Un paiement de renouvellement d’abonnement échoue et l’abonnement passe à
on_hold, ou à past_due pendant une période de grâce.2
Retryability check
Dodo Payments vérifie le code d’erreur de l’échec. Les soft declines, comme des fonds insuffisants, un refus générique ou une erreur de traitement ou de réseau, peuvent faire l’objet d’une nouvelle tentative. Les hard declines mettent fin à la chaîne de nouvelles tentatives, car une autre tentative ne modifierait pas le résultat. Un échec sans code d’erreur est considéré comme un hard decline.
3
Scheduled retry
Si le refus peut faire l’objet d’une nouvelle tentative et que la prochaine tentative tient dans la fenêtre de récupération, Dodo Payments la planifie. Chaque nouvelle tentative est un débit off-session effectué sur le moyen de paiement enregistré du client, et chaque délai est calculé à partir de l’échec précédent.
4
Recovery
Lors de la première nouvelle tentative réussie, l’abonnement revient à
active et la prochaine date de facturation est reportée à une période de facturation après la nouvelle tentative réussie. Si la fenêtre se ferme avant la réussite d’une nouvelle tentative, les tentatives s’arrêtent et l’abonnement conserve son statut, tel que on_hold.Configuration des réessais de paiement
Activez et configurez Payment Retries dans Settings → Recovery de votre tableau de bord.
Payment Retries settings under Settings → Recovery
La fenêtre de récupération commence à la création de la facture correspondant au renouvellement échoué. Dodo Payments planifie une tentative uniquement si la somme de tous les délais jusqu’à cette tentative tient dans la fenêtre, et uniquement tant que la fenêtre est ouverte.
Calendrier des nouvelles tentatives
Les délais entre les tentatives augmentent progressivement. Dodo Payments effectue jusqu’à 8 tentatives, à condition que chacune d’elles tienne dans votre fenêtre de récupération :Transitions de statut de l’abonnement
Les nouvelles tentatives font passer l’abonnement entre les statuts suivants :Lorsqu’un abonnement est annulé, sa chaîne de nouvelles tentatives prend fin et aucune autre tentative n’est effectuée. Tous les autres statuts (
on_hold, past_due, expired, pending, failed) continuent de faire l’objet de nouvelles tentatives, car la facture de renouvellement ouverte correspond à une dette pour une période déjà utilisée par le client. Les nouvelles tentatives s’arrêtent également lorsque la facture est payée autrement, par exemple après la mise à jour du moyen de paiement par le client, ou lorsque vous ajoutez le client à votre blocklist.Subscription Webhook Payloads
Consultez les schémas complets des payloads webhook pour les événements du cycle de vie de l’abonnement.
Échecs pouvant ou non faire l’objet de nouvelles tentatives
Le code d’erreur de l’échec le plus récent détermine si la chaîne continue :Réessayer après un hard decline ne modifiera pas le résultat : la chaîne prend donc fin dès qu’un hard decline survient. Associez Payment Retries à Subscription Dunning pour demander au client un nouveau moyen de paiement dans ces cas. Pour connaître le type de chaque code, consultez Transaction Failures.
Nouvelles tentatives à la demande
Vous n’avez pas besoin d’attendre la prochaine tentative planifiée. Lorsqu’un abonnement eston_hold, vous pouvez envoyer une nouvelle tentative depuis la page de détails du paiement échoué dans le tableau de bord, ou avec POST /payments/{payment_id}/retry. Les nouvelles tentatives manuelles s’exécutent indépendamment du calendrier : elles ne consomment ni ne déplacent une tentative automatique et fonctionnent même lorsque Payment Retries est désactivé. Consultez Manual Payment Retry.
Payment Retries et Dunning
Payment Retries et Subscription Dunning récupèrent différents types d’échecs :
Activez les deux pour une couverture maximale : les nouvelles tentatives automatiques interceptent les échecs transitoires et le dunning récupère les clients dont le moyen de paiement doit être remplacé.
Associés
Manual Payment Retry
Envoyez immédiatement une nouvelle tentative au lieu d’attendre la prochaine tentative planifiée.
Subscription Dunning
Séquences d’e-mails demandant aux clients de mettre à jour leur moyen de paiement.
Abandoned Cart Recovery
Récupérez les checkouts abandonnés ou échoués grâce à des e-mails de récupération.
Subscriptions
Les états d’abonnement entre lesquels les flux de récupération évoluent.
Subscription Webhooks
Réagissez aux événements
subscription.on_hold et subscription.active.