Skip to main content
Página de pago
El checkout de Dodo Payments es una página de pago alojada diseñada para productos digitales y SaaS. Gestiona la conversión de divisas, el cálculo de impuestos, los códigos de descuento, la recopilación de direcciones y la selección del método de pago. Puedes crear una sesión de checkout mediante la API o el dashboard, y los clientes completan el pago en una página segura con tu marca.

Checkout Sessions API

Crea sesiones de checkout mediante programación.

Preview Checkout

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

Payment Methods

Métodos de pago y configuración compatibles.

Integration Guide

Guía paso a paso para integrar el checkout.
Los enlaces de checkout generados mediante la Checkout Sessions API no se pueden reutilizar. Caducan después de 24 horas o después de 15 minutos si se establece confirm: true. Genera una sesión nueva para cada cliente y cada intento de pago.

Adaptive Currency

Adaptive Currency permite que los clientes paguen en su moneda local preferida, lo que mejora la confianza y las tasas de conversión. Cuando está habilitado, los clientes ven un selector de moneda en el checkout. El precio se convierte a la moneda elegida según los tipos de cambio actuales. Si el producto tiene habilitada la Purchasing Power Parity, se convierte el precio ajustado por PPP en lugar del precio base. Si Charm Pricing está habilitado, el importe convertido se redondea a una terminación atractiva, como 49.99.
Selector de moneda en Checkout
Para habilitar Adaptive Currency, ve a Settings → Business y actívalo.

Adaptive Currency

Monedas compatibles, comisiones de conversión y gestión de reembolsos.

Checkout multilingüe

El checkout admite 22 idiomas. Los clientes pueden cambiar de idioma directamente en la página, y el texto de la interfaz, las etiquetas y los mensajes del sistema están localizados.
Selector de idioma en el checkout

Idiomas compatibles

Para forzar un idioma específico, establece customization.force_language al crear una sesión de checkout. Consulta la Checkout Sessions API para obtener más información.

Cálculo automático de impuestos

Los impuestos se calculan automáticamente según la ubicación de facturación del cliente, lo que garantiza el cumplimiento de los requisitos de GST, VAT e impuestos sobre las ventas. Las reglas fiscales se aplican según el país y la región del cliente cuando corresponde. El importe del impuesto se actualiza automáticamente cuando el cliente cambia de país o actualiza su dirección. 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 productos digitales y productos SaaS estándar.

Compatibilidad con Business Tax ID

Para transacciones B2B, el checkout permite que los clientes introduzcan su Business Tax ID (por ejemplo, el número de VAT o GST). Al introducirlo, el identificador fiscal se valida en tiempo real y las exenciones fiscales aplicables o las reglas de inversión del sujeto pasivo se aplican automáticamente.
Introducción del Business Tax ID en el checkout

Códigos de descuento

Los clientes pueden aplicar códigos de descuento o promocionales que hayas creado en el dashboard. El descuento se valida al instante y se muestra el precio actualizado. Cuando la Purchasing Power Parity está habilitada en un producto, el descuento se aplica al precio ajustado por PPP, no al precio base.
Introducción del código de descuento en el checkout
Puedes aplicar previamente códigos de descuento o habilitar el campo de entrada de descuentos mediante la API:
discount_codes acepta un array de hasta 20 códigos que se acumulan en orden. El campo singular discount_code está obsoleto, pero sigue funcionando para mantener la compatibilidad con versiones anteriores.

Discount Codes

Crea y gestiona códigos de descuento.

Validate Discount by Code

Busca y valida descuentos mediante nombres de código.

Recopilación inteligente de direcciones

El checkout admite una introducción flexible de direcciones para equilibrar rapidez, precisión y cobertura global.

Opciones

Modo de dirección mínima

Para maximizar la conversión, habilita la recopilación de direcciones mínima para reducir la fricción del checkout. Cuando minimal_address se establece en true, el checkout solo recopila:
  • País — siempre obligatorio para determinar los impuestos
  • Código postal — solo en las regiones donde sea necesario para calcular el impuesto sobre las ventas, el VAT o el GST
