Descuentos

​

¿Qué Son los Códigos de Descuento?

• Campañas estacionales: Black Friday, lanzamientos de productos o aniversarios
• Ofertas de adquisición: Incentivos para la primera compra o recompensas por referencias
• Retención: Recompensas de recuperación o lealtad para clientes existentes
• Ofertas B2B: Precios contratados o negociados a través de códigos privados

​

Beneficios Clave

• 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: Aplica hasta 20 códigos por checkout, pago o suscripción — combina campañas (p. ej., WELCOME10 + BLACKFRIDAY20) sin crear códigos personalizados
• Control específico: Restringe 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 divisa: Define la deducción fija, el límite del importe y el subtotal mínimo por divisa
• Checkout fluido: Campo de UI y compatibilidad con API mediante sesiones de checkout

​

Configuración del Panel

​

Configuración en el dashboard

• Nombre del descuento (obligatorio): Nombre interno y nombre mostrado en el dashboard
• Código (obligatorio): Cadena que los clientes introducen en el checkout, o genera un código aleatorio mediante el botón proporcionado
• Tipo (obligatorio): Elige Porcentaje (un porcentaje de descuento) o Importe (una deducción fija)
• Importe (obligatorio): El valor porcentual o el importe fijo para un descuento de tipo Importe
• Fecha de inicio (opcional): Programa el momento en que el código estará activo; déjalo vacío para activarlo inmediatamente
• Fecha de vencimiento (opcional): Fecha después de la cual el código deja de ser válido
• Límite de uso (opcional): Máximo total de canjes entre todos los clientes
• Límite de uso por cliente (opcional): Máximo de canjes por parte de un único cliente. Debe ser menor o igual que el límite de uso general cuando ambos estén definidos
• Elegibilidad del cliente (opcional): Restringe quién puede canjear el código — todos los clientes, clientes nuevos, clientes existentes o una lista seleccionada manualmente
• Opciones de divisa (opcional): Valores por divisa — consulta Opciones por divisa
• Restricción de producto (opcional): Limita la aplicabilidad a productos seleccionados
• Límite de ciclos de suscripción (opcional): Número de ciclos de facturación durante los que se aplica el descuento
• Conservar al cambiar de plan (opcional): Mantén el descuento activo cuando cambie el plan de la suscripción (preserve_on_plan_change)
• Metadata (opcional): Añade pares clave-valor personalizados para el seguimiento interno o las integraciones

​

Tipos de descuento

​

Elegibilidad del cliente

​

Opciones por divisa

• Importe — para un descuento de tipo Importe, es la deducción en sí; para un descuento de tipo Porcentaje, limita cuánto puede descontar el código. Se asigna a max_amount_possible mediante la API.
• Subtotal mínimo — el código solo se aplica cuando el carrito alcanza este subtotal. 0 significa que no hay mínimo.
• Predeterminada — una entrada puede marcarse como predeterminada para que otras divisas no configuradas realicen la conversión a partir de ella.

​

Experiencia de checkout

1. Los compradores introducen el código en el campo de checkout.
2. Los descuentos elegibles se aplican y los totales se actualizan inmediatamente.

​

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 API

​

Casos de uso habituales

• Ofertas introductorias: Promociones de lanzamiento por tiempo limitado para productos nuevos
• Volumen o B2B: Descuentos contractuales para conjuntos de productos seleccionados
• Estrategias de retención: Códigos de recuperación en flujos de prevención de cancelaciones
• 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

• Nombres claros: Usa códigos reconocibles que coincidan con los nombres de las campañas
• Limita la duración: Añade fechas de vencimiento para generar urgencia y evitar usos indebidos
• Define bien el alcance: Limita los descuentos a productos específicos para evitar pérdidas de margen
• Valida pronto: Comprueba la aplicabilidad del código antes de confirmar el checkout
• Supervisa el impacto: Haz un seguimiento del uso y la conversión por campaña