offerId. Promotional describe el canal de aplicación, no otro recurso de catálogo ni un purpose.
La Offer permanece independiente de planes y precios hasta que tu integración la selecciona.
Crear las condiciones
Las Offers directas pueden combinar una prueba gratuita con fases ordenadas de descuento o precio fijo:Aplicarla directamente
offerId explícito reemplaza la selección introductoria automática. No puede combinarse con promoCode, customTrialDays ni skipTrial: true.
Los cambios inmediatos de plan, sus previews y los flujos de reactivación compatibles también aceptan offerId. Los cambios de plan programados no aceptan una Offer.
Aplicarla a una suscripción activa
Para retención, aplicá una Offer a una suscripción que ya está activa. Las fases de descuento arrancan en el próximo ciclo de facturación, así que el período actual no se toca y la próxima factura sale con el descuento:expiresAt opcional para la cotización.
¿Aplicación directa o Promo Code?
UsáofferId directo cuando tu aplicación decide quién recibe las condiciones. Usá un Promo Code cuando el customer deba ingresar un código y la campaña necesite restricciones de canje.
Un Promo Code puede distribuir varias fases de descuento, incluso fixed_price, y puede comenzar con un trial si después viene un descuento. Una Offer que solo tiene un trial sigue disponible para aplicación directa.