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
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.ACTIVE, mientras queden ciclos. COMPLETED, cuando se usan todos los ciclos. ENDED, cuando la promoción termina antes de tiempo.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
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.