Características de Finalización de Compra

Finalización de compra optimizada para la conversión, compatible a nivel global, con soporte para múltiples monedas, múltiples idiomas, cálculo automático de impuestos, códigos de descuento, complementos y recolección inteligente de direcciones.

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

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.

​

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:

Idioma	Código
Árabe	ar
Catalán	ca
Chino	zh
Neerlandés	nl
Inglés	en
Francés	fr
Alemán	de
Hebreo	he
Indonesio	id
Italiano	it
Japonés	ja
Coreano	ko
Malayo	ms
Polaco	pl
Portugués	pt
Rumano	ro
Ruso	ru
Español	es
Sueco	sv
Tailandés	th
Turco	tr

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

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

​

Integración con la API

Pre-aplica uno o más códigos de descuento apilados o habilita el campo de entrada de descuento:

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  discount_codes: ['WELCOME20'], // Pre-apply one or more codes (max 20, applied in order)
  feature_flags: {
    allow_discount_code: true // Show discount input field
  },
  return_url: 'https://yoursite.com/return'
});

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

Opción	Descripción
Autocompletar dirección de Google	Selección rápida con autocompletar
Entrada manual	Control total para direcciones completas
Selección de país	Impulsa la lógica de impuestos y cumplimiento
Dirección mínima	Recoge solo el país (y el código postal donde se requiera por impuestos) — ver Modo de Dirección Mínima

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.

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  minimal_address: true,
  return_url: 'https://yoursite.com/return'
});

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.

Bandera	Predeterminado	Comportamiento
allow_phone_number_collection	true	Muestra el campo de número de teléfono en el formulario de pago
require_phone_number	false	Hace que el campo de número de teléfono sea obligatorio (la validación del formulario exige un valor no vacío)

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_abc', quantity: 1 }],
  feature_flags: {
    allow_phone_number_collection: true,
    require_phone_number: true
  },
  return_url: 'https://yoursite.com/return'
});

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

Tipo	Descripción
text	Entrada de texto de una sola línea
number	Entrada numérica
email	Dirección de correo electrónico con validación
url	URL con validación
date	Selector de fecha
dropdown	Selección de opciones predefinidas
boolean	Alternar de Sí/No

​

Ejemplo

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  custom_fields: [
    {
      key: 'company_name',
      label: 'Company Name',
      field_type: 'text',
      required: true
    },
    {
      key: 'team_size',
      label: 'Team Size',
      field_type: 'dropdown',
      required: true,
      options: ['1-10', '11-50', '51-200', '200+']
    }
  ],
  return_url: 'https://yoursite.com/return'
});

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:

• Los enlaces a la Política de Privacidad y Términos para Compradores se muestran claramente en el pago
• Los clientes reconocen explícitamente estos antes de completar el pago

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

const session = await client.checkoutSessions.create({
  product_collection_id: 'pdc_abc123',
  product_cart: [], // Required: pass an empty array for collection checkout
  return_url: 'https://yoursite.com/return'
});

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:

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  customer: {
    email: '[e-mail]',
    name: 'Jane Doe'
  },
  billing_currency: 'EUR', // Set specific currency
  discount_codes: ['PROMO10'],
  feature_flags: {
    allow_discount_code: true
  },
  return_url: 'https://yoursite.com/return',
  cancel_url: 'https://yoursite.com/pricing', // Optional: where to redirect on cancel
  metadata: {
    order_ref: 'ORD-12345'
  }
});

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.

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 del lado del servidor usando customization.theme_config. Si estás utilizando el SDK de Checkout (superposición o pago en línea), consulta las secciones de personalización de temas en Superposición de Checkout o Pago en Línea que usan propiedades en camelCase (por ejemplo, bgPrimary en lugar de bg_primary).

​

Opciones de Configuración del Tema

Propiedad	Descripción
light	Configuración de color para modo claro
dark	Configuración de color para modo oscuro
font_primary_url	URL para la fuente primaria
font_secondary_url	URL para la fuente secundaria
font_size	Tamaño de la fuente: xs, sm, md, lg, xl, 2xl
font_weight	Peso de la fuente: normal, medium, bold, extraBold
radius	Radio de borde para elementos de UI (e.g., 4px, 0.5rem, 8px)
pay_button_text	Texto personalizado para el botón de pago (e.g., “Completar Compra”, “Suscribirse Ahora”)

​

Configuración de Colores (Modo Claro/Oscuro)

Cada modo (light y dark) soporta las siguientes propiedades de color:

Propiedad	Descripción
bg_primary	Color de fondo primario
bg_secondary	Color de fondo secundario
text_primary	Color de texto primario
text_secondary	Color de texto secundario
text_placeholder	Color de texto de marcador de posición
text_error	Color de texto de error
text_success	Color de texto de éxito
border_primary	Color de borde primario
border_secondary	Color de borde secundario
button_primary	Color de fondo del botón primario
button_primary_hover	Color de hover del botón primario
button_secondary	Color de fondo del botón secundario
button_secondary_hover	Color de hover del botón secundario
button_text_primary	Color de texto del botón primario
button_text_secondary	Color de texto del botón secundario
input_focus_border	Color de borde de enfoque de entrada

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

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  customization: {
    theme_config: {
      // Custom fonts
      font_primary_url: 'https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600&display=swap',
      font_size: 'md',
      font_weight: 'medium',
      radius: '8px',
      pay_button_text: 'Complete Purchase',
      
      // Light mode colors
      light: {
        bg_primary: '#ffffff',
        bg_secondary: '#f5f5f5',
        text_primary: '#1a1a1a',
        text_secondary: '#666666',
        button_primary: '#0066ff',
        button_primary_hover: '#0052cc',
        button_text_primary: '#ffffff',
        border_primary: '#e0e0e0'
      },
      
      // Dark mode colors
      dark: {
        bg_primary: '#1a1a1a',
        bg_secondary: '#2d2d2d',
        text_primary: '#ffffff',
        text_secondary: '#a0a0a0',
        button_primary: '#3385ff',
        button_primary_hover: '#4d99ff',
        button_text_primary: '#ffffff',
        border_primary: '#404040'
      }
    }
  },
  return_url: 'https://yoursite.com/return'
});

No necesitas especificar todas las propiedades de color. Cualquier propiedad no especificada utilizará los valores predeterminados del tema.