Facturación y uso
La facturación tiene alcance de organización: tu plan, monedero y flujo de facturas pertenecen a la organización. Esta página cubre cómo la facturación afecta una integración: cómo se mide el uso, cómo leer el estado actual y cómo el nivel de tu plan establece los límites operativos contra los que se ejecuta tu integración. Para operaciones de cuenta (detalles de precios, métodos de pago, impuestos), consulta la Base de conocimiento: Planes y precios y Uso, gasto y facturas.
La facturación la gestionan personas, no integraciones. Toda operación de facturación requiere el scope org:billing, un scope de rol de organización que no se puede otorgar a una clave API de espacio de trabajo, así que ninguna clave bk_* puede consultar el uso, recargar el wallet ni cambiar de plan. Los propietarios y administradores de facturación realizan esas tareas en la sección Billing and payments del dashboard; consulta Users, teams & roles para saber quién tiene el rol. Los catálogos de planes, productos y precios son la excepción: no requieren autenticación, publican los precios en este sitio, y CLI y MCP pueden leer el catálogo de planes directamente. Por eso, esta guía explica qué efecto tiene la facturación en tu integración e indica la página del dashboard donde se muestra cada cifra. Esas páginas (Overview, Usage, Invoices, Spend y Settings) se cubren en los artículos del Knowledge base enlazados a lo largo del texto.
Planes y niveles
Tu organización está suscrita a un plan. La suscripción actual, las mejoras y la cancelación se encuentran en Billing overview. Cada plan tiene un tier (free, startup, growth o enterprise), y el tier es lo que tu integración percibe operativamente:
- Volumen de envío incluido. Cada plan incluye una asignación mensual de envíos de correo electrónico, medida por destinatario: un mensaje a tres destinatarios consume tres. En los planes de pago, los envíos que superan la asignación se miden como excedente hasta un techo máximo; pasado ese techo, los envíos se rechazan con un error de límite hasta que el período se reinicia. El plan Free no tiene excedente: se detiene en sus topes mensuales y diarios. Las asignaciones, topes y el techo de excedente están en Planes y precios.
- Los techos de limitación de solicitudes escalan con el plan. Los límites de solicitudes parten de un valor base, tu plan lo reemplaza con uno mayor y una anulación por organización reemplaza ambos, de modo que los planes superiores elevan los techos de envío y lectura. El modelo, la tasa base de cada grupo y las cabeceras se describen en Límites de solicitudes.
- Límites de recursos. Topes como la cantidad de dominios de envío, pools de IP e IPs dedicadas que tu organización puede tener se establecen por plan y son ajustables por organización. Si alcanzas uno, contacta a soporte en lugar de buscar una solución alternativa.
Las mejoras de plan se aplican de inmediato, haciendo disponible la nueva asignación completa para el resto del período actual. Las degradaciones y cancelaciones toman efecto al final del período de facturación actual. Consulta Cambios de plan y renovaciones para la secuencia de pago fallido y otras reglas de plazos. Diseña tus integraciones para manejar errores cuando una cuenta excede su asignación.
Medición de uso
Cada envío se contabiliza contra el período de facturación actual de tu organización. La página Usage del dashboard muestra el estado en tiempo real de cada producto, en la ventana en que se mide: el período del plan para el email medido, el mes calendario para pago por uso. Los productos se facturan de dos formas, y la diferencia es lo que tu integración percibe:
- Los productos medidos tienen una cuota incluida en tu plan (envíos de email). La página muestra cuánto de la cuota has consumido y cuánto la has excedido, para que puedas ver un excedente acumulándose antes de que se facture.
- Los productos de pago por uso se facturan por consumo según una tarifa (SMS, WhatsApp). Un mensaje puede generar dos cargos en el wallet: la tarifa propia de Bird cuando se procesa el envío, y una tarifa de terceros (un recargo del operador en SMS, la parte de Meta en WhatsApp) cuando el mensaje se entrega. Consulta el desglose por mensaje en cost del mensaje SMS o WhatsApp: transaction_amount es el cargo de Bird y passthrough_amount la tarifa de terceros.
La página cubre cada producto con suscripción o uso en el período actual, y muestra gráficos con el desglose diario, por país y por dominio de envío de cualquiera de ellos.
El wallet
Cada organización tiene un wallet: un saldo prepago compartido por el que pasan todos los cargos. Las renovaciones de plan, los excedentes y los envíos de pago por uso se debitan del wallet; una tarjeta guardada sirve para recargarlo (recargas, recarga automática y cobertura de renovaciones que el saldo no cubre). La página Spend del dashboard es el registro completo de créditos y cargos, de modo que cada movimiento del wallet queda reflejado en un solo lugar, y cada pago de recarga liquidado genera un recibo permanente que puedes descargar como PDF en la misma sección.
Operativamente, el wallet es una dependencia del envío de pago por uso: los envíos de SMS y WhatsApp se rechazan cuando el saldo no puede cubrirlos. SMS se rechaza en API con un 402; un envío de WhatsApp se acepta y luego se rechaza cuando Bird intenta cobrarlo. Una tarifa en el momento de la entrega que el saldo no puede cubrir se omite en lugar de rechazarse, así que el mensaje sigue llegando al destinatario. Para volumen transaccional, configura la recarga automática y una alerta de saldo bajo en Billing overview, o monitoriza y genera alertas por tu cuenta. Payment methods and wallet cubre ambos controles del dashboard. Los avisos de saldo bajo y de fallos de pago se envían a los propietarios de la organización. Los correos de facturas se envían a la lista de notificaciones de facturación de la organización cuando está configurada, y de lo contrario al propietario de la organización. Configura esa lista en Settings > Organization. Usa un alias de equipo monitorizado para que el correo de facturación no dependa de la bandeja de entrada de una sola persona.
Facturas
Las facturas se emiten por organización, una por mes calendario, y se listan en la página Invoices del dashboard, donde puedes abrir una para ver sus líneas o descargarla como PDF. Las facturas reflejan la misma medición que muestra la página Usage: el cargo recurrente de tu plan más cualquier excedente medido y gasto de pago por uso del período. Para saber cómo se estructuran las facturas, sus estados y los plazos de pago, consulta Usage, spend & invoices en el Knowledge base.
Próximos pasos
- Rate limits: el modelo base/tier/override en el que influye tu tier
- Plans & pricing: qué incluye cada plan, excedentes y precios de pago por uso
- Plan changes & renewals: tiempos de mejora/cancelación y la secuencia de pago fallido
- Users, teams & roles: quién puede gestionar la facturación (org:billing)
Recursos relacionados
Continúa con la documentación, guías y ejemplos sobre este tema. Los recursos están en inglés.