Añadir descuentos

Puedes usar descuentos para reducir el importe que se cobra a un cliente. Los cupones y los códigos de promoción te permiten:

• Aplica un descuento al subtotal de una compra
• Aplica un descuento a productos específicos
• Reducir el total facturado conforme a un porcentaje o un importe fijo
• Crear códigos de promoción para clientes sobre cupones para compartirlos directamente con ellos

Crear un cupón

Los cupones especifican un descuento de valor fijo. Puedes crear códigos de promoción orientados al cliente que se asignen a un único cupón subyacente. Esto significa que los códigos FALLPROMO y SPRINGPROMO pueden indicar un cupón con descuento del 25 %. Puedes crear cupones en el Dashboard o con la API:

curl https://api.stripe.com/v1/coupons \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d percent_off=20 \
  -d duration=once

Usa un cupón

Para crear una sesión con un descuento aplicado, pasa el ID del cupón en el parámetro de coupon de la matriz de los descuentos. Checkout actualmente admite un máximo de un cupón o código promocional.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d "discounts[0][coupon]"=
{{COUPON_ID}} \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel"

Configura un cupón

Los cupones tienen los siguientes parámetros que puedes usar:

• currency
• percent_off o amount_off
• max_redemptions
• redeem_by, la fecha límite que tienen los clientes para aplicar el cupón
• applies_to limita los productos a los que se aplica el cupón

Limita el uso del canje

Los valores de los parámetros max_redemptions y redeem_by se emplean en todas las aplicaciones del cupón. Por ejemplo, puedes restringir un cupón a los primeros 50 usos del mismo o puedes hacer que un cupón caduque en una fecha determinada.

Limita los productos que cumplen los requisitos

Puedes limitar los productos a los que se les pueden aplicar descuentos con un cupón añadiendo los ID de los productos al hash applies_to en el objeto Coupon. Todos los códigos de promoción que se asignen a este cupón solo se aplican a la lista de productos elegibles.

Elimina un cupón

Puedes eliminar cupones en el Dashboard o la API. La eliminación de un cupón impide que se aplique a futuras transacciones o clientes.

Crear un código de promoción

Los códigos de promoción son códigos creados además de los cupones que se pueden compartir con el cliente. También puedes especificar más restricciones para controlar cuándo un cliente puede aplicar la promoción. Puedes compartir estos códigos con clientes, quienes podrán introducirlos durante el Checkout para aplicar un descuento.

Para crear un código de promoción, especifica un coupon existente y las restricciones (por ejemplo, limitado a un determinado customer). Si tienes un código específico para ofrecerle a tu cliente (por ejemplo, FALL25OFF), establece el valor code. Si dejas este campo en blanco, generaremos un code aleatorio.

El code reconoce mayúsculas y minúsculas y es único entre los códigos de promoción activos para cualquier cliente. Por ejemplo:

• Puedes crear múltiples códigos de promoción restringidos a un cliente con el mismo code, pero no puedes reutilizar ese code para un código de promoción que pueda canjear cualquier cliente.
• Si creas un código de promoción canjeable por cualquier cliente, no podrás crear otro código de promoción activo con el mismo code.
• Puedes crear un código de promoción con code: NEWUSER, inactivarlo especificando active: false y, luego, crear un nuevo código de promoción con code: NEWUSER.

Los códigos de promoción se pueden crear en la sección de cupones del Dashboard o con la API:

curl https://api.stripe.com/v1/promotion_codes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d coupon={{COUPON_ID}} \
  -d code=VIPCODE

Usa un código de promoción

Habilita los códigos de promoción canjeables por el usuario utilizando el parámetro allow_promotion_codes en una Checkout Session. Esto habilita un campo en Checkout que permite a los usuarios introducir códigos de promoción.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d allow_promotion_codes=true \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel"

Configura un código de promoción

Para cada código de promoción, puedes personalizar los clientes que cumplen los requisitos, los canjes y otros límites.

Limitar por cliente

Para limitar una promoción a un determinado cliente, especifica un cliente al crear el código de promoción. Si no se especifica un cliente, cualquier cliente podrá canjear el código.

Limitar por primer pedido

También puedes limitar el código de promoción a los clientes nuevos con restrictions.first_time_transaction. Si el customer no está definido, o si un customer definido no tiene pagos previos o facturas no nulas, se considera una primera transacción.

Definir un importe mínimo

Con códigos de promoción, puedes establecer un importe mínimo de transacción para descuentos aptos configurando minimum_amount y minimum_amount_currency. Dado que las restricciones del código de promoción se comprueban en el momento del canje, el importe mínimo de transacción solo se aplica al pago inicial de una suscripción.

Personalizar los vencimientos

Puedes definir la fecha de caducidad del código de promoción con expires_at. Si el cupón subyacente ya tiene definido redeem_by, la fecha de caducidad del código de promoción no puede ser posterior a la del cupón. Si no se especifica promotion_code[expires_at], la opción redeem_by del cupón rellena automáticamente el valor de expires_at.

Por ejemplo, podrías decidir que quieres aceptar un cupón durante un año, pero quieres que el cupón sea canjeable solo durante una semana a partir de la fecha en la que el cliente lo recibe. Puedes establecer coupon[redeem_by] en un año a partir de ahora y cada promotion_code[expires_at] en una semana después de su creación.

Limitar los canjes

Puedes limitar la cantidad de canjes usando max_redemptions, que funciona de manera similar al parámetro de cupón. Si el cupón subyacente ya tiene definido max_redemptions, entonces el valor max_redemptions para el código de promoción no puede ser mayor que el del cupón.

Por ejemplo, si quieres que los primeros 50 clientes puedan canjear un cupón de venta de temporada, pero la promoción de invierno solo puede usar 20 de esos canjes, puedes definir coupon[max_redemptions]: 50 y promotion_code[max_redemptions]: 20.

Promociones inactivas

Puedes definir si un código de promoción es canjeable en un determinado momento usando el parámetro activo. Sin embargo, si el cupón subyacente de un código de promoción pierde su validez, todos sus códigos de promoción quedarán inactivos de forma permanente. Del mismo modo, si un código de promoción alcanza su max_redemptionso expires_at, quedará inactivo de forma permanente. Estos códigos de promoción no se pueden reactivar.

Eliminar promociones

Puedes eliminar promociones en el Dashboard o la API. La eliminación de una promoción impide que se aplique a futuras transacciones o clientes.