Agregar descuentos

Puedes usar descuentos para reducir el importe cobrado a un cliente. Los cupones y los códigos de promoción te permiten hacer lo siguiente:

• Aplicar un descuento al subtotal de una compra
• Aplicar 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

Crea un cupón

Los cupones especifican un descuento de valor fijo. Puedes crear códigos de promoción para el cliente que se asignen a un único cupón de base. Esto significa que los códigos FALLPROMO y SPRINGPROMO pueden apuntar a un mismo cupón de 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, especifica la ID del cupón en el parámetro coupon de la matriz de descuentos. En este momento, Checkout 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 utilizar:

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

Limita el uso de canjes

Los valores max_redemptions y redeem_by se aplican al cupón en todas las aplicaciones. Por ejemplo, puedes restringir un cupón a los primeros 50 usos, o puedes hacer que un cupón venza en una fecha determinada.

Limita los productos elegibles

Puedes limitar los productos a los que se les apliquen descuentos con un cupón agregando 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 se aplicarán únicamente a la lista de productos elegibles.

Elimina un cupón

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

Crea un código de promoción

Los códigos de promoción son códigos para el cliente creados a partir de cupones. También puedes especificar otras restricciones para controlar cuándo un cliente puede aplicar la promoción. Puedes compartir estos códigos con los clientes, quienes podrán intrducirlos durante la confirmación de compra para aplicar descuentos.

Para crear un código de promoción, especifica un coupon existente y las restricciones (por ejemplo, limitar a un determinado customer). Si tienes un código específico para brindarle 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 canjeable por cualquier cliente.
• Si creas un código de promoción que cualquier cliente puede canjear, 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, inactívalo especificando active: false y, a continuación, crea 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 códigos de promoción canjeables por el cliente usando el parámetro allow_promotion_codes en una sesión de Checkout. De este modo, se habilita un campo en Checkout que permite a los clientes 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"

Configurar un código de promoción

Para cada código de promoción, puedes personalizar qué clientes acceden al descuento, los canjes y otros límites.

Limitar por cliente

Para limitar una promoción a un cliente determinado, especifica un cliente cuando crees el código de promoción. Si no se especifica ningún cliente, cualquier cliente puede 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 no se define el customer, o si el customer definido no tiene pagos anteriores o facturas no anuladas, se considera que es la primera transacción.

Definir un importe mínimo

Con códigos de promoción, puedes establecer un importe mínimo de transacción para el descuento que cumpla los requisitos configurando minimum_amount y minimum_amount_currency. Dado que las restricciones del código de promoción se controlan 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 vencimiento del código de promoción con expires_at. Si el cupón subyacente ya tiene definido redeem_by, la fecha de vencimiento del código de promoción no puede ser posterior a la del cupón. Si no se especifica promotion_code[expires_at], el valor redeem_by del cupón automáticamente se completa como expires_at.

Por ejemplo, si planeas admitir un cupón por un año, pero quieres que solo sea pueda canjearse durante una semana a partir de que el cliente lo recibe. Puedes establecer coupon[redeem_by] en un año a partir de ahora y cada parámetro promotion_code[expires_at] en una semana a partir 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 cupones. Si el cupón subyacente ya tiene definido max_redemptions, entonces el max_redemptions del 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 rebajas de temporada, pero la promoción de invierno solo puede usar 20 de esos canjes. En este escenario, puedes establecer coupon[max_redemptions]: 50 y promotion_code[max_redemptions]: 20.

Promociones inactivas

Puedes definir si un código de promoción se puede canjear en un determinado momento usando el parámetro active. 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_redemptions o expires_at, quedará inactivo de forma permanente. No puedes reactivar estos códigos de promoción.

Eliminar promociones

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