Se omiten todos los demás campos de dirección.
Modo de dirección mínima que muestra únicamente los campos de país y código postal en el checkout
La recopilación de la dirección completa es la opción predeterminada. Habilita minimal_address para productos digitales y flujos SaaS en los que no se requieren datos de facturación completos.

Recopilación del número de teléfono

Controla si el campo del número de teléfono aparece en el checkout y si es obligatorio.
require_phone_number: true requiere allow_phone_number_collection: true. La API rechaza las sesiones en las que la recopilación del teléfono está deshabilitada mientras el número de teléfono es obligatorio.

Campos personalizados

Recopila información adicional de los clientes durante el checkout definiendo campos de formulario personalizados. Esto resulta útil para recopilar el nombre de la empresa, el tamaño del equipo, la fuente de referencia o cualquier otro dato específico de la empresa.

Tipos de campo disponibles

Ejemplo

Las respuestas de los clientes se incluyen automáticamente en los payloads de webhook (payment.succeeded, subscription.active) y en las respuestas de la API mediante el array custom_field_responses. Puedes definir hasta 5 campos personalizados por sesión de checkout.

Custom Fields Guide

Configuración de campos personalizados y acceso a las respuestas.

Aceptación de la política de privacidad y los términos

Para garantizar la transparencia legal y de cumplimiento:
  • Los enlaces a la Privacy Policy y los Buyer Terms se muestran claramente en el checkout
  • Los clientes confirman explícitamente su aceptación antes de completar el pago
Esto ayuda a cumplir los requisitos globales de protección del consumidor y privacidad de datos, incluido el cumplimiento del GDPR.

Colecciones de productos

Las colecciones de productos permiten una experiencia de checkout unificada en la que los clientes pueden ver y seleccionar varios productos relacionados (por ejemplo, los planes Starter, Pro y Enterprise) en un único checkout. Al utilizar una colección, se muestran todos los productos activos de la colección. El primer producto se selecciona previamente y los clientes pueden comparar las opciones antes de elegir.
Al utilizar product_collection_id, pasa un array product_cart vacío. Los códigos de descuento no se pueden aplicar previamente al crear la sesión.

Product Collections

Crea y gestiona colecciones de productos.

Configuración de la sesión de checkout

Controla el comportamiento del checkout mediante la Checkout Sessions API:
Después del pago, los clientes son redirigidos a tu return_url con parámetros de consulta añadidos automáticamente, incluidos payment_id o subscription_id, status, email y license_key (si corresponde). Consulta la guía de Checkout Sessions para ver la lista completa.

Checkout Sessions API

Referencia completa de la API para las sesiones de checkout.

Checkout Integration Guide

Guía paso a paso para integrar el checkout.

Personalización del tema

Personaliza el aspecto de la página de checkout para que coincida con tu marca mediante el parámetro customization.theme_config. Configura los colores, las fuentes, el radio de los bordes y el texto del botón para los modos claro y oscuro. Esta sección cubre la API del lado del servidor, que utiliza nombres de propiedades como bg_primary. Un tema establecido en la sesión se aplica al checkout alojado, superpuesto y en línea. La opción themeConfig del lado del cliente del Checkout SDK, que utiliza nombres de propiedades como bgPrimary, está obsoleta. Consulta Overlay Checkout.
Página de checkout con tema personalizado

Design & Theme Customization

Configura visualmente los temas desde el dashboard con temas prediseñados, tipografía, colores y vista previa en tiempo real.

Opciones de configuración del tema

Configuración de colores (modo claro/oscuro)

Cada modo admite estas propiedades de color:
Todos los campos de color aceptan formatos de color CSS estándar:
  • Hexadecimal: #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 con nombre: red, blue, transparent

Ejemplo

No es necesario especificar todas las propiedades de color. Las propiedades no especificadas utilizan los valores del tema predeterminado.
Última modificación el 26 de septiembre de 2026