Flujo de trabajo
En el siguiente flujo de trabajo, puedes ver los distintos estados de la suscripción y cómo se pueden actualizar.PAST_DUE cuando falla un cargo y vuelve a TRIALING cuando un cargo posterior es exitoso. Cualquier estado no terminal se puede cancelar, y una suscripción creada con initial_payment_validation: true pasa directamente de CREATED a CANCELED si el primer pago falla.
Estado de la suscripción
Las suscripciones pueden tener los estados que se describen en la siguiente tabla.Si tus suscripciones nunca pasan a
PAST_DUE, el estado aún no está habilitado para tu cuenta: un
cargo recurrente fallido deja la suscripción en ACTIVE mientras se ejecutan los reintentos. Contacta
a tu representante de Yuno para habilitarlo.Matriz de transición de estados
Cada celda muestra qué mueve una suscripción del estado de la fila al estado de la columna. N/A significa que la transición no existe. La facturación nunca sale deCOMPLETED ni de CANCELED por sí sola: la única forma de salir de cualquiera de los dos es una llamada explícita a Reactivar suscripción.
¹ Solo donde
PAST_DUE está habilitado para la cuenta; de lo contrario, la suscripción permanece en su estado actual mientras se ejecutan los reintentos.
ERROR queda fuera de este flujo: está reservado para fallas de procesamiento y no forma parte del
ciclo de vida normal descrito arriba.Cancelar una suscripción
Puedes cancelar una suscripción enCREATED, ACTIVE, TRIALING, PAST_DUE y PAUSED, tanto
a través de Cancelar suscripción como desde el dashboard.
COMPLETED y CANCELED no se pueden cancelar: intentarlo devuelve 400 INVALID_STATE, que es también
lo que devuelve una cancelación repetida de una suscripción ya cancelada. Cualquiera de las dos se puede volver
a ACTIVE con Reactivar suscripción.
El mismo endpoint también puede programar la cancelación para una fecha o un ciclo de facturación futuros en lugar de
aplicarla de inmediato: consulta Cancelar suscripción.