Facturation et consommation
La facturation est rattachée à l'organisation : votre forfait, votre portefeuille et votre flux de factures appartiennent à l'organisation. Cette page explique comment la facturation influence une intégration : comment la consommation est mesurée, comment lire l'état actuel et comment le niveau de votre forfait détermine les limites opérationnelles auxquelles votre intégration est soumise. Pour les opérations de compte (détails tarifaires, moyens de paiement, taxes), consultez la base de connaissances : Forfaits et tarification et Consommation, dépenses et factures.
La facturation est gérée par des personnes, pas par des intégrations. Chaque opération de facturation est contrôlée par le scope org:billing, un scope de rôle organisationnel qui ne peut pas être accordé à une clé API d'espace de travail ; aucune clé bk_* ne peut donc consulter la consommation, recharger le portefeuille ou changer de plan. Les propriétaires et les administrateurs de facturation effectuent ces opérations dans la section Billing and payments du tableau de bord ; consultez Utilisateurs, équipes et rôles pour savoir qui détient le rôle. Les catalogues de plans, produits et tarifs font exception : ils ne nécessitent aucune authentification, publient les prix sur ce site, et les CLI et MCP peuvent lire le catalogue de plans directement. Ce guide explique donc ce que la facturation fait à votre intégration, et nomme la page du tableau de bord qui affiche chaque chiffre. Ces pages (Overview, Usage, Invoices, Spend et Settings) sont couvertes dans les articles de la base de connaissances référencés tout au long du texte.
Forfaits et niveaux
Votre organisation souscrit à un seul plan. Votre abonnement actuel, les mises à niveau et l'annulation se trouvent sur la page Billing overview. Chaque plan porte un palier (free, startup, growth ou enterprise), et c'est le palier que votre intégration ressent opérationnellement :
- Volume d'envoi inclus. Chaque forfait inclut un quota mensuel d'envois d'e-mails, mesuré par destinataire : un message à trois destinataires en consomme trois. Sur les forfaits payants, les envois au-delà du quota sont comptés comme dépassement jusqu'à un plafond strict ; au-delà du plafond, les envois sont rejetés avec une erreur de limite jusqu'à la réinitialisation de la période. Le forfait Free n'a aucun dépassement : il s'arrête à ses quotas mensuel et journalier. Les quotas, plafonds et le plafond de dépassement figurent dans Forfaits et tarification.
- Les plafonds de limitation du débit évoluent avec le forfait. Les limites de débit partent d'une valeur de base, votre forfait la remplace par une valeur supérieure, et un remplacement par organisation remplace les deux, de sorte que les forfaits supérieurs relèvent les plafonds d'envoi et de lecture. Le modèle, le débit de base de chaque groupe et les en-têtes sont décrits dans Limites de débit.
- Limites de ressources. Les plafonds, comme le nombre de domaines d'envoi, de pools d'IP et d'IP dédiées que votre organisation peut détenir, sont définis par forfait et ajustables par organisation. Si vous en atteignez un, contactez le support plutôt que de le contourner.
Les mises à niveau s'appliquent immédiatement, rendant le nouveau quota complet disponible pour le reste de la période en cours. Les rétrogradations et les résiliations prennent effet à la fin de la période de facturation en cours. Consultez Changements de forfait et renouvellements pour la séquence en cas d'échec de paiement et les autres règles de calendrier. Concevez vos intégrations pour gérer les erreurs lorsqu'un compte dépasse son quota.
Mesure de la consommation
Chaque envoi est comptabilisé sur la période de facturation en cours de votre organisation. La page Usage du tableau de bord affiche la situation en temps réel pour chaque produit, sur la fenêtre de mesure propre à ce produit : la période du plan pour l'e-mail mesuré, le mois calendaire pour le paiement à l'usage. Les produits sont facturés de deux manières, et la différence est ce que votre intégration ressent :
- Les produits mesurés disposent d'un volume inclus dans votre plan (envois d'e-mails). La page indique quelle part du volume vous avez consommée et de combien vous l'avez dépassé, pour que vous puissiez voir un dépassement se former avant qu'il ne soit facturé.
- Les produits à l'usage sont facturés par utilisation selon une grille tarifaire (SMS, WhatsApp). Un message peut débiter le portefeuille deux fois : les frais propres de Bird au traitement de l'envoi, et des frais tiers (une surtaxe opérateur sur SMS, la part de Meta sur WhatsApp) à la livraison du message. Lisez la ventilation par message depuis cost sur le message SMS ou WhatsApp : transaction_amount correspond aux frais de Bird et passthrough_amount aux frais tiers.
La page couvre chaque produit ayant un abonnement ou une consommation sur la période en cours, et affiche les ventilations par jour, par pays et par domaine d'envoi pour chacun d'entre eux.
Le portefeuille
Chaque organisation dispose d'un portefeuille : un solde prépayé partagé par lequel transitent tous les débits. Les renouvellements de plan, les dépassements et les envois à l'usage débitent tous le portefeuille ; une carte enregistrée sert à le recharger (rechargements, rechargement automatique, et couverture d'un renouvellement que le solde ne peut pas payer). La page Spend du tableau de bord est le registre complet des crédits et des débits : chaque mouvement du portefeuille y est comptabilisé, et chaque rechargement encaissé produit un reçu permanent que vous pouvez télécharger en PDF depuis la même section.
En pratique, le portefeuille est une dépendance de l'envoi à l'usage : les envois SMS et WhatsApp sont rejetés lorsque le solde ne peut pas les couvrir. SMS est refusé au niveau de API avec une 402 ; un envoi WhatsApp est accepté puis rejeté lorsque Bird tente de le débiter. Des frais au moment de la livraison que le solde ne peut pas couvrir sont ignorés plutôt que rejetés : le message atteint quand même son destinataire. Pour le volume transactionnel, configurez le rechargement automatique et une alerte de solde bas sur la page Billing overview, ou surveillez et alertez de votre côté. Moyens de paiement et portefeuille couvre les deux commandes du tableau de bord. Les avertissements de solde bas et les notifications d'échec de paiement sont envoyés aux propriétaires de l'organisation. Les e-mails de facture sont envoyés à la liste de notification de facturation de l'organisation si elle est définie, et au propriétaire de l'organisation dans le cas contraire. Définissez cette liste sous Settings > Organization. Utilisez un alias d'équipe surveillé pour que les e-mails de facturation ne dépendent pas de la boîte de réception d'une seule personne.
Factures
Les factures sont émises par organisation, une par mois calendaire, et listées sur la page Invoices du tableau de bord, où vous pouvez en ouvrir une pour consulter ses lignes ou la télécharger en PDF. Les factures reflètent le même comptage que la page Usage : le montant récurrent de votre plan plus tout dépassement mesuré et les dépenses à l'usage de la période. Pour la structure des factures, les statuts et les délais de paiement, consultez Consommation, dépenses et factures dans la base de connaissances.
Étapes suivantes
- Limitation du débit : le modèle base/palier/override dans lequel votre palier s'inscrit
- Plans et tarifs : ce que chaque plan inclut, les dépassements et les tarifs à l'usage
- Changements de plan et renouvellements : calendrier des mises à niveau et annulations, et séquence en cas d'échec de paiement
- Utilisateurs, équipes et rôles : qui peut gérer la facturation (org:billing)
Ressources associées
Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.