Offers
Definí términos introductorios y promocionales reutilizables.
Una Offer es el recurso canónico del catálogo para aplicar precios temporales a una suscripción. Define una o más fases sobre precios de planes, controla cuándo están disponibles y crea una aplicación inmutable cuando se aceptan.
Tipos de Offer
| Propósito | Selección | Alcance | Fases soportadas |
|---|---|---|---|
introductory | Se aplica automáticamente a una nueva suscripción elegible | Exactamente un precio base | free_trial opcional y, como máximo, una fase percentage o amount_off |
promotional | Se selecciona con offerId o mediante un Promo Code | Uno o más precios base | Una o más fases percentage, amount_off o fixed_price |
Las variantes heredan las Offers de su precio base. Una Offer no puede apuntar directamente a una variante.
Catálogo y términos aceptados
La Offer es la definición editable del catálogo. Contiene:
purpose, que determina cómo la selecciona CommetplanPriceIds, que limita dónde puede aplicarsephasesordenadas, que definen el cambio de precio y su duraciónstartsAt,endsAtyactive, que controlan su disponibilidad futurametadatapara tus propios identificadores
Cuando el checkout acepta una Offer, Commet registra una Offer Application con la moneda, el subtotal, el descuento, el total y las fases resueltas. Actualizar, desactivar o archivar la Offer del catálogo no modifica una aplicación existente.
Crear una Offer
const offer = await commet.offers.create({
name: 'Launch pricing',
purpose: 'promotional',
planPriceIds: ['pp_pro_monthly'],
phases: [
{ type: 'percentage', durationCycles: 3, percentage: 5000 },
],
startsAt: '2026-08-01T00:00:00.000Z',
endsAt: '2026-09-01T00:00:00.000Z',
})Usá la API de Offers para listar, obtener, crear, reemplazar y archivar definiciones del catálogo. Requiere API v8.
Relacionado
¿Cómo está esta guía?