Facturación por volumen: emisión de boletos con precios escalonados
La necesidad de negocio
Una fintech ofrece emisión de boletos a sus clientes empresariales. El precio se basa en el volumen: cuantos más boletos emite un cliente cada mes, menor es el costo unitario. Los primeros 50 boletos de cada mes son gratuitos. Los clientes que emiten 1,000 boletos o más reciben un descuento adicional del 5%. A partir de 3,000 boletos, el descuento sube al 10%.Estructura de precios
Configuración del paquete
Cómo funciona el cálculo
Al final del mes, el orquestador llama aPOST /v2/organizations/{organization_id}/ledgers/{ledger_id}/billing/calculate con el período de facturación. El motor cuenta las transacciones de boletos aprobadas en la ruta, resta la cuota gratuita, aplica el precio escalonado y aplica el descuento correspondiente.
El precio escalonado es precio por volumen: el motor elige el único nivel en el que cae la cantidad facturable y cobra cada unidad facturable al precio de ese nivel. No factura cada tramo de nivel por separado.
Resultado de ejemplo para un cliente que emitió 1,800 boletos en marzo:
El motor devuelve un payload de transacción que debita R$ 1,330.00 de
client-operating y acredita a fees-boleto-revenue.
Facturación de mantenimiento: cargo mensual de cuenta (PF)
La necesidad de negocio
Un banco digital cobra una comisión mensual fija de mantenimiento para cuentas personales (PF) activas. La comisión es de R$ 9.90 por cuenta. El motor conserva solo las cuentas cuyo código de estado esactive y excluye cualquier otro estado. No necesitas filtrarlas manualmente.
Midaz organiza las cuentas por segmento. El segmento seg_pf agrupa todas las cuentas personales.
Configuración del paquete
Cómo funciona el cálculo
El motor resuelve todas las cuentas del segmento PF y filtra por estado activo. Genera una transacción N:1: debita R$ 9.90 de cada cuenta activa y envía el total completo afees-maintenance-pf.
Resultado de ejemplo para 12,000 cuentas PF activas:
Facturación por volumen: Pix a precio fijo con exención de segmento
La necesidad de negocio
Una fintech cobra R$ 0.10 por cada Pix enviado (tarifa fija, sin niveles). Los clientes de nivel premium no pagan comisión. En lugar de listar cada cuenta premium, configuras la exención en el nivel de segmento.Configuración del paquete
Exención de segmento
Para exentar las cuentas premium, configura el paquete de comisiones para la rutapix-send. Agrega una referencia de segmento a waivedAccounts:
Cómo funciona el cálculo
Resultado de ejemplo para 5,000 transacciones Pix de cuentas estándar:
Las cuentas premium muestran cargo cero en los resultados de facturación.
Facturación de mantenimiento: portafolios PJ con tarifas diferentes
La necesidad de negocio
Una institución financiera administra varios portafolios de cuentas empresariales (PJ): PME (pequeñas y medianas empresas) y Corporate. Cada portafolio tiene una comisión de mantenimiento mensual diferente. La institución quiere calcular ambos en un solo Billing Run.Configuración del paquete
Portafolio PME (R$ 29.90/mes):Cómo funciona el cálculo
Una sola llamada aPOST /v2/organizations/{organization_id}/ledgers/{ledger_id}/billing/calculate con "type": "maintenance" procesa ambos paquetes. La respuesta incluye un resultado por paquete y un resumen consolidado.
Resultado de ejemplo para 500 cuentas PME + 50 cuentas Corporate:
Ambos resultados acreditan a la misma cuenta
fees-maintenance-pj, lo que mantiene el ingreso consolidado. El orquestador envía cada payload de transacción a Midaz de forma independiente.
Próximos pasos
Crear un paquete de facturación
Referencia de la API para crear paquetes de facturación de volumen y de mantenimiento.
Calcular facturación
Activa cálculos de facturación para un período y obtén los payloads de transacción.
Cálculos de facturación
Mecánica detallada del precio escalonado, las cuotas gratuitas y la facturación de mantenimiento.
Mejores prácticas
Guía operativa para paquetes de facturación en producción.