Saltar al contenido principal
Página de pago
La pasarela de pago de Dodo Payments está optimizada para la conversión y cumple con normativas globales, diseñada para productos digitales y empresas SaaS. Admite múltiples divisas, idiomas, impuestos, descuentos, complementos y flujos de cumplimiento orientados a negocios.

Checkout Sessions API

Crea sesiones de pago alojadas de forma programática.

Preview Checkout

Calcula precios e impuestos antes de crear una sesión.

Payment Methods

Métodos de pago admitidos y opciones de configuración.

Moneda Adaptativa

La Moneda Adaptativa permite a los clientes pagar en su moneda local preferida, mejorando la confianza y las tasas de conversión.

Cómo Funciona

  1. Habilitar: Activa la Moneda Adaptativa desde Configuración → Negocio
  2. Seleccionar: Los clientes pueden cambiar de moneda directamente en el pago
  3. Convertir: Los precios se convierten dinámicamente usando tasas de cambio en tiempo real
  4. Mostrar: La cantidad final a pagar se muestra de forma transparente antes del pago
Selector de moneda en el pago

Adaptive Currency

Obtén más información sobre las divisas compatibles, las tarifas de conversión y el manejo de reembolsos.

Pago en Múltiples Idiomas

Dodo Payments soporta múltiples idiomas en la página de pago, permitiendo a los clientes completar pagos en un idioma con el que se sientan cómodos.
Selector de idioma en el pago

Puntos Clave

  • Selector de idioma disponible directamente en el pago
  • Texto de la interfaz, etiquetas y mensajes del sistema están localizados
  • Mejora la accesibilidad y la conversión internacional

Idiomas Soportados

La página de pago admite 21 idiomas:
Puedes forzar un idioma específico en el checkout configurando el parámetro force_language al crear una sesión de checkout. Consulta la API de sesiones de checkout para más detalles.

Cálculo automático de impuestos

Los impuestos se calculan automáticamente en función de la ubicación de facturación del cliente, garantizando el cumplimiento de los requisitos de GST, IVA e impuestos sobre las ventas sin configuración manual.

Cómo funciona el cálculo de impuestos

1

Location Detection

Las reglas fiscales se aplican según el país del cliente (y la región cuando corresponde).
2

Dynamic Updates

El monto del impuesto se actualiza automáticamente cuando:
  • Cambia el país
  • Se actualiza la dirección
3

Transparent Display

El desglose final de impuestos se muestra claramente antes del pago.
El cálculo de impuestos está totalmente automatizado. No se requiere configuración manual para bienes digitales estándar y productos SaaS.

Soporte para identificaciones fiscales de empresas

Para empresas registradas, el checkout permite que los clientes ingresen su identificación fiscal empresarial (por ejemplo, número de IVA/GST).

Qué sucede cuando se ingresa una identificación fiscal

  • Se valida la elegibilidad fiscal en tiempo real
  • Se aplican exenciones de impuestos o reglas de inversión del sujeto pasivo según corresponda
  • El monto del impuesto se actualiza instantáneamente en el checkout
Entrada de ID de impuesto de negocio en el pago
Esto es especialmente útil para SaaS B2B y servicios digitales donde los clientes empresariales pueden ser elegibles para exenciones fiscales.

Códigos de descuento

Los clientes pueden aplicar códigos de descuento o promocionales que hayas creado en el panel directamente en la página de checkout.

Experiencia en el checkout

  1. El cliente introduce el código de descuento
  2. El descuento se valida al instante
  3. El precio actualizado y los ahorros se muestran claramente
Entrada de código de descuento en el pago

Integración con la API

Pre-aplica uno o más códigos de descuento apilados o habilita el campo de entrada de descuento:
discount_codes acepta un array de hasta 20 códigos que se apilan en orden. El campo singular discount_code está obsoleto pero aún funciona; las integraciones existentes no necesitan cambiar de inmediato. Migra a discount_codes cuando sea conveniente para usar apilamiento y la forma de respuesta más rica.

Discount Codes

Aprende cómo crear y gestionar códigos de descuento.

Validate Discount by Code

Busca y valida descuentos usando nombres de código.

Recolección de Direcciones Inteligente

El proceso de pago soporta la entrada flexible de direcciones para una finalización más rápida.

Opciones Disponibles

La recolección de direcciones equilibra velocidad, precisión y cobertura global para maximizar la conversión mientras asegura el cumplimiento.

Modo de Dirección Mínima

Para maximizar la conversión, habilita la recopilación mínima de direcciones para reducir la fricción en el proceso de pago. Cuando minimal_address está configurado en true, el pago solo recoge:
  • País — siempre requerido para la determinación de impuestos
  • Código postal — solo en regiones donde es necesario para el cálculo del IVA, GST o impuestos de venta
