Suscripciones
Las Subscriptions automatizan cobros recurrentes. Definen un plan, un cliente, una cadencia y manejan reintentos, prorrateos y cancelaciones.
El objeto Subscription
{
"id": "sub_5T2pK9LqRxNm",
"object": "subscription",
"customer": "cus_8B2nM1Q9TfYr",
"plan": "plan_pro_monthly_mxn",
"status": "active",
"current_period_start": "2026-06-01T00:00:00Z",
"current_period_end": "2026-07-01T00:00:00Z",
"cancel_at_period_end": false,
"metadata": { "tenant": "acme" },
"created_at": "2026-06-01T00:00:00Z"
}
Endpoints
/v1/subscriptions
/v1/subscriptions/:id
/v1/subscriptions/:id
/v1/subscriptions/:id
Estados
trialing — periodo de prueba activo, sin cobros aún.active — cobros al día.past_due — un cobro falló, reintentando según política.unpaid — se agotaron los reintentos.canceled — cancelada.