Saltar al contenido principal
Discount codes overview cover
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
Utiliza límites de ciclo para precios introductorios en suscripciones (p. ej., “50% de descuento durante 3 meses”).

​
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. 
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'
});

​
Habilitar la entrada de descuento sin pre-aplicar

Permite a los clientes ingresar un código en el pago sin pasar uno por adelantado. 
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

  • Nombra claramente: Usa códigos reconocibles que coincidan con los nombres de las campañas
  • Limita en el tiempo: Agrega expiraciones para generar urgencia y prevenir abusos
  • Alcance sabiamente: Limita a productos específicos para evitar fugas de margen
  • Valida temprano: Verifica la aplicabilidad del código antes de confirmar el pago
  • Monitorea el impacto: Rastrea el uso y la conversión por campaña
Los códigos de descuento son palancas poderosas para la adquisición y la retención. Comienza con ofertas simples y bien nombradas, valida exhaustivamente e itera en función del rendimiento.