Cupones

Crea códigos de descuento que tus clientes pueden aplicar al momento del pago. Porcentaje o monto fijo, con límite de tiempo o de usos, de una sola vez o recurrentes.

Los cupones se administran en el panel de tu app en Admin > Commerce > Products, bajo Coupons, y en la pestaña Cupones del panel de administración de tu app publicada.

Anatomía de un cupón

Campo	Notas
code	El código promocional que los clientes escriben al pagar (por ejemplo, LAUNCH20)
percent_off o amount_off	Son mutuamente excluyentes. El porcentaje va de 1 a 100. El monto se expresa en la unidad monetaria más pequeña (centavos).
currency	Requerido para descuentos de tipo amount_off (código ISO de tres letras). Se acepta al crear el cupón y se envía a Stripe, pero no se almacena ni se devuelve por la API.
duration	once (solo el primer pago), repeating (durante duration_in_months), o forever
duration_in_months	Requerido cuando duration es repeating
max_redemptions	Límite total de canjes entre todos los clientes
redeem_by	Fecha de expiración a partir de la cual el cupón deja de funcionar
name	Nombre visible que se muestra a los clientes
active	Activa o desactiva el cupón sin eliminarlo

Crear un cupón

Desde la subpestaña Coupons, haz clic en Add coupon y completa los campos. Algunos casos de uso comunes:

Objetivo	Configuración
20% de descuento para siempre	percent_off: 20, duración forever
$10 de descuento, uso único, vence en 30 días	amount_off: 1000, moneda USD, duración once, máximo de canjes 1, fecha de expiración en 30 días
50% de descuento en los primeros 3 meses de una suscripción	percent_off: 50, duración repeating, duración en meses 3

O simplemente pídele a la IA: "Create a LAUNCH20 coupon for 20% off forever."

Aplicar un cupón al momento del pago

Hay dos formas en que un cliente puede usar un código:

• En la página de pago de Stripe — el campo de código promocional se muestra automáticamente, así que el cliente puede escribir el código sin que tengas que hacer nada adicional.
• En tu propio carrito — agrega un campo de código promocional a tu carrito y pasa lo que el cliente escribió en la llamada al checkout como couponCode. El servidor valida el código y calcula el descuento a partir de los datos de comercio de tu app (nunca a partir de un monto enviado por el navegador), lo registra en el pedido y vincula el cupón de Stripe correspondiente para que el cobro sea correcto.

Pídele a la IA: "Add a promo code field to the cart and apply it at checkout."

Listar, actualizar y desactivar

La subpestaña Coupons muestra todos los cupones junto con el número de veces que han sido canjeados respecto a su límite, para que puedas monitorear el rendimiento de tus campañas de un vistazo. La edición es deliberadamente limitada — consulta más abajo —, pero puedes desactivar cualquier cupón sin eliminarlo, lo que detiene su funcionamiento en el checkout de forma inmediata.

Notas y limitaciones

• Los códigos y los montos de descuento son inmutables. Puedes actualizar el name visible y alternar active, pero no percent_off, amount_off ni el code en sí. Si necesitas condiciones diferentes, crea un nuevo cupón.
• times_redeemed se incrementa automáticamente y es de solo lectura — útil para rastrear el rendimiento de tus campañas.
• Los cupones se aplican por cliente, no por pedido — si un cupón es forever y un cliente se suscribe, cada renovación recibirá el descuento.