Saltar al contenido principal
Yuno te permite gestionar el estado de las suscripciones directamente a través de la API, sin necesidad de sitios web ni aplicaciones adicionales. Puedes crear, pausar, reanudar y cancelar suscripciones.

Flujo de trabajo

En el siguiente flujo de trabajo, puedes ver los distintos estados de la suscripción y cómo se pueden actualizar.
Ciclo de vida de la suscripción: de CREATED a TRIALING o ACTIVE, con PAUSED, PAST_DUE, COMPLETED y CANCELED, además de un estado ERROR transversal
Una suscripción en la fase de prueba se comporta como una activa: se puede pausar, pasa a 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 de COMPLETED 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 en CREATED, 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.