Facturation · Guides de recettes
Facturer chaque échéance d'un abonnement
Rattacher un modèle de facture à un abonnement, et comprendre quand le document est émis.
1. Créer le modèle de facture
Le modèle porte tout le CONTENU du document : destinataire, lignes, régime de taxe, mentions. Chaque échéance en produira une facture à l'identique, avec son propre numéro.
Créez-le depuis votre espace Facturation, en facture récurrente. Son total toutes taxes comprises, remise globale déduite, doit être ÉGAL au montant prélevé par l'abonnement, et dans la même devise.
Les deux montants doivent être égaux, et le rattachement le vérifie
Un modèle plus cher que l'abonnement produirait une facture partiellement payée : votre client serait relancé pour un reliquat alors que son prélèvement a réussi. Un modèle moins cher solderait le document en laissant une part de l'encaissement sans justificatif. Le rattachement refuse donc l'écart, et une facture émise ne se corrige que par une rectification ou un avoir.
2. Rattacher le modèle à l'abonnement
Depuis votre espace marchand, ouvrez Abonnements, puis « Rattacher un modèle de facture » sur la ligne concernée. La fenêtre montre le total de chacun de vos modèles face au montant prélevé ; ceux qui ne concordent pas sont affichés, avec leur écart, mais ne peuvent pas être choisis.
Par l'API, recurringInvoiceId s'accepte à la création de l'abonnement comme sur un abonnement existant. Le modèle doit vous appartenir, être vivant, se trouver dans le même environnement que l'abonnement, et facturer exactement le montant prélevé. À défaut, la réponse est un 409 INVOICE_TEMPLATE_MISMATCH qui indique les deux montants.
Changer ensuite le montant de l'abonnement est soumis au même contrôle : un abonnement raccordé ne peut pas s'écarter de son modèle sans que vous le sachiez.
{
"recurringInvoiceId": "rin_..."
}Le modèle rattaché n'est plus émis par le calendrier des factures récurrentes
Un modèle piloté par un abonnement sort du passage ordinaire : sans cela, une échéance produirait deux factures et consommerait deux numéros, ce qui est irréversible. C'est l'abonnement qui commande, et lui seul.
3. Comprendre QUAND la facture est émise
C'est le point qui surprend, et c'est une règle de fond : une échéance ne parle au client qu'une seule fois.
Prélèvement réussi : la facture est émise et immédiatement soldée. Le règlement a précédé le document, ce qui est l'ordre normal d'un abonnement, et aucune relance ne peut partir puisqu'une facture payée ne se relance pas.
Tentatives épuisées : la facture est émise et reste OUVERTE. La cadence de relance de votre module Facturation prend alors le relais, avec son lien de règlement.
Entre les deux, tant qu'il reste des tentatives : RIEN n'est émis. On ne réclame pas par écrit une somme qu'on va prélever soi-même dans deux jours.
N'attendez pas de facture au moment du refus
Un refus de carte n'émet aucun document. Si votre comptabilité attend une facture à chaque échéance ouverte, elle en manquera une à chaque incident, jusqu'à ce que le sort de l'échéance soit tranché.
4. Retrouver la facture d'une échéance
L'échéance porte l'identifiant de la facture qu'elle a produite. Le PDF se télécharge par le chemin habituel du module Facturation ; il est engendré à la demande, jamais stocké.
Une échéance déjà facturée ne l'est jamais deux fois, même si le prélèvement est rejoué : un numéro de facture est consommé pour toujours.
5. Et sans le module Facturation
L'abonnement fonctionne seul. Sans modèle rattaché, la carte est prélevée et aucun document n'est émis : c'est le cas d'un marchand qui n'a pas souscrit au module, et ce n'est pas une erreur.
Vous pouvez détacher le modèle à tout moment en passant recurringInvoiceId à null : les prélèvements continuent, l'émission s'arrête.
6. Si l'émission échoue
Une facture qui ne s'émet pas ne défait jamais un prélèvement réussi : l'argent est encaissé, le document se rattrape. L'échec est journalisé de notre côté, et l'échéance reste marquée payée.