Sign inGet Started
Commencer
Guides
Référence API
SDK
CLI
Base de connaissances
Changelog

Facturation et consommation

La facturation est rattachée à l'organisation : vos forfaits produits, 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 vos forfaits affectent les limites opérationnelles. 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 forfait. 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 forfaits, 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 forfaits 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

Chaque produit a son propre forfait, choisi indépendamment : une organisation peut détenir en même temps un forfait SMS payant, un forfait Realtime et le forfait Email Free, tout en laissant Voice en paiement à l'usage. Chaque forfait porte un niveau (par exemple free, startup, growth ou scale) et adopte l'un de deux comportements financiers. Un forfait de financement ajoute un dépôt mensuel au portefeuille partagé et facture la consommation dès le premier envoi ; un forfait de capacité achète une consommation incluse et n'ajoute rien au portefeuille. Forfaits et tarification explique les deux, et la page Billing overview liste les forfaits actuels de votre organisation.

C'est le forfait qui détermine les limites opérationnelles de votre intégration :

  • Les limites de débit augmentent avec le niveau. Chaque forfait définit des valeurs pour les politiques de son produit, comme sms_send ou whatsapp_send, et les niveaux supérieurs définissent des valeurs plus élevées. Sans forfait, la valeur par défaut de la politique s'applique. Un remplacement actif au niveau de l'organisation prend le pas sur tous les forfaits. Consultez comment votre limite est déterminée.
  • Les quotas augmentent avec le niveau. Les forfaits définissent des nombres comme les appels Voice simultanés, les connexions Realtime, les domaines d'envoi, les IP dédiées et les endpoints de webhook. Lorsqu'un quota est atteint, la nouvelle ressource, le nouvel appel ou la nouvelle connexion est refusé avec une erreur spécifique, distincte d'une réponse de limitation du débit 429.
  • Les volumes inclus s'arrêtent aux limites du forfait. Le forfait Email Free s'arrête à ses plafonds mensuel et journalier, et un forfait Realtime s'arrête à ses limites de connexions et de messages journaliers. Les forfaits Email payants n'ont aucun volume inclus : chaque envoi est débité du portefeuille.

Pour lire sans authentification les valeurs publiées de n'importe quel forfait, listez le catalogue de forfaits avec bird billing plans list --commercial-product sms. Chaque forfait renvoie ses financial_behavior, rate_limits et quotas. Le tableau comparatif de la page de tarification de chaque produit affiche ces valeurs à côté des valeurs par défaut du paiement à l'usage : comparez-les à cet endroit avant de passer à un forfait supérieur pour gagner en capacité.

Une mise à niveau s'applique dès que son paiement aboutit : les nouvelles limites arrivent en cours de période, sans changement de date de renouvellement. Les rétrogradations et les résiliations prennent effet à la fin de la période en cours, et un renouvellement impayé ramène le produit à son forfait gratuit ou aux limites du paiement à l'usage. Consultez Changements de forfait et renouvellements pour les règles de calendrier. Concevez vos intégrations pour gérer les erreurs de limite lorsqu'un forfait change ou qu'un volume inclus est épuisé.

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 décomptent la consommation sur le volume inclus d'un forfait (envois d'e-mails sur le forfait Email Free ou sur un ancien forfait Email). La page indique quelle part du volume vous avez consommée et, sur un ancien forfait avec dépassement, de combien vous l'avez dépassé.
  • Les produits à l'usage sont facturés par utilisation selon une grille tarifaire (SMS, WhatsApp, Voice et l'e-mail sur un forfait Email payant), au tarif du forfait lorsqu'il en existe un. 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.

La page Usage dans le tableau de bord Bird : dépenses totales avec projection, nombre d'envois par canal et graphiques de consommation quotidienne

Le portefeuille

Chaque organisation dispose d'un portefeuille : un solde prépayé partagé par lequel transitent les débits de consommation. Les envois à l'usage, les abonnements complémentaires et les renouvellements des anciens forfaits Email débitent le portefeuille. Les forfaits de financement l'alimentent : chaque dépôt mensuel payé est ajouté en totalité et peut payer n'importe quel produit. Une carte enregistrée l'alimente aussi par des rechargements et le rechargement automatique, et paie directement les renouvellements de forfait. 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 : les frais des forfaits de capacité, les montants et dépassements des anciens forfaits, et les dépenses à l'usage de la période. Le dépôt d'un forfait d'approvisionnement est un rechargement du portefeuille avec son propre reçu ; la consommation qu'il finance apparaît sur la facture. 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