Saltar al contenido principal
Portada de la visión general de 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.

Sesiones de Pago

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

Validar Descuento

Verifica si un código es válido y aplicable antes de aplicarlo.

Crear Descuento (API)

Crea códigos de descuento nuevos programáticamente.

Listar y Actualizar Descuentos

Navega y gestiona 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 caducidad y límites de uso
  • Proceso de pago sin problemas: Campo de UI y soporte de 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 proceso de pago
  • Tipo y Monto (requerido): Establece un valor porcentual o de cantidad fija, o genera un código aleatorio utilizando el botón proporcionado
  • Fecha de Caducidad (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 (por ejemplo, “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 las Sesiones de Pago, pasa discount_code para pre-aplicar un código, y establece 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.

Referencia de API

Consulta la API para crear descuentos.
Lista todos los descuentos o recupera detalles para gestión y auditoría.

Referencia de API

Navega por las APIs de listado y recuperación.
Modifica la configuración del descuento, como monto, caducidad o restricciones.

Referencia de API

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

Referencia de API

Valida el uso del descuento.
Desactiva o elimina descuentos que ya no son necesarios.

Referencia de API

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

​
Aplica un descuento en Sesiones de Pago

Pre-aplica un descuento y muestra la UI de entrada del código. 
const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  discount_code: 'BLACKFRIDAY2024',
  customer: { email: '[email protected]', 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 proceso de 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 caducidades 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 retención. Comienza con ofertas simples y bien nombradas, valida a fondo e itera según el rendimiento.