Lista y recupera facturas de suscripción
Lista las facturas de una suscripción o recupera una sola factura por su UUID.
Lista las facturas de una suscripción
GET /subscription/{id}/invoice devuelve todas las facturas de una suscripción dada en orden cronológico inverso, como un array simple — ver el panel de respuesta de arriba para la forma completa de Invoice (status es open/paid/failed/void; el campo de reintentos es paymentAttemptCount).
lines[] está presente solo cuando el plan tarifica uno o más medidores de uso: una línea para la tarifa base del plan (sin meterId) más una línea por cada complemento medido. Ausente o vacío en una factura de tarifa fija — el amount de nivel superior es entonces el cobro completo, y el amount de cada línea suma a él.
Ejemplo
Recupera una factura específica
GET /subscription/invoice/{id} recupera una sola factura por su UUID, independientemente de a qué suscripción pertenezca. Se autentica igual que cualquier otro endpoint (Authorization: Bearer prv_production_xxx / prv_sandbox_xxx).
Parámetros de ruta
Parámetros de consulta
Respuesta
Devuelve un solo objeto de factura con los mismos campos descritos arriba.Errores
Ejemplo
Autorizaciones
Your secret API key: Bearer prv_production_xxx (production) or Bearer prv_sandbox_xxx (sandbox).
Parámetros de ruta
Subscription UUID.
Parámetros de consulta
Your merchant account identifier.
Respuesta
List of invoices
Invoice UUID.
The subscription this invoice belongs to.
open - awaiting payment; paid - settled; failed - all payment attempts failed; void - cancelled, no longer collectible.
open, paid, failed, void Invoice total in the currency minor units.
ISO 4217 currency code.
Decimal places for amount.
Start of the service period this invoice covers.
End of the service period this invoice covers.
Charge attempts made against this invoice, including dunning retries.
Per-attempt gateway results. Present on the single-invoice endpoint (GET /subscription/invoice/{id}).
Itemisation - present only when the plan prices usage meters: one base-fee line (no meterId) plus one per metered add-on. Absent/empty for a flat-fee invoice.