Descuentos

​

¿Qué Son los Códigos de Descuento?

• Descuentos flexibles: Porcentaje o cantidad fija de descuento
• Control dirigido: Restringir por producto y ciclos de suscripción
• Gobernanza de campañas: Fechas de expiración y límites de uso
• Proceso de pago sin problemas: Soporte de campo de UI y API a través de sesiones de pago
• Descuentos flexibles: Descuentos basados en porcentajes o importes fijos
• Códigos combinables: Aplique hasta 20 códigos por checkout, pago o suscripción
• Control específico: Restrinja por producto, ciclos de suscripción y elegibilidad del cliente
• Gestión de campañas: Fechas de inicio programadas, fechas de vencimiento y límites de uso generales y por cliente
• Precios por moneda: Establezca la deducción fija, el límite del importe y el subtotal mínimo por moneda

​

Configuración del Panel

​

Configuración en el Dashboard

• Discount Name (obligatorio): Etiqueta interna para el Dashboard.
• Code (obligatorio): La cadena que los clientes introducen en el checkout. Genere un código aleatorio o introduzca uno propio (mínimo de 3 caracteres, convertido automáticamente a mayúsculas).
• Type (obligatorio): Percentage (un porcentaje de descuento) o Amount (una deducción fija).
• Amount (obligatorio): Para percentage, el porcentaje de descuento en el Dashboard (por ejemplo, 15 para 15 %). En la API, el mismo valor se expresa en puntos básicos (1500). Para amount, la deducción fija en la moneda predeterminada del código.
• Start Date (opcional): Programe la activación del código para una fecha futura. Déjelo vacío para activarlo inmediatamente.
• Expiration Date (opcional): Fecha después de la cual el código ya no se puede canjear.
• Usage Limit (opcional, en Advanced): Número máximo total de canjes entre todos los clientes.
• Per-Customer Usage Limit (opcional, en Advanced): Número máximo de canjes por parte de un mismo cliente. Debe ser menor o igual que el límite de uso general cuando ambos estén configurados.
• Customer Eligibility (opcional): Restrinja quiénes pueden canjearlo: todos los clientes, clientes nuevos, clientes existentes o una lista seleccionada manualmente.
• Currency Options (opcional): El importe del descuento para cada moneda en la que venda. Consulte Per-Currency Options.
• Product Restriction (opcional): Limite el código a productos específicos.
• Subscription Cycle Limit (opcional, en Advanced): Número de ciclos de facturación durante los que se aplica el descuento. Déjelo vacío para que sea indefinido.
• Preserve on Plan Change (opcional): Mantenga activo el descuento cuando una suscripción cambie de plan (preserve_on_plan_change).
• Metadata (opcional): Adjunte pares clave-valor personalizados para el seguimiento interno.
• Require a minimum order value (opcional, en Advanced): Subtotal mínimo del carrito (por moneda) necesario para aplicar el código.

​

Tipos de descuento

​

Elegibilidad del cliente

​

Opciones por moneda

• Amount — para un descuento Amount, la deducción fija en esa moneda; para un descuento Percentage, el límite máximo de descuento. Se asigna a max_amount_possible en la API.
• Default — marque una moneda como predeterminada. Las monedas no configuradas se convierten desde esta moneda predeterminada.

• Minimum subtotal — el código se aplica únicamente cuando el carrito alcanza este subtotal en esa moneda. 0 significa que no hay un mínimo.

​

Experiencia de checkout

​

Combinación de códigos de descuento

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_abc', quantity: 1 }],
  discount_codes: ['WELCOME10', 'BLACKFRIDAY20'], // applied in this order
  customer: { email: 'user@example.com' },
  return_url: 'https://yoursite.com/return'
});

​

Gestión mediante la API

​

Casos de uso habituales

• Ofertas introductorias: Promociones de lanzamiento por tiempo limitado para productos nuevos
• Volumen o B2B: Descuentos negociados para conjuntos de productos seleccionados
• Estrategias de retención: Códigos de recuperación en flujos de prevención del abandono
• Campañas estacionales: Promociones basadas en festividades o eventos

​

Ejemplos de integración

​

Crear un descuento con Metadata

const discount = await client.discounts.create({
  type: 'percentage',
  amount: 1500, // 15%
  code: 'SUMMER2025',
  metadata: {
    campaign: 'summer_promo',
    source: 'email_blast'
  }
});

​

Aplicar descuentos en Checkout Sessions

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'pdt_abc', quantity: 1 }
  ],
  discount_codes: ['BLACKFRIDAY2024', 'NEWUSER5'], // stacked in array order
  customer: { email: 'user@example.com', name: 'Jane Doe' },
  return_url: 'https://yoursite.com/return'
});

​

Aplicar descuentos durante cambios de plan

await client.subscriptions.changePlan('sub_123', {
  product_id: 'pdt_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately',
  discount_codes: ['UPGRADE20']
});

​

Ocultar el campo del código de descuento

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_abc', quantity: 1 }],
  feature_flags: {
    allow_discount_code: false
  },
  return_url: 'https://yoursite.com/return'
});

​

Prácticas recomendadas

• Nombre claro: Use códigos reconocibles que coincidan con los nombres de las campañas.
• Limite la duración: Añada fechas de vencimiento para generar urgencia y evitar usos indebidos.
• Defina el alcance con criterio: Limite los códigos a productos específicos para evitar la pérdida de margen.
• Valide con antelación: Compruebe la aplicabilidad del código antes de confirmar el checkout.
• Supervise el impacto: Realice un seguimiento del uso y la conversión por campaña.