Se omiten todos los demás campos de dirección (calle, ciudad, estado), acelerando significativamente la finalización del pago.
Modo de dirección mínima que muestra solo los campos de país y código postal en el pago
La recopilación completa de direcciones sigue siendo el valor predeterminado. Activa minimal_address para productos digitales y flujos SaaS donde no se requieran detalles completos de facturación.

Minimal Address Reference

Consulta la referencia completa del parámetro minimal_address en la guía API de Sesiones de Pago.

Recopilación de Número de Teléfono

Controla si el campo de número de teléfono aparece en el pago — y si es obligatorio — usando las banderas de características de sesión de pago.
require_phone_number: true requiere allow_phone_number_collection: true. La API rechaza las sesiones donde la recopilación de teléfonos está deshabilitada y el número de teléfono es obligatorio.
Usa require_phone_number para SaaS B2B, industrias reguladas, o cualquier flujo donde necesites un canal de contacto verificado para soporte, revisión de fraude o cumplimiento.

Campos Personalizados

Reúne información adicional de los clientes durante el pago definiendo campos personalizados en el formulario. Esto es útil para recopilar datos como el nombre de la empresa, tamaño del equipo, fuente de referencia, o cualquier otra información específica del negocio.

Tipos de Campo Disponibles

Ejemplo

Las respuestas de los clientes se incluyen automáticamente en las cargas útiles de webhook (payment.succeeded, subscription.active) y en las respuestas de la API a través de la matriz custom_field_responses. Puedes definir hasta 5 campos personalizados por sesión de pago.

Custom Fields Guide

Aprende más sobre la configuración de campos personalizados y el acceso a respuestas.

Aceptación de Política de Privacidad y Términos

Para asegurar la transparencia legal y de cumplimiento:
Esto ayuda a cumplir con los requisitos globales de protección al consumidor y privacidad de datos, incluido el cumplimiento de GDPR.

Colección de Pagos

Las colecciones de productos permiten una experiencia de pago unificada donde los clientes pueden ver y seleccionar entre múltiples productos relacionados (por ejemplo, planes Starter, Pro, Enterprise) en un solo pago.

Cómo Funciona

  1. Todos los productos mostrados: Los clientes ven cada producto activo en la colección
  2. Primer producto preseleccionado: El primer producto en la colección se selecciona automáticamente
  3. Comparar opciones: Los clientes pueden comparar precios y características antes de elegir
  4. Selección única: Después de seleccionar un producto, el pago procede con el flujo de pago estándar

Creación de un Pago de Colección

Al utilizar product_collection_id, pasa una matriz product_cart vacía. No se pueden aplicar códigos de descuento previamente en la creación de la sesión.

Product Collections

Aprende cómo crear y gestionar colecciones de productos para experiencias de pago unificadas.

Configuración de las Sesiones de Pago

Controla el comportamiento del pago usando la API de Sesiones de Pago:
Después del pago, los clientes se redirigen a tu return_url con parámetros de consulta agregados automáticamente, incluidos payment_id o subscription_id, status, email, e license_key (si es aplicable). Consulta la guía de Sesiones de Pago para ver la lista completa.

Checkout Sessions API

Referencia completa de API para sesiones de pago.

Checkout Integration Guide

Guía paso a paso para integrar el pago.

Personalización del Tema del Pago

Personaliza la apariencia de la página de pago para que coincida con tu marca usando el parámetro customization.theme_config al crear una sesión de pago a través de la API. Configura colores, fuentes, radio de borde y texto del botón para modos claros y oscuros.
Página de pago personalizada con tema

Design & Theme Customization

Configura temas de manera visual desde el panel de control con temas preconstruidos, tipografía, colores, y vista previa en vivo.
Esta sección cubre la configuración del tema de la API del lado del servidor usando customization.theme_config. Si estás usando el Checkout SDK (pago superpuesto o inline), consulta la sección de personalización de temas en Overlay Checkout que utiliza propiedades en camelCase (por ejemplo, bgPrimary en lugar de bg_primary).

Opciones de Configuración del Tema

Configuración de Colores (Modo Claro/Oscuro)

Cada modo (light y dark) soporta las siguientes propiedades de color:
Todos los campos de color aceptan formatos estándar de color CSS:
  • Hex: #fff, #ffffff, #ffffffff
  • RGB/RGBA: rgb(255, 255, 255), rgba(255, 255, 255, 0.5)
  • HSL/HSLA: hsl(120, 100%, 50%), hsla(120, 100%, 50%, 0.5)
  • Colores nombrados: red, blue, transparent

Ejemplo

No necesitas especificar todas las propiedades de color. Cualquier propiedad no especificada utilizará los valores predeterminados del tema.
Última modificación el 9 de julio de 2026