v1.70.0 (24 de diciembre de 2025) - Dodo Payments Documentation

Nuevas Funciones 🚀

Pago en Línea - Experiencias de Pago Totalmente Integradas (BETA) Integra el pago de Dodo Payments directamente en tu sitio web para una experiencia de pago fluida y de marca. A diferencia del pago en superposición que se abre como un modal, el pago en línea incrusta el formulario de pago directamente en el diseño de tu página.

Beneficios
- Totalmente integrado: Crea experiencias de pago que se mezclan perfectamente con tu sitio web
- Resúmenes de pedidos personalizados: Construye una interfaz de usuario personalizada que se sincroniza con el pago en tiempo real
- Máximo control: Control total sobre el diseño y la disposición del pago
- Cumplimiento PCI: Dodo Payments maneja de forma segura toda la información de pago sensible
- Sincronización en tiempo real: Usa eventos de SDK para mantener tu interfaz de usuario sincronizada con el estado del pago
Cómo Funciona
Inicializa el SDK con displayType: 'inline' e incrusta el pago en un elemento contenedor:
```
import { DodoPayments } from "dodopayments-checkout";

// Initialize the SDK for inline mode
DodoPayments.Initialize({
  mode: "test",
  displayType: "inline",
  onEvent: (event) => {
    if (event.event_type === "checkout.breakdown") {
      // Update your UI with real-time tax and total calculations
      const breakdown = event.data?.message;
    }
  },
});

// Open checkout in a specific container
DodoPayments.Checkout.open({
  checkoutUrl: "https://test.dodopayments.com/session/cks_123",
  elementId: "dodo-inline-checkout" // ID of the container element
});
```
Características Clave
- Eventos de desglose en tiempo real: Recibe checkout.breakdown eventos a medida que los clientes ingresan sus detalles
- Resúmenes de pedidos personalizados: Construye tu propia visualización de precios que se actualiza en tiempo real
- Integración fluida: El marco de pago maneja la recolección de pagos mientras tú controlas el diseño
- Métodos de SDK: Usa open(), close(), y isOpen() para controlar el pago programáticamente
Resultado: Experiencias de pago totalmente integradas que coinciden con tu marca y proporcionan el máximo control sobre el flujo de pago.

Usa el pago en línea cuando desees el máximo control sobre el diseño del pago. Usa pago en superposición para una integración más rápida con cambios mínimos en las páginas existentes.
Aprende más: Guía de Pago en Línea
Crear Pagos, Suscripciones y Pagos Usando Métodos de Pago Existentes
Agiliza los flujos de pago utilizando métodos de pago guardados de clientes existentes. El nuevo payment_method_id parámetro te permite crear pagos, suscripciones o sesiones de pago utilizando un método de pago previamente guardado de un cliente.

Beneficios
- Pago más rápido: Omite la recolección de métodos de pago para clientes recurrentes
- Compras con un clic: Habilita compras instantáneas con métodos de pago guardados
- Gestión de suscripciones: Crea fácilmente suscripciones utilizando métodos de pago existentes
- Mejora de la conversión: Reduce la fricción en el pago para clientes recurrentes
Cómo Funciona
Usa payment_method_id al crear sesiones de pago, pagos o suscripciones:
- Sesiones de Pago
- Pagos Únicos
- Suscripciones
const session = await client.checkoutSessions.create({ product_cart: [{ product_id: 'prod_123', quantity: 1 }], customer: { customer_id: 'cus_123' }, payment_method_id: 'pm_abc123', confirm: true });
const payment = await client.payments.create({ product_cart: [{ product_id: 'prod_123', quantity: 1 }], customer_id: 'cus_123', payment_method_id: 'pm_abc123' });
const subscription = await client.subscriptions.create({ customer_id: 'cus_123', product_id: 'prod_subscription', payment_method_id: 'pm_abc123' });
Al usar payment_method_id en sesiones de pago, confirm debe establecerse en true, y debe proporcionarse un customer_id existente. El método de pago será validado para su elegibilidad con la moneda del pago.

El método de pago debe pertenecer al cliente y ser compatible con la moneda del pago. Si la validación falla, la solicitud devolverá un error.
Cambios en el Plan de Suscripción en el Panel con Actualizaciones de la Próxima Fecha de Facturación Gestiona los planes de suscripción directamente desde el panel con un control mejorado. Ahora puedes cambiar los planes de suscripción y actualizar la próxima fecha de facturación en una sola acción, dándote completa flexibilidad sobre la gestión de suscripciones.

Características del Panel
- Cambios de plan: Mejora o disminuye las suscripciones con un solo clic
- Control de fecha de facturación: Actualiza la próxima fecha de facturación al cambiar de plan
- Opciones de prorrateo: Elige cómo manejar el prorrateo al cambiar de plan
- Vista previa visual: Ve exactamente cómo los cambios de plan afectan la facturación antes de confirmar
Casos de Uso
- Soporte al cliente: Ajusta rápidamente los planes de suscripción para solicitudes de clientes
- Mejoras promocionales: Mejora temporalmente a los clientes con fechas de facturación específicas
- Migraciones de plan: Transición suave de los clientes entre niveles de suscripción
- Alineación de facturación: Alinea las fechas de facturación en múltiples suscripciones
Resultado: Control completo de la gestión de suscripciones desde el panel, reduciendo la necesidad de llamadas a la API para ajustes comunes de suscripción.

