Card Promotions

Card Promotions conecta una Promotional Offer existente con uno o más BINs de tarjeta. La Offer define el descuento y la duración; Card Promotion controla quién puede recibirla.

Esta funcionalidad aparece solo en organizaciones que tienen Card Promotions habilitado.

Configurá la promoción

1. Creá una Promotional Offer cuya primera fase sea un descuento.
2. Abrí Card Promotions y elegí esa Offer.
3. Agregá los BINs elegibles de 6 u 8 dígitos.
4. Elegí si aplica a todos los intervalos de billing o a uno específico.
5. Elegí discovery automático o hacé que tu aplicación deba preseleccionarla.
6. Activala cuando empiece la campaña comercial.

Un BIN solo puede pertenecer a una Card Promotion. Un match de ocho dígitos tiene prioridad sobre su fallback de seis.

Preseleccionala en el checkout

Enviá el cardPromotionId público al crear la suscripción:

const subscription = await commet.subscriptions.create(
  {
    customerId: 'cus_01J...',
    planId: 'pln_01J...',
    cardPromotionId: 'cpr_01J...',
  },
  { idempotencyKey: 'checkout-acme-2026-08-16' },
)

El checkout puede mostrar el beneficio desde el inicio, pero sigue siendo condicional. Commet lee la tarjeta ingresada y valida su BIN, el intervalo de billing configurado y la compatibilidad de la Offer con el precio seleccionado. Si esas validaciones fallan, quita la promoción antes de confirmar.

No envíes el offerId subyacente para simular una card promotion. Una Offer directa es incondicional; cardPromotionId conserva la validación y registra correctamente el origen de la aplicación.

Usá tarjetas de sandbox que coincidan con los BINs configurados y verificá tanto el camino elegible como el no elegible.