Saltar al contenido principal
Cuando se aplica una promoción a una suscripción, Yuno guarda una copia en la suscripción. La copia es el objeto promotion. Crear suscripción y Actualizar suscripción lo devuelven. La copia nunca se edita: cambiar después la asociación del plan o la promoción no la modifica. Consulta Promociones en planes de suscripción.

Atributos

string
El ID de la promoción (UUID).Ejemplo: 8f2d6c1e-3b7a-4c55-9a1e-2f4d8b7c6a10
string
El nombre de la promoción.Ejemplo: Welcome 20% x3
object
El descuento. Los campos dependen de type.
object
El número de cobros que cubre el descuento.
enum
Qué efecto tiene una pausa sobre la promoción: KEEP (sus ciclos restantes continúan al reanudar) o END (la promoción termina con el motivo PAUSE). Se copia de la asociación del plan cuando se aplica la promoción.
enum
ACTIVE, mientras queden ciclos. COMPLETED, cuando se usan todos los ciclos. ENDED, cuando la promoción termina antes de tiempo.
timestamp
Cuándo se aplicó la promoción (ISO 8601).Ejemplo: 2026-11-02T14:00:00Z
timestamp
Cuándo terminó la promoción. null mientras está activa.
enum
null mientras la promoción está activa. En otro caso, uno de estos: REPLACED (se aplicó otra promoción), REMOVED (se eliminó de la suscripción), PLAN_CHANGE (el plan cambió y la promoción terminó), PAUSE (la suscripción se pausó y on_pause es END) o CANCELED (la suscripción se canceló).

Ejemplo

Una suscripción con una promoción de porcentaje, 2 de 3 ciclos usados:
Promotion object
Una promoción de monto fijo:
Fixed discount

En webhooks

subscription.cycle_executed incluye un objeto promotion más corto en cada ciclo con descuento, con id, discount_amount y cycles_remaining.