Skip to main content
Página de checkout
Dodo Payments checkout é um checkout otimizado para conversão, compatível globalmente, projetado para produtos digitais e empresas SaaS. Ele oferece suporte a múltiplas moedas, idiomas, impostos, descontos, complementos e fluxos de conformidade voltados para empresas.

Checkout Sessions API

Crie sessões de checkout hospedadas programaticamente.

Preview Checkout

Calcule preços e impostos antes de criar uma sessão.

Payment Methods

Métodos de pagamento suportados e opções de configuração.
Os links de checkout gerados pela Checkout Sessions API não são reutilizáveis e expiram em até 24 horas. Gere uma nova sessão para cada cliente e cada tentativa de pagamento.

Adaptive Currency

Adaptive Currency permite que os clientes paguem na moeda local de sua preferência, aumentando a confiança e as taxas de conversão.

Como funciona

  1. Ativar: ative o Adaptive Currency em Configurações → Negócios
  2. Selecionar: os clientes podem trocar de moeda diretamente no checkout
  3. Aplicar PPP: se a Paridade do Poder de Compra estiver ativada para o produto, o percentual do país reduz o preço base
  4. Converter: o preço (ou preço ajustado pelo PPP) é convertido para a moeda do cliente usando taxas de câmbio em tempo real
  5. Arredondar: se o Charm Pricing estiver ativado, o valor convertido será arredondado para uma terminação adequada, como 49,99
  6. Exibir: o valor final a pagar é mostrado de forma transparente antes do pagamento
Seletor de moedas no checkout

Adaptive Currency

Saiba mais sobre as moedas compatíveis, as taxas de conversão e o tratamento de reembolsos.

Checkout multilíngue

Dodo Payments oferece suporte a vários idiomas na página de checkout, permitindo que os clientes concluam os pagamentos em um idioma com o qual se sintam confortáveis.
Seletor de idioma no checkout

Principais destaques

  • Seletor de idioma disponível diretamente no checkout
  • Textos da UI, rótulos e mensagens do sistema são localizados
  • Melhora a acessibilidade e a conversão internacional

Idiomas compatíveis

A página de checkout é compatível com 21 idiomas:
Você pode forçar um idioma específico no checkout definindo o parâmetro force_language ao criar uma sessão de checkout. Consulte a Checkout Sessions API para saber mais.

Cálculo automático de impostos

Os impostos são calculados automaticamente com base no local de cobrança do cliente, garantindo conformidade com os requisitos de GST, VAT e impostos sobre vendas sem configuração manual.

Como funciona o cálculo de impostos

1

Location Detection

As regras fiscais são aplicadas com base no país do cliente (e na região, quando aplicável).
2

Dynamic Updates

O valor do imposto é atualizado automaticamente quando:
  • O país é alterado
  • O endereço é atualizado
3

Transparent Display

O detalhamento final dos impostos é exibido claramente antes do pagamento.
O cálculo de impostos é totalmente automatizado. Nenhuma configuração manual é necessária para produtos digitais e produtos SaaS padrão.

Suporte a Business Tax ID

Para empresas registradas, o checkout permite que os clientes insiram seu Business Tax ID (por exemplo, número de VAT/GST).

O que acontece quando um Tax ID é inserido

  • A elegibilidade fiscal é validada em tempo real
  • As isenções fiscais aplicáveis ou regras de reverse charge são aplicadas
  • O valor do imposto é atualizado instantaneamente no checkout
Inserção de Business Tax ID no checkout
Isso é especialmente útil para SaaS B2B e serviços digitais em que clientes empresariais podem ter direito a isenções fiscais.

Códigos de desconto

Os clientes podem aplicar códigos de desconto ou promocionais criados no dashboard diretamente na página de checkout.

Experiência de checkout

  1. O cliente insere o código de desconto
  2. O desconto é validado instantaneamente
  3. O preço atualizado e a economia são exibidos claramente
Quando a Paridade do Poder de Compra está ativada em um produto, o desconto é aplicado ao preço ajustado pelo PPP, não ao preço base.
Entrada de código de desconto no checkout

Integração com a API

Pré-aplique um ou mais códigos de desconto acumuláveis ou ative o campo de entrada de desconto:
discount_codes aceita uma matriz de até 20 códigos, que são acumulados na ordem informada. O campo singular discount_code está obsoleto, mas continua funcionando — as integrações existentes não precisam ser alteradas imediatamente. Migre para discount_codes quando for conveniente para usar o acúmulo e o formato de resposta mais completo.

Discount Codes

Saiba como criar e gerenciar códigos de desconto.

Validate Discount by Code

Consulte e valide descontos usando nomes de códigos.

Coleta inteligente de endereços

O checkout oferece uma entrada flexível de endereços para uma conclusão mais rápida.

Opções disponíveis

