> ## Documentation Index
> Fetch the complete documentation index at: https://commet.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Card Promotions

> Distribuí una Promotional Offer a BINs elegibles y revalidá la tarjeta al confirmar el checkout.

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](/docs/es/promotional-offers) 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:

```typescript theme={null}
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.


## Related topics

- [card_promotions_not_available](/docs/es/api-reference/errors/card_promotions_not_available.md)
- [Offers, Promo Codes y Card Promotions](/docs/es/how-do-offers-promo-codes-and-card-promotions-work-together.md)
- [Create subscription](/docs/es/api-reference/subscriptions/create-subscription.md)
- [Promotional Offers](/docs/es/promotional-offers.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.