Notions clés
Facturation
L’API se paie d’avance : chaque génération est débitée d’un solde prépayé, en euros hors taxes (prix, remboursements et validité du solde : voir Tarifs). Le solde, les recharges et les factures se gèrent dans la console, écran Facturation.
Les actions permises dépendent du rôle du membre :
| Action | Rôles |
|---|---|
| Voir le solde, le palier et la consommation du mois | Tous les membres |
| Recharger, régler la recharge automatique et le plafond mensuel, consulter les mouvements et les factures, modifier les coordonnées de facturation | Propriétaire, administrateurs, membres facturation |
Le solde est la somme des recharges et des crédits non expirés. L’onglet Mouvements liste chaque écriture (recharge, génération, remboursement, ajustement, crédit offert, expiration) avec le solde qui en résulte.
- Une recharge va de 10 € hors taxes au plafond du palier de l’organisation (colonne « Recharge max » des paliers) et se paie par carte, sur une page de paiement Stripe. Cette page demande l’adresse de facturation (raison sociale et numéro de TVA facultatifs) et ajoute la TVA applicable.
- Ces coordonnées figurent sur les factures. Pour les modifier, ouvrez l’onglet Factures, puis Coordonnées de facturation.
- Le montant est crédité dès la confirmation du paiement, et la facture apparaît dans l’onglet Factures.
- La recharge automatique ajoute le montant choisi dès que le solde passe sous un seuil, de 1 € à 5 000 €. Elle se déclenche aussi après un refus
402 insufficient_balance. - Le montant rechargé est au moins égal au seuil : après une recharge, le solde repasse au-dessus. Il ne dépasse pas le plafond d’une recharge au palier : un montant enregistré au-dessus (plafond abaissé depuis) est ramené à ce plafond.
- Elle exige une carte enregistrée lors d’une recharge. Pour changer de carte, utilisez Changer de carte, qui ouvre le portail Stripe.
- Chaque recharge automatique donne lieu à une facture.
- Si le paiement est refusé (carte refusée, adresse de facturation invalide…), la recharge automatique est désactivée et un e-mail prévient le propriétaire et les membres facturation.
- Au plus 3 recharges automatiques par période glissante de 24 heures : la suivante n’est pas lancée et la recharge automatique est désactivée. La console le signale, l’événement
balance.recharge_failedaussi. Elle se réactive une fois la plus ancienne de ces recharges passée de 24 heures.
- Le plafond, facultatif, limite la dépense d’un mois civil (UTC), de 1 € à 100 000 € hors taxes. La dépense comptée est celle des débits, moins les remboursements.
- Un e-mail prévient le propriétaire et les membres facturation à 50 %, 80 % et 100 % du plafond, une fois par seuil et par mois.
- Une génération qui dépasserait le plafond est refusée, jusqu’au mois suivant ou jusqu’au relèvement du plafond.
Une génération refusée pour une raison de facturation reçoit le statut
402 et l’un de ces codes :| Code | Cause | Action |
|---|---|---|
insufficient_balance | Le solde ne couvre pas le prix. | Rechargez, ou activez la recharge automatique. |
spend_limit_reached | La génération dépasserait le plafond mensuel. | Relevez le plafond, ou attendez le mois suivant. |
Rien n’est créé ni débité, et la même requête reçoit le même refus tant que la cause demeure. Le solde peut aussi se suivre par webhooks.
- Une organisation suspendue reçoit
403 organization_suspendedsur toutes ses requêtes, quelle que soit la clé, et ne peut plus recharger son solde. Contactez le support. - Seul le propriétaire peut supprimer l’organisation, depuis l’écran Organisation, et seulement s’il ne reste ni solde ni génération en cours.