A coleta de endereços equilibra velocidade, precisão e cobertura global para maximizar a conversão e garantir o compliance.

Modo de endereço mínimo

Para maximizar a conversão, ative a coleta de endereço mínimo para reduzir o atrito no checkout. Quando minimal_address está definido como true, o checkout coleta apenas:
  • País — sempre obrigatório para determinar os impostos
  • CEP — apenas em regiões onde ele é necessário para o cálculo de sales tax, VAT ou GST
Todos os outros campos de endereço (rua, cidade, estado) são ignorados, acelerando significativamente a conclusão do checkout.
Modo de endereço mínimo mostrando apenas os campos de país e CEP no checkout
A coleta completa de endereços continua sendo o padrão. Ative minimal_address para produtos digitais e fluxos de SaaS em que os dados completos de cobrança não são necessários.

Minimal Address Reference

Consulte a referência completa do parâmetro minimal_address no guia da API Checkout Sessions.

Coleta de número de telefone

Controle se o campo de número de telefone aparece no checkout — e se ele é obrigatório — usando os feature flags da sessão de checkout.
require_phone_number: true requer allow_phone_number_collection: true. A API rejeita sessões em que a coleta de telefone está desativada enquanto o número de telefone é obrigatório.
Use require_phone_number para SaaS B2B, setores regulamentados ou qualquer fluxo em que você precise de um canal de contato verificado para suporte, análise de fraude ou compliance.

Campos personalizados

Colete informações adicionais dos clientes durante o checkout definindo campos de formulário personalizados. Isso é útil para reunir dados como nome da empresa, tamanho da equipe, origem da indicação ou qualquer outra informação específica do negócio.

Tipos de campo disponíveis

Exemplo

As respostas dos clientes são incluídas automaticamente nos payloads de webhook (payment.succeeded, subscription.active) e nas respostas da API por meio da matriz custom_field_responses. Você pode definir até 5 campos personalizados por sessão de checkout.

Custom Fields Guide

Saiba mais sobre a configuração de campos personalizados e o acesso às respostas.

Aceitação da Política de Privacidade e dos Termos

Para garantir transparência jurídica e de compliance:
Isso ajuda a atender aos requisitos globais de proteção do consumidor e privacidade de dados, incluindo a conformidade com o GDPR.

Checkout de coleção

As coleções de produtos permitem uma experiência de checkout unificada, em que os clientes podem visualizar e selecionar vários produtos relacionados (por exemplo, planos Starter, Pro e Enterprise) em um único checkout.

Como funciona

  1. Todos os produtos são exibidos: os clientes veem todos os produtos ativos da coleção
  2. Primeiro produto pré-selecionado: o primeiro produto da coleção é selecionado automaticamente
  3. Comparação de opções: os clientes podem comparar preços e recursos antes de escolher
  4. Seleção única: após selecionar um produto, o checkout prossegue com o fluxo de pagamento padrão

Criando um checkout de coleção

Ao usar product_collection_id, passe uma matriz product_cart vazia. Os códigos de desconto não podem ser pré-aplicados durante a criação da sessão.

Product Collections

Saiba como criar e gerenciar coleções de produtos para experiências de checkout unificadas.

Configuração da sessão de checkout

Controle o comportamento do checkout usando a API Checkout Sessions:
Após o pagamento, os clientes são redirecionados para o seu return_url, com parâmetros de consulta adicionados automaticamente — incluindo payment_id ou subscription_id, status, email e license_key (quando aplicável). Consulte o guia Checkout Sessions para ver a lista completa.

Checkout Sessions API

Referência completa da API para sessões de checkout.

Checkout Integration Guide

Guia passo a passo para integrar o checkout.

Personalização do tema do checkout

Personalize a aparência da página de checkout para combiná-la com a sua marca usando o parâmetro customization.theme_config ao criar uma sessão de checkout por meio da API. Configure cores, fontes, raio da borda e texto do botão para os modos claro e escuro.
Página de checkout com tema personalizado

Design & Theme Customization

Configure visualmente os temas no dashboard com temas predefinidos, tipografia, cores e visualização em tempo real.
Esta seção aborda a configuração de temas da API no lado do servidor usando customization.theme_config. Se você estiver usando o Checkout SDK (checkout em overlay ou inline), consulte a seção de personalização de temas em Overlay Checkout, que usa propriedades camelCase (por exemplo, bgPrimary em vez de bg_primary).

Opções de configuração do tema

Configuração de cores (modo claro/escuro)

Cada modo (light e dark) é compatível com as seguintes propriedades de cor:
Todos os campos de cor aceitam formatos padrão de cores 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)
  • Cores nomeadas: red, blue, transparent

Exemplo

Você não precisa especificar todas as propriedades de cor. As propriedades não especificadas usarão os valores padrão do tema.
Última modificação em 26 de agosto de 2026