Recupera los detalles de una suscripción
Recupera los detalles completos de una suscripción por su UUID, incluyendo su plan y el progreso actual de gestión de cobros.
GET /subscription/{id} devuelve el registro completo de la suscripción para un UUID dado (ver el panel de respuesta de arriba), con su plan incrustado bajo plan. El progreso de gestión de cobros se reporta vía dunningAttemptCount en la propia suscripción, no un objeto anidado — para el historial de facturas, llama a Ver facturas con el mismo id de suscripción; todavía no hay un endpoint separado de cronología de eventos de ciclo de vida.
Errores
Autorizaciones
Your secret API key: Bearer prv_production_xxx (production) or Bearer prv_sandbox_xxx (sandbox).
Parámetros de ruta
Parámetros de consulta
Your merchant account identifier. Validated against the Bearer key's merchant.
Respuesta
Subscription details
A customer enrollment in a plan. plan is embedded on single-subscription responses. Invoice/event history is not included here - use the invoice endpoints.
Subscription UUID.
The merchant account that owns the subscription.
ID of the plan this subscription is enrolled in.
Subscriber email, used for billing and dunning notifications.
Subscriber name as it appears on invoices.
Subscriber national ID / tax document, where a market requires it (e.g. Brazil CPF/CNPJ).
Brand of the card on the mandate, e.g. visa.
pending - awaiting first charge; trialing - in a free trial; active - billing normally; past_due - a renewal failed and dunning is running; suspended - dunning exhausted, needs a new CIT (POST /subscription/{id}/payment-method in CIT mode) to recover; paused - billing stopped on request, resumable; cancelled - terminated; completed - reached maxBillingCycles.
pending, trialing, active, past_due, suspended, paused, cancelled, completed Start of the current billing period.
End of the current billing period.
When the next renewal charge is scheduled.
Trial start, when the plan has a trial.
Trial end - the first real charge date.
Failed-renewal retry attempts made in the current dunning sequence.
When the subscription first became active.
Deferred start, when creation set a future startAt.
Number of billing cycles charged so far.
When the subscription reached maxBillingCycles.
Parent subscription UUID, for add-on hierarchies.
Whether pause/cancel on the parent cascades to this subscription.
Plan the subscription will switch to at the next cycle, set by a next_billing change-plan.
A reusable billing plan. amount is a flat integer in the currency minor units (with separate currency + exponent) - not an Amount object.