Reintentar suscripción
Reintenta manualmente el pago rechazado más reciente de una suscripción para el ciclo de facturación actual.
- Solo se puede reintentar el pago más reciente de la suscripción.
- Se pueden ejecutar varios reintentos manuales solo si el intento de reintento anterior terminó con estado DECLINED.
- Activar manualmente un reintento detiene el esquema de reintentos inteligentes para el pago correspondiente. Los siguientes pagos de la suscripción seguirán el esquema de reintentos inteligentes si se habilitó en la creación.
- Después de un intento de reintento exitoso, el sistema continúa con el siguiente cobro programado de la suscripción.
- Si no se cumple ninguna de las dos condiciones, la solicitud devuelve
400con el código INVALID_STATE y el mensajeThe last payment intent of the subscription does not support the action requested.El mismo error se devuelve cuando la suscripción está cancelada. - Si ninguna suscripción coincide con
subscription_iden la cuenta, la solicitud devuelve400con el código SUBSCRIPTION_NOT_FOUND.
Autorizaciones
Encabezados
El account_id que encuentras en tu Dashboard de Yuno (UUID).
Parámetros de ruta
El identificador único de la suscripción, consulta create subscription (UUID).
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"
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"