Facturación y uso

La facturación tiene alcance de organización: tus planes de producto, tu monedero y tu flujo de facturas pertenecen a la organización. Esta página explica cómo la facturación afecta a una integración: cómo se mide el uso, cómo consultar el estado actual y cómo tus planes influyen en los límites operativos. 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 monedero ni cambiar de plan. Los propietarios y administradores de facturación realizan esas tareas en la sección Billing and payments del dashboard; consulta Usuarios, equipos y 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 de la Base de conocimiento enlazados a lo largo del texto.

Planes y niveles

Cada producto tiene su propio plan, que se elige de forma independiente: una organización puede tener a la vez un plan de pago de SMS, un plan de Realtime y el plan Email Free, y dejar Voice en pago por uso. Cada plan tiene un nivel (como free, startup, growth o scale) y uno de dos comportamientos financieros. Un plan de financiación añade un depósito mensual al monedero compartido y cobra el uso desde el primer envío; un plan de capacidad compra uso incluido y no añade nada al monedero. Planes y precios explica ambos, y Billing overview muestra los planes actuales de tu organización.

El plan es lo que tu integración percibe a nivel operativo:

• Los límites de solicitudes suben con el nivel. Cada plan fija valores para las políticas de su producto, como sms_send o whatsapp_send, y los niveles superiores fijan valores más altos. Sin plan, se aplica el valor por defecto de la política. Una anulación activa de organización tiene prioridad sobre cualquier plan. Consulta cómo se resuelve tu límite.
• Las cuotas suben con el nivel. Los planes fijan cantidades como las llamadas simultáneas de Voice, las conexiones de Realtime, los dominios de envío, las IP dedicadas y los endpoints de webhook. Cuando alcanzas una cuota, el nuevo recurso, llamada o conexión se rechaza con su propio error, distinto de una respuesta de límite de solicitudes 429.
• Las asignaciones terminan en los límites del plan. El plan Email Free se detiene en sus topes mensual y diario, y un plan de Realtime se detiene en sus límites de conexiones y de mensajes diarios. Los planes de pago de Email no tienen asignación incluida: cada envío se cobra del monedero.

Para consultar sin autenticación los valores publicados de cualquier plan, lista el catálogo de planes con bird billing plans list --commercial-product sms. Cada plan devuelve sus financial_behavior, rate_limits y quotas. La tabla comparativa de la página de precios de cada producto muestra esos valores junto a los valores por defecto de pago por uso, así que compáralos allí antes de mejorar tu plan para ganar capacidad.

Las mejoras de plan se aplican en cuanto el pago se completa, así que los nuevos límites llegan a mitad de período sin cambiar la fecha de renovación. Las degradaciones y cancelaciones se aplican al final del período actual, y una renovación impagada devuelve ese producto a su plan gratuito o a los límites de pago por uso. Consulta Cambios de plan y renovaciones para conocer las reglas de plazos. Diseña tus integraciones para gestionar errores de límite cuando cambia un plan o se agota una 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 contabilizan el uso contra la asignación incluida en un plan (envíos de email en el plan Email Free o en un plan de Email antiguo). La página muestra cuánto de la asignación has consumido y, en un plan antiguo con excedente, cuánto la has superado.
• Los productos de pago por uso se facturan por consumo según una tarifa (SMS, WhatsApp, Voice y email en un plan de pago de Email), con la tarifa del plan cuando el plan tiene una. Un mensaje puede generar dos cargos en el monedero: 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 se entrega el mensaje. 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 monedero

Cada organización tiene un monedero: un saldo prepago compartido por el que pasan los cargos de uso. Los envíos de pago por uso, las suscripciones a complementos y las renovaciones de planes de Email antiguos se debitan del monedero. Los planes de financiación lo recargan: cada depósito mensual pagado se añade íntegro y puede pagar cualquier producto. Una tarjeta guardada también lo recarga mediante recargas manuales y recarga automática, y paga directamente las renovaciones de plan. La página Spend del dashboard es el registro completo de créditos y cargos, de modo que cada movimiento del monedero 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.

A nivel operativo, el monedero 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 del 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. Métodos de pago y monedero explica 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, si no, 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: las cuotas de los planes de capacidad, los cargos y excedentes de los planes heredados y el gasto de pago por uso del período. El depósito de un plan de financiación es una recarga del wallet con su propio recibo; el uso que paga aparece en la factura. Para saber cómo se estructuran las facturas, sus estados y los plazos de pago, consulta Uso, gasto y facturas en la Base de conocimiento.

Próximos pasos

• Límites de solicitudes: valores por defecto de política, valores de plan, anulaciones por organización y cabeceras de respuesta
• Planes y precios: planes de financiación y de capacidad, qué aumenta cada nivel y precios de pago por uso
• Cambios de plan y renovaciones: plazos de mejora y cancelación, y la secuencia de pago fallido
• Usuarios, equipos y roles: quién puede gestionar la facturación (org:billing)