Usa el panel para cambios rápidos en los planes de suscripción, y la API para la gestión programática de suscripciones en tu aplicación.
Enlaces Cortos para URLs de Pago
Genera enlaces de pago más limpios y compartibles con nuestra nueva función de enlace corto. Los enlaces cortos proporcionan URLs de pago acortadas con slugs personalizados, lo que facilita compartirlos con clientes o incrustarlos en tu sitio web.

Beneficios
- URLs más limpias: Reemplaza largas URLs de pago con enlaces cortos y de marca
- Mejor confianza: Enlaces de aspecto profesional que generan confianza en los clientes
- Compartición más fácil: URLs simplificadas perfectas para SMS, correo electrónico o redes sociales
- Slugs personalizados: Crea enlaces cortos memorables y de marca para tus productos
Cómo Funciona
Habilita enlaces cortos al crear sesiones de pago o enlaces de pago:
- Sesiones de Pago
- Enlaces de Pago
const session = await client.checkoutSessions.create({ product_cart: [{ product_id: 'prod_123', quantity: 1 }], short_link: true, return_url: 'https://yourapp.com/success' });
const payment = await client.payments.create({ product_cart: [{ product_id: 'prod_123', quantity: 1 }], short_link: true, return_url: 'https://yourapp.com/success' });
Resultado: Un enlace de pago acortado que es más fácil de compartir y de aspecto más profesional, mejorando las tasas de conversión y la confianza del cliente.

Los enlaces cortos se gestionan en tu panel y se pueden ver a través de la API de Listar Enlaces Cortos.
redirect_immediately Bandera - Omitir Página de Éxito de Pago
Controla el flujo de pago con la nueva bandera redirect_immediately. Cuando está habilitada, los clientes son redirigidos inmediatamente después de completar el pago, omitiendo la página de éxito predeterminada para una experiencia más rápida y fluida.

Casos de Uso
- Flujo de pago más rápido: Reduce la fricción al omitir páginas intermedias
- Páginas de éxito personalizadas: Redirige directamente a tu página de éxito de marca
- Optimización móvil: Mejora la experiencia de pago móvil con redirecciones inmediatas
- Pagos incrustados: Integra sin problemas con flujos de pago en superposición o incrustados
Cómo Funciona
Habilita redirecciones inmediatas en sesiones de pago, pagos o suscripciones:
- Sesiones de Pago
- Pagos Únicos
- Suscripciones
const session = await client.checkoutSessions.create({ product_cart: [{ product_id: 'prod_123', quantity: 1 }], redirect_immediately: true, return_url: 'https://yourapp.com/success' });
const payment = await client.payments.create({ product_cart: [{ product_id: 'prod_123', quantity: 1 }], redirect_immediately: true, return_url: 'https://yourapp.com/success' });
const subscription = await client.subscriptions.create({ customer_id: 'cus_123', product_id: 'prod_subscription', redirect_immediately: true, return_url: 'https://yourapp.com/success' });
Usa redirect_immediately: true cuando tengas una página de éxito personalizada que ofrezca una mejor experiencia de usuario que la página de éxito de pago predeterminada.

Cuando redirect_immediately está habilitada, los clientes son redirigidos a tu return_url inmediatamente después de completar el pago, omitiendo completamente la página de éxito predeterminada.
Suscripciones Bajo Demanda - Disponibles para Todos los Negocios
Las suscripciones bajo demanda ahora están habilitadas para todos los negocios, dándote control de facturación flexible para servicios basados en uso y medidos.

Lo que Esto Habilita
- Facturación basada en uso: Crea suscripciones y cobra a los clientes según el uso real
- Ciclos de facturación flexibles: Cobra a los clientes bajo demanda en lugar de en intervalos fijos
- Servicios medidos: Perfecto para uso de API, almacenamiento, tiempo de cómputo y otros recursos medidos
- Control manual de cargos: Crea cargos manualmente cuando sea necesario, dándote control total sobre el momento de la facturación
Cómo Funciona
Crea una suscripción bajo demanda y cobra a los clientes según sea necesario:
```
// Create an on-demand subscription
const subscription = await client.subscriptions.create({
  customer_id: 'cus_123',
  product_id: 'prod_api_access',
  on_demand: true
});

// Charge the customer when usage occurs
await client.subscriptions.createCharge(subscription.id, {
  amount: 4900,
  currency: 'USD',
  description: 'API usage for September: 1,000 requests'
});
```
Resultado: Control total sobre cuándo y cuánto cobrar a los clientes, perfecto para modelos de negocio basados en uso.
Aprende más: Suscripciones Bajo Demanda
Correcciones de Errores Generales y Mejoras
Esta versión incluye mejoras de rendimiento, pulido de la interfaz de usuario y resuelve errores menores para una experiencia más confiable y fluida.

v1.67.0 (17 de diciembre de 2025)Pago de carrito mixto para productos de una sola vez y de suscripción, Portal de Clientes Unificado, invoice_id en la Respuesta de Pago

⌘I

Nuevas Funciones 🚀
Beneficios
Cómo Funciona
Características Clave
Beneficios
Cómo Funciona
Características del Panel
Casos de Uso
Beneficios
Cómo Funciona
Casos de Uso
Cómo Funciona
Lo que Esto Habilita
Cómo Funciona