Raisons de l'échec de la facturation

Aucun mode de paiement disponible 💳

Factures d'abonnement (récurrentes) :
Lorsqu'aucun mode de paiement n'est disponible, la facture n'échoue PAS à la première tentative.
Ce qui se passe :
1. Première tentative de traitement :
  La facture reste en EN ATTENTE
  Nous fixons l'horodatage de failed sur la facture
  Planifie la prochaine tentative en utilisant le délai par défaut
2. Poursuit les tentatives en fonction des intervalles programmés
3. Passe éventuellement en RELANCE (si le plan de relance est configuré et que la période de grâce est écoulée).
4. Finalement, l'échec n'intervient qu'à l'expiration de la relance (tous les événements de relance sont épuisés).
Factures clients ou reçu de paiement :
Ces ÉCHOUENT IMMÉDIATEMENT lorsqu'aucun mode de paiement n'est disponible.

Expiration du plan de relance ⏰

Lorsqu'une facture passe par le processus de relance et atteint le stade de la relance finale , il s'agit de la raison la plus fréquente de l'échec de la facturation.

Processus :

La facture entre dans l'état RELANCE lorsque les tentatives de paiement échouent.
Le plan de relance envoie des notifications à intervalles réguliers
Lorsque le dernier événement de relance est atteint, la relance expire
Transitions de la facture de RELANCE → ÉCHOUÉE

Transactions définitivement refusées 🚫

Lorsqu'une opération de paiement est définitivement refusée par le prestataire de services de paiement :

Pour les factures des clients et les reçus de paiement :

Échec immédiat lors d'un refus définitif

Pour les factures d'abonnement :

Première tentative de règlement avec refus définitif → échec de la facture
Ou lors du traitement ultérieur

Durée de réessai dépassée ⏱️

Pour les factures qui font l'objet d'un refus temporaire ou d'une erreur de traitement, le système relance automatiquement l'encaissement du paiement selon un plan de relance configuré. Lorsque la durée totale des tentatives est dépassée sans que le paiement ait été effectué, la facture passe à échec final.

Processus :

Lorsqu'une facture est rejetée pour la première fois à la suite d'un refus temporaire ou d'une erreur de traitement, elle entre dans un état de relance.
La durée totale des tentatives se compose de
- Période de grâce
- Calendrier des tentatives
Le système calcule le temps écoulé en additionnant tous les intervalles de calendrier
- Durée totale des tentatives = Période de grâce + Somme des intervalles de calendrier

Disons que vous avez :

Période de grâce : 1 jour
Calendrier : [3, 2, 7] jours
Date d'échéance de la facture : 1er janvier 2025

Jour	Événement	Description
Jour 1 (1er janvier)	Le paiement a échoué	Refus temporaire détecté, la relance commence
Jour 1	La période de grâce commence	Période de grâce d'un jour (peut être ignorée en cas de refus définitifs)
Jour 1	1er courriel envoyé	Notification « Paiement refusé »
Jour 4 (4 janvier)	Réessayer #1	Attendre 3 jours → Réessayer le paiement + 2ème email
Jour 6 (6 janvier)	Réessayer #2	Attendre 2 jours → Réessayer le paiement + 3ème email
Jour 13 (13 janvier)	⏱️ Durée dépassée	Attendre 7 jours → Action finale de l'abonnement (Expire ou En attente ou rien) → Échec de la facture

Échec manuel via l'API 🔧

Les factures peuvent être rejetées manuellement via le point de terminaison de l'API ou un échec forcé.

1. L'état passe à ÉCHEC

2. L'horodatage de failed est défini

3. La relance est terminée

4. Le traitement suivant est annulé (pas de tentatives automatiques)

5. L'événement webhook INVOICE_FAILED est déclenché

6. Mise à jour de l'état des abonnements et des clients

Note
Les factures échouées ne sont pas automatiquement retentées lorsque de nouveaux modes de paiement sont ajoutés - elles doivent être réglées manuellement via la commande /settle de l'API.