Reactivar suscripción
Devuelve una suscripción cancelada o completada al estado ACTIVE, conservando la misma suscripción y su historial.
CANCELED o COMPLETED
vuelve a ACTIVE (o a TRIALING cuando una fase de prueba cubre el ciclo reactivado),
conservando el mismo id y todo su historial de pagos. Nunca se crea una suscripción sucesora
y esta llamada nunca define previous_subscription_id. La llamada en sí no genera ningún cobro.
409 "Subscription reactivation is not enabled for this organization.",
contacta a tu representante de Yuno para que la habilite.Qué suscripciones se pueden reactivar
availability.finish_at ya pasó se rechaza con 400
INVALID_DATE, sin importar su estado:
Cuando se agotan los ciclos de facturación
Una suscripciónCOMPLETED que usó todos los ciclos de billing_cycles.total se rechaza con 409
INVALID_SUBSCRIPTION_STATUS:
billing_cycles.total con un valor mayor al actual para subir el límite y
reactivar en la misma llamada. Esto no crea una sucesora: sube el límite en la misma
suscripción, conservando su id y su historial intactos:
billing_cycles.total:
billing_cycles.total para una suscripción que aún tiene ciclos disponibles se acepta de la misma
manera: sube el límite, no está restringido a suscripciones agotadas. Un
billing_cycles.total: null explícito se trata igual que omitir el campo: el total actual se mantiene
sin cambios.
Elegir la próxima fecha de facturación
billing_cycle_behavior es el mismo eje que se usa al reanudar y en los cambios de plan.
400 BAD_REQUEST:
"billing_cycle_behavior must be one of KEEP, RESTART." Reactivar no tiene validación propia en el gateway:
el mismo texto vuelve sin cambios a través del gateway.
frequency.monthly_billing_day, RESTART lo fija
al día de la reactivación, la misma regla que aplican Actualizar suscripción y Reanudar suscripción. Una
suscripción que ya declara un día de facturación lo conserva.El método de pago
El método de pago almacenado se revalida antes de reactivar la suscripción. Si ya no está inscrito, la llamada devuelve400 PAYMENT_METHOD_STATUS_INVALID y la suscripción no se
modifica: la verificación del método de pago se ejecuta antes de escribir el estado:
Qué borra la reactivación
Al reactivar una suscripción se borra lo siguiente:cancellation_timecancellation_sourceending_timereason- cualquier cancelación programada (
cancel_scheduled) - cualquier pausa programada para terminar por sí sola: una suscripción reactivada nunca conserva
pause_until
subscription.reactivate se envía una sola vez y lleva la suscripción reactivada.
Errores
Autorizaciones
Cuerpo
RESTART reubica el próximo cobro en ahora más la frecuencia de la suscripción (y registra frequency.monthly_billing_day en una suscripción mensual que no tenía uno). KEEP u omitido: el ancla almacenada no se modifica mientras siga en el futuro; de lo contrario, avanza a su próxima ocurrencia futura. En ambos casos la llamada no realiza ningún cobro.
KEEP, RESTART "RESTART"
Respuesta
200
Inicio del período de facturación en el que está la suscripción actualmente, una cadencia antes de current_period_end. Dentro de una prueba o de cualquier otra fase del plan, sigue la cadencia de esa fase. Una suscripción terminal (CANCELED o COMPLETED) conserva su ventana final en lugar de pasar a null. Es null solo para una suscripción sin cadencia recurrente. Siempre se devuelve junto con current_period_end.
"2023-01-16T20:00:00.912480Z"
La política de reintentos que se aplica cuando se rechaza un cobro recurrente. Consulta Reintentos.
El enriquecimiento opcional de la orden enviada en la creación, devuelto tal cual. Consulta El objeto Suscripción para ver su estructura completa.
Qué desencadenó la cancelación: MERCHANT, SYSTEM, PLAN_CHANGE o RETRIES_EXHAUSTED. Solo se define una vez que la suscripción llega a CANCELED; null en caso contrario. Trátalo como un valor abierto: maneja los valores no reconocidos de forma adecuada.
"MERCHANT"
Las definiciones de fases del plan vinculado, tal como las declara el plan, incluida la fase terminal REGULAR. Solo está presente en suscripciones vinculadas a un plan que tiene fases. Esta es la escalera propia del plan, no la instantánea de este suscriptor: para lo que se fijó para esta suscripción en la creación, usa billing_phases.
Cuándo la fase indicada por current_phase pasa a la siguiente: para una suscripción en su prueba, cuándo cambia al precio regular. Es el fin del último período de facturación que cubre la fase, así que en el último período de una prueba es igual a current_period_end. Es null para una suscripción sin plan y para una que ya salió de la escalera de fases.
"2023-03-16T20:00:00.786342Z"
Solo está presente en suscripciones vinculadas a un plan cuyo plan tiene fases. Contiene únicamente las fases TRIAL iniciales, capturadas en la creación; la fase terminal REGULAR nunca se incluye, ya que su precio no se fija y se resuelve a partir del plan en cada facturación. current_phase: "REGULAR" es la señal de que la escalera se agotó.
La regla de reembolso almacenada que se usa para resolver un reembolso de cancelación CUSTOM cuando la solicitud de cancelación no envía su propio refund_amount. Solo está presente cuando hay una configurada; se omite, no es null, en caso contrario. Disponible para las organizaciones habilitadas; contacta a Yuno.
Cuándo está programado que la suscripción se reanude automáticamente. Solo está presente en una suscripción actualmente pausada con una duración (pause_cycles o pause_until enviados al pausar); está ausente, no es null, en cualquier otra lectura.
"2026-10-15T15:54:22.780166Z"