> ## Documentation Index > Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt > Use this file to discover all available pages before exploring further. # 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. 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. Crea sesiones de pago alojadas de forma programática. Calcula precios e impuestos antes de crear una sesión. Métodos de pago admitidos y opciones de configuración. Los enlaces de Checkout generados mediante la [Checkout Sessions API](/api-reference/checkout-sessions/create) no son reutilizables y caducan en un plazo de 24 horas. Genera una sesión nueva para cada cliente y cada intento de pago. ## Adaptive Currency Adaptive Currency permite a los clientes pagar en su moneda local preferida, lo que mejora la confianza y las tasas de conversión. ### Cómo funciona 1. **Activar**: Activa Adaptive Currency desde **Settings → Business** 2. **Seleccionar**: Los clientes pueden cambiar de moneda directamente en Checkout 3. **Convertir**: Los precios se convierten dinámicamente usando tipos de cambio en tiempo real 4. **Mostrar**: El importe final a pagar se muestra de forma transparente antes del pago Selector de moneda en Checkout Obtén más información sobre las monedas admitidas, las comisiones de conversión y la gestión de reembolsos. ## Checkout multilingüe Dodo Payments admite varios idiomas en la página de Checkout, lo que permite a los clientes completar los pagos en un idioma con el que se sientan cómodos. Selector de idioma en Checkout ### Aspectos destacados * Selector de idioma disponible directamente en Checkout * El texto de la interfaz, las etiquetas y los mensajes del sistema están localizados * Mejora la accesibilidad y la conversión internacional ### Idiomas admitidos La página de Checkout 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 Checkout estableciendo el parámetro `force_language` al crear una sesión de Checkout. Consulta la [Checkout Sessions API](/developer-resources/checkout-session#14-forcing-a-language) 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 sin configuración manual. ### Cómo funciona el cálculo de impuestos Las reglas fiscales se aplican según el país del cliente (y la región, cuando corresponde). El importe del impuesto se actualiza automáticamente cuando: * Cambia el país * Se actualiza la dirección El desglose final de impuestos se muestra claramente antes del pago. El cálculo de impuestos está completamente automatizado. No se requiere configuración manual para productos digitales y productos SaaS estándar. ## Compatibilidad con Business Tax ID Para empresas registradas, Checkout permite a los clientes introducir su Business Tax ID (por ejemplo, el número de VAT/GST). ### Qué ocurre al introducir un Tax ID * La elegibilidad fiscal se valida en tiempo real * Se aplican las exenciones fiscales o las reglas de inversión del sujeto pasivo correspondientes * El importe del impuesto se actualiza al instante en Checkout Introducción del Business Tax ID en Checkout Esto resulta especialmente útil para SaaS B2B y servicios digitales en los que los clientes empresariales pueden optar a exenciones fiscales. ## Códigos de descuento Los clientes pueden aplicar directamente en la página de Checkout los códigos de descuento o promocionales que hayas creado en el dashboard. ### Experiencia de Checkout 1. El cliente introduce el código de descuento 2. El descuento se valida al instante 3. El precio actualizado y el ahorro se muestran claramente Introducción del código de descuento en Checkout ### Integración de API Preaplica uno o varios códigos de descuento acumulables o activa el campo de entrada de descuentos: ```typescript theme={null} 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 una matriz de hasta 20 códigos que se acumulan en orden. El campo singular `discount_code` está obsoleto, pero sigue funcionando; las integraciones existentes no necesitan cambiar de inmediato. Migra a `discount_codes` cuando te resulte conveniente para utilizar la acumulación y la estructura de respuesta más completa. Obtén información sobre cómo crear y gestionar códigos de descuento. Busca y valida descuentos mediante nombres de código. ## Recopilación inteligente de direcciones Checkout admite una introducción flexible de direcciones para agilizar la finalización. ### Opciones disponibles | Opción | Descripción | | ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | | **Autocompletado de direcciones de Google** | Selección rápida con autocompletado | | **Introducción manual** | Control total para direcciones completas | | **Selección de país** | Determina la lógica fiscal y de cumplimiento | | **Dirección mínima** | Recopila únicamente el país (y el código postal cuando sea necesario para los impuestos); consulta [Modo de dirección mínima](#minimal-address-mode) | La recopilación de direcciones equilibra la velocidad, la precisión y la cobertura global para maximizar la conversión y garantizar el cumplimiento. ### Modo de dirección mínima Para maximizar la conversión, activa la recopilación de direcciones mínima para reducir la fricción en Checkout. Cuando `minimal_address` se establece en `true`, Checkout solo recopila: * **País** — siempre necesario para determinar los impuestos * **Código postal** — únicamente en las regiones donde sea necesario para calcular el impuesto sobre las ventas, el VAT o el GST El resto de los campos de dirección (calle, ciudad y estado) se omiten, lo que acelera considerablemente la finalización de Checkout. Modo de dirección mínima que muestra únicamente los campos de país y código postal en Checkout ```typescript theme={null} 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 de la dirección completa sigue siendo la opción predeterminada. Activa `minimal_address` para productos digitales y flujos SaaS en los que no se requieren datos de facturación completos. Consulta la referencia completa del parámetro `minimal_address` en la guía de Checkout Sessions API. ## Recopilación del número de teléfono Controla si el campo del número de teléfono aparece en Checkout y si es obligatorio mediante las feature flags de la sesión de Checkout. | Indicador | Predeterminado | Comportamiento | | ------------------------------- | -------------- | ------------------------------------------------------------------------------------------------------- | | `allow_phone_number_collection` | `true` | Muestra el campo del número de teléfono en el formulario de Checkout | | `require_phone_number` | `false` | Hace obligatorio el campo del número de teléfono (la validación del formulario exige un valor no vacío) | ```typescript theme={null} 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 en las que la recopilación del teléfono está desactivada mientras el número de teléfono es obligatorio. Usa `require_phone_number` para SaaS B2B, sectores regulados o cualquier flujo en el que necesites un canal de contacto verificado para soporte, revisión de fraude o cumplimiento. ## Campos personalizados Recopila información adicional de los clientes durante Checkout definiendo campos de formulario personalizados. Esto resulta útil para obtener datos como el nombre de la empresa, el tamaño del equipo, la fuente de referencia o cualquier otra información específica de la empresa. ### Tipos de campo disponibles | Tipo | Descripción | | ---------- | ---------------------------------------------- | | `text` | Campo 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 entre opciones predefinidas | | `boolean` | Selector Sí/No | ### Ejemplo ```typescript theme={null} 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 los payloads de webhook (`payment.succeeded`, `subscription.active`) y en las respuestas de la API mediante la matriz `custom_field_responses`. Puedes definir hasta 5 campos personalizados por sesión de Checkout. Obtén más información sobre la configuración de campos personalizados y el 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 [Política de privacidad](https://dodopayments.com/privacy-policy) y los [Términos del comprador](https://dodopayments.com/buyer-terms) se muestran claramente en Checkout * Los clientes deben aceptar explícitamente estos documentos 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 RGPD. ## Checkout de colecciones Product Collections 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. ### Cómo funciona 1. **Todos los productos se muestran**: Los clientes ven cada producto activo de la colección 2. **Primer producto preseleccionado**: El primer producto de la colección se selecciona automáticamente 3. **Comparar opciones**: Los clientes pueden comparar precios y funciones antes de elegir 4. **Selección única**: Tras seleccionar un producto, Checkout continúa con el flujo de pago estándar ### Crear un Checkout de colección ```typescript theme={null} 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 usar `product_collection_id`, pasa una matriz `product_cart` vacía. Los códigos de descuento no pueden preaplicarse al crear la sesión. Obtén información sobre cómo crear y gestionar colecciones de productos para experiencias de Checkout unificadas. ## Configuración de la sesión de Checkout Controla el comportamiento de Checkout mediante Checkout Sessions API: ```typescript theme={null} const session = await client.checkoutSessions.create({ product_cart: [ { product_id: 'prod_abc', quantity: 1 } ], customer: { email: 'customer@example.com', 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 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](/developer-resources/checkout-session#request-body) para ver la lista completa. Referencia completa de la API para las sesiones de Checkout. Guía paso a paso para integrar Checkout. ## Personalización del tema de Checkout Personaliza el aspecto de la página de Checkout para adaptarlo a tu marca mediante el parámetro `customization.theme_config` al crear una sesión de Checkout mediante la API. Configura colores, fuentes, radio de los bordes y texto de los botones para los modos claro y oscuro. Página de Checkout con tema personalizado Configura visualmente los temas desde el dashboard con temas prediseñados, tipografía, colores y vista previa en tiempo real. Esta sección explica la configuración del tema mediante la **API del servidor** usando `customization.theme_config`. Si utilizas el **Checkout SDK** (Checkout superpuesto o integrado), consulta la sección de personalización del tema en [Overlay Checkout](/developer-resources/overlay-checkout#theme-customization), que utiliza propiedades camelCase (por ejemplo, `bgPrimary` en lugar de `bg_primary`). ### Opciones de configuración del tema | Propiedad | Descripción | | -------------------- | ------------------------------------------------------------------------------------------------ | | `light` | Configuración de color para el modo claro | | `dark` | Configuración de color para el modo oscuro | | `font_primary_url` | URL de la fuente principal | | `font_secondary_url` | URL de la fuente secundaria | | `font_size` | Tamaño de fuente: `xs`, `sm`, `md`, `lg`, `xl`, `2xl` | | `font_weight` | Peso de fuente: `normal`, `medium`, `bold`, `extraBold` | | `radius` | Radio de los bordes de los elementos de la interfaz (por ejemplo, `4px`, `0.5rem`, `8px`) | | `pay_button_text` | Texto personalizado para el botón de pago (por ejemplo, "Completar compra", "Suscribirse ahora") | ### Configuración de colores (modo claro/oscuro) Cada modo (`light` e `dark`) admite las siguientes propiedades de color: | Propiedad | Descripción | | ------------------------ | --------------------------------------------- | | `bg_primary` | Color principal del fondo | | `bg_secondary` | Color secundario del fondo | | `text_primary` | Color principal del texto | | `text_secondary` | Color secundario del texto | | `text_placeholder` | Color del texto de marcador de posición | | `text_error` | Color del texto de error | | `text_success` | Color del texto de éxito | | `border_primary` | Color principal del borde | | `border_secondary` | Color secundario del borde | | `button_primary` | Color de fondo del botón principal | | `button_primary_hover` | Color del botón principal al pasar el cursor | | `button_secondary` | Color de fondo del botón secundario | | `button_secondary_hover` | Color del botón secundario al pasar el cursor | | `button_text_primary` | Color del texto del botón principal | | `button_text_secondary` | Color del texto del botón secundario | | `input_focus_border` | Color del borde al enfocar una entrada | 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 ```typescript theme={null} 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 es necesario especificar todas las propiedades de color. Las propiedades no especificadas utilizarán los valores del tema predeterminado.