Saltar al contenido principal
Portada de la descripción general de los códigos de descuento
Los códigos de descuento te permiten ejecutar promociones e incentivos dirigidos. Crea descuentos porcentuales o de cantidad fija, establece límites y fechas de caducidad, restringe a productos y aplícalos sin problemas en el proceso de pago.

Checkout Sessions

Aplica códigos durante el pago alojado con discount_code y controles de interfaz de usuario.

Validate Discount

Comprueba si un descuento es válido según su ID.

Get Discount by Code

Busca y valida un descuento usando su nombre de código (p. ej., “SAVE20”).

Create Discount (API)

Crea programáticamente nuevos códigos de descuento.

List & Update Discounts

Navega y administra descuentos existentes; actualiza o elimina según sea necesario.

​
¿Qué Son los Códigos de Descuento?

Los códigos de descuento son tokens promocionales que reducen los totales de pedidos en el proceso de pago. Son ideales para:
  • 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

​
Creando Códigos de Descuento

Crea códigos de descuento en tu panel de Dodo Payments, luego aplícalos en el pago alojado o a través de la API.

​
Configuración del Panel

  • Nombre del Descuento (requerido): Nombre interno y de visualización en el panel
  • Código (requerido): La cadena que los clientes ingresan en el pago
  • Tipo y Monto (requerido): Establece un valor de porcentaje o cantidad fija, o genera un código aleatorio usando el botón proporcionado
  • Fecha de Expiración (opcional): Fecha después de la cual el código se vuelve inválido
  • Límite de Uso (opcional): Máximo total de redenciones entre todos los clientes
  • Restricción de Producto (opcional): Limitar la aplicabilidad a productos seleccionados
  • Límite de Ciclo de Suscripción (opcional): Número de ciclos de facturación a los que se aplica el descuento
  • Nombre del Descuento (obligatorio): Nombre para visualización interna y en el panel
  • Código (obligatorio): La cadena que los clientes ingresan al pagar
  • Tipo y Monto (obligatorio): Establezca un valor porcentual o fijo, o genere un código aleatorio usando el botón provisto
  • Fecha de Expiración (opcional): Fecha después de la cual el código se vuelve inválido
  • Límite de Uso (opcional): Máximo de redenciones totales entre todos los clientes
  • Restricción de Producto (opcional): Limitar la aplicabilidad a productos seleccionados
  • Límite de Ciclo de Suscripción (opcional): Número de ciclos de facturación al que se aplica el descuento
  • Metadatos (opcional): Adjunte pares clave-valor personalizados para seguimiento interno o integraciones

​
Experiencia de Pago

  1. Los compradores ingresan el código en el campo de pago.
  2. Se aplican los descuentos elegibles y los totales se actualizan de inmediato.
En Checkout Sessions, pasa discount_code para preaplicar un código y configura feature_flags.allow_discount_code para mostrar el campo de entrada.

​
Gestión de API

Crea códigos de descuento programáticamente con tipo y monto.

API Reference

Consulta la API de creación de descuentos.
Enumera todos los descuentos o recupera detalles para gestión y auditoría.

API Reference

Explora las API de listado y recuperación.
Busca un descuento usando su código legible para humanos (p. ej., “SAVE20”) en lugar del ID interno.

API Reference

Recupera un descuento por su nombre de código.
Modifica la configuración del descuento, como monto, fecha de expiración o restricciones.

API Reference

Aprende cómo actualizar los detalles del descuento.
Verifica si un descuento es válido y aplicable antes de aplicarlo.

API Reference

Valida el uso del descuento.
Desactiva o elimina descuentos que ya no se necesitan.

API Reference

Elimina un descuento.

​
Casos de Uso Comunes

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

​
Ejemplos de Integración

​
Aplicar un descuento en Sesiones de Pago

Pre-aplica un descuento y muestra la interfaz de entrada de código.

​
Crear un descuento con metadatos

Adjunte pares clave-valor personalizados para seguimiento interno. 
const discount = await client.discounts.create({
  type: 'percentage',
  amount: 1500, // 15%
  code: 'SUMMER2025',
  metadata: {
    campaign: 'summer_promo',
    source: 'email_blast'
  }
});
Use metadatos para etiquetar descuentos por campaña, fuente o ID de referencia interna para reconciliar el uso y medir el ROI más tarde.

​
Aplicar un descuento en Sesiones de Pago

Pre-aplique un descuento y muestre la interfaz de entrada de código. 
const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  discount_code: 'BLACKFRIDAY2024',
  customer: { email: 'user@example.com', name: 'Jane Doe' },
  return_url: 'https://yoursite.com/return'
});

​
Aplicar un descuento durante los cambios de plan

Ofrezca precios promocionales cuando los clientes mejoren o empeoren su suscripción. 
await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately',
  discount_code: 'UPGRADE20'
});
Si la suscripción ya tiene un descuento con preserve_on_plan_change=true y no pasa un nuevo código, el descuento existente se preserva automáticamente cuando aplica al nuevo producto.

​
Habilitar entrada de descuento sin pre-aplicar

Permita que los clientes ingresen un código al pagar sin pasar uno de antemano. 
const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  feature_flags: {
    allow_discount_code: true
  },
  return_url: 'https://yoursite.com/return'
});

​
Mejores Prácticas

  • Nómbrelo claramente: Use códigos reconocibles que coincidan con los nombres de campaña
  • Delimite temporalmente: Agregue expiraciones para impulsar la urgencia y prevenir el mal uso
  • Delimite sabiamente: Límitelo a productos específicos para evitar pérdidas de margen
  • Valide temprano: Verifique la aplicabilidad del código antes de confirmar el pago
  • Monitoree el impacto: Rastrear uso y conversión por campaña
Los códigos de descuento son poderosas palancas para adquisición y retención. Comience con ofertas simples y bien nombradas, valide a fondo y repita basado en el rendimiento.
Last modified on April 20, 2026