Checkout y facturas

Recarga tu saldo de crédito con tarjeta a través de Stripe Checkout. Cada recarga genera una factura.

Cómo funcionan las recargas

  1. Solicitas una cantidad de recarga.
  2. Cloud API abre una factura (estado open) y una sesión de Stripe Checkout.
  3. Pagas en la página alojada de Stripe y vuelves al panel.
  4. El webhook de Stripe acredita tu saldo (más cualquier bonificación configurada) y marca la factura como paid.

Iniciar un checkout

bash
POST /v1/billing/checkout
{ "amountCents": 2500 }
→ { "url": "https://checkout.stripe.com/...", "invoiceNumber": "INV-2026-000042" }

Redirige al usuario a la url. El importe mínimo y cualquier porcentaje de bonificación provienen de GET /v1/billing/config.

Facturas

bash
GET /v1/invoices            # tus facturas
GET /v1/invoices/:id        # una factura con líneas de detalle

Las facturas tienen un número legible secuencial (p.ej. INV-2026-000042), un estado (open, paid, void), líneas de detalle y totales. El panel puede mostrar una copia imprimible. Ambos endpoints requieren el alcance billing:read; iniciar un checkout requiere billing:write.

Crédito de bonificación

Los administradores pueden configurar una bonificación de recarga (p.ej. +10%). Al pagarse, $25 podrían acreditar $27.50 — la bonificación se muestra en el checkout y se registra como línea en la factura.

Consulta también Créditos y facturación para ver cómo se mide el uso.

Checkout & invoices | Enzonic Cloud API