
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.
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.
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.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.
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.
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. Cuandominimal_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

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.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.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ámetrocustomization.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.

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