Fonctionnalités de Facturation Avancée — Ash-Wallet

Ash-Wallet propose un système de facturation flexible permettant de gérer des essais gratuits, des timings de paiement variés et un cycle de relance automatisé (Dunning).

---

🎁 1. Gestion des Essais (Trials)

Vous pouvez définir un plan comme étant une période d'essai unique.

• Plan d'essai unique : Un seul plan par projet peut être marqué avec isTrial: true.
• Utilisation unique : Un utilisateur final ne peut bénéficier de l'offre d'essai qu'une seule fois par projet.
• Facturation d'essai : Dès la souscription à un essai, une facture avec la mention OFFERT (ESSAI) est générée et envoyée (si activé).

---

⏳ 2. Timing de Paiement

Les plans de facturation supportent deux modes de timing :

1. Upfront (Paiement immédiat) :
   • La facture est générée dès la souscription ou au début du cycle.
   • Idéal pour les abonnements prépayés standard.
2. Postpaid (Paiement à l'échéance) :
   • L'abonnement est actif immédiatement.
   • La facture est générée à la fin de la période d'utilisation.

---

🔔 3. Relances & Sursis (Dunning)

Le système gère automatiquement les impayés via un cycle de relance configurable au niveau du projet.

• Délai de Grâce (Grace Period) : Nombre de jours (minimum 30) pendant lesquels l'accès reste maintenu après un échec de paiement.
• Fréquence de Relance (Dunning Frequency) : Intervalle de jours entre chaque e-mail de rappel de paiement (configuré par le développeur : options de 3, 7 ou 10 jours).
• Expiration : Si aucun paiement n'est effectué après le délai de grâce, l'abonnement passe au statut expired et l'accès aux APIs du projet est suspendu.

---

📧 4. Paramètres de Facturation & Personnalisation (Branding)

• Envoi Automatique : Le toggle sendInvoices dans les paramètres du projet permet d'activer ou de désactiver l'envoi automatique des e-mails contenant les factures.
• Personnalisation Graphique :
  • invoiceFooterText : Texte personnalisé affiché en bas de page de la facture PDF.
  • invoicePrimaryColor : Couleur principale au format hexadécimal utilisée sur la facture PDF.
  • invoiceLogoUrl : Logo de l'entreprise affiché sur le document PDF.

IMPORTANT

Les relances automatiques et les calculs de renouvellement dépendent du Cron Job d'arrière-plan de ash-bwallet (configuré par défaut pour s'exécuter quotidiennement à minuit).