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 tu plan influye 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

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 nivel (free, startup, growth o enterprise), y el nivel 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 contabilizan 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.
• La limitación de solicitudes depende de la política. Una anulación activa de organización tiene precedencia sobre el valor de tu plan. Si el plan no tiene valor para esa política, se aplica el predeterminado. Una política de plan o una anulación pueden subir o bajar un límite, así que una mejora de plan no garantiza límites más altos en cada operación. Antes de mejorar tu plan por capacidad, contacta a soporte con la clave de la política y la cuota efectiva de tu cabecera de respuesta RateLimit-Policy, el plan que estás considerando y el tráfico que esperas. Pregunta qué límite se aplicaría después del cambio. Consulta cómo se resuelve tu límite.
• 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 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
• 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)