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.

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.
Moeda Adaptativa
A Moeda Adaptativa permite que os clientes paguem em sua moeda local preferida, melhorando a confiança e as taxas de conversão.Como Funciona
- Habilitar: Ative a Moeda Adaptativa em Configurações → Negócio
- Selecionar: Os clientes podem trocar de moeda diretamente no checkout
- Converter: Os preços são convertidos dinamicamente usando taxas de câmbio em tempo real
- Exibir: O valor final a pagar é mostrado de forma transparente antes do pagamento

Adaptive Currency
Saiba mais sobre moedas suportadas, taxas de conversão e tratamento de reembolsos.
Checkout em Múltiplas Línguas
Dodo Payments suporta múltiplas línguas na página de checkout, permitindo que os clientes concluam pagamentos em um idioma com o qual se sintam confortáveis.
Principais Destaques
- Seletor de idioma disponível diretamente no checkout
- Texto da interface, rótulos e mensagens do sistema são localizados
- Melhora a acessibilidade e a conversão internacional
Idiomas Suportados
A página de checkout oferece suporte a 21 idiomas:| Language | Code |
|---|---|
| Árabe | ar |
| Catalão | ca |
| Chinês | zh |
| Holandês | nl |
| Inglês | en |
| Francês | fr |
| Alemão | de |
| Hebraico | he |
| Indonésio | id |
| Italiano | it |
| Japonês | ja |
| Coreano | ko |
| Malaio | ms |
| Polonês | pl |
| Português | pt |
| Romeno | ro |
| Russo | ru |
| Espanhol | es |
| Sueco | sv |
| Tailandês | th |
| Turco | tr |
Cálculo automático de impostos
Os impostos são calculados automaticamente com base na localização de cobrança do cliente, garantindo conformidade com os requisitos de GST, VAT e imposto sobre vendas sem configuração manual.Como funciona o cálculo de impostos
Location Detection
Regras de impostos são aplicadas com base no país do cliente (e na região, quando aplicável).
Dynamic Updates
O valor do imposto é atualizado automaticamente quando:
- O país é alterado
- O endereço é atualizado
Suporte ao ID Fiscal da Empresa
Para empresas registradas, o checkout permite que os clientes insiram seu ID Fiscal (por exemplo, número VAT/GST).O que acontece quando um ID Fiscal é inserido
- A elegibilidade fiscal é validada em tempo real
- Exceções fiscais aplicáveis ou regras de cobrança reversa são aplicadas
- O valor do imposto é atualizado instantaneamente no checkout

Isso é especialmente útil para SaaS B2B e serviços digitais onde clientes empresariais podem ser elegíveis para isenções fiscais.
Códigos de desconto
Os clientes podem aplicar códigos de desconto ou promocionais criados no painel diretamente na página de checkout.Experiência no checkout
- O cliente insere o código de desconto
- O desconto é validado instantaneamente
- O preço atualizado e a economia são exibidos claramente

Integração com a API
Pré-aplique um código de desconto ou habilite o campo de entrada de desconto:Discount Codes
Saiba como criar e gerenciar códigos de desconto.
Validate Discount by Code
Pesquise e valide descontos usando os nomes dos códigos.
Coleta inteligente de endereços
O checkout oferece suporte à entrada flexível de endereços para conclusão mais rápida.Opções disponíveis
| Opção | Descrição |
|---|---|
| Preenchimento automático de endereço do Google | Seleção rápida com autocomplete |
| Entrada manual | Controle total para endereços completos |
| Seleção de país | Define a lógica de impostos e conformidade |
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 flags de sessão de checkout.| Flag | Padrão | Comportamento |
|---|---|---|
allow_phone_number_collection | true | Mostra o campo de número de telefone no formulário de checkout |
require_phone_number | false | Torna o campo de número de telefone obrigatório (a validação do formulário impõe um valor não vazio) |
Campos Personalizados
Colete informações adicionais dos clientes durante o checkout definindo campos de formulário personalizados. Isso é útil para coletar dados como nome da empresa, tamanho da equipe, fonte de indicação ou qualquer outra informação específica ao negócio.Tipos de Campos Disponíveis
| Tipo | Descrição |
|---|---|
text | Entrada de texto de linha única |
number | Entrada numérica |
email | Endereço de email com validação |
url | URL com validação |
date | Seletor de data |
dropdown | Seleção de opções predefinidas |
boolean | Alternância Sim/Não |
Exemplo
As respostas dos clientes são automaticamente incluídas em payloads de webhook (
payment.succeeded, subscription.active) e respostas da API via o array 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 Termos
Para garantir a transparência legal e de conformidade:- Os links para a Política de Privacidade e Termos do Comprador são exibidos claramente no checkout
- Os clientes reconhecem explicitamente esses termos antes de completar o pagamento
Isso ajuda a atender aos requisitos globais de proteção ao consumidor e privacidade de dados, incluindo conformidade com o GDPR.
Checkout de Coleção
As Coleções de Produto permitem uma experiência de checkout unificada, onde os clientes podem ver e selecionar entre vários produtos relacionados (por exemplo, planos Starter, Pro, Enterprise) em um único checkout.Como Funciona
- Todos os produtos exibidos: Os clientes veem todos os produtos ativos na coleção
- Primeiro produto pré-selecionado: O primeiro produto na coleção é automaticamente selecionado
- Comparar opções: Os clientes podem comparar preços e recursos antes de escolher
- Seleção única: Após selecionar um produto, o checkout prossegue com o fluxo de pagamento padrão
Criando um Checkout de Coleçã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 de Sessões de Checkout:Após o pagamento, os clientes são redirecionados para seu
return_url com parâmetros de query anexados automaticamente — incluindo payment_id ou subscription_id, status, email e license_key (se aplicável). Veja o guia de Sessões de Checkout para 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 de Tema do Checkout
Personalize a aparência da página de checkout para combinar com sua marca usando o parâmetrocustomization.theme_config ao criar uma sessão de checkout via API. Configure cores, fontes, raio da borda e texto do botão para modos claro e escuro.

Design & Theme Customization
Configure temas visualmente no painel com temas pré-construídos, tipografia, cores e visualização ao vivo.
Esta seção abrange a configuração de tema na API do lado do servidor usando
customization.theme_config. Se você estiver usando o Checkout SDK (checkout em overlay ou inline), consulte as seções de personalização de tema em Overlay Checkout ou Inline Checkout, que usam propriedades camelCase (por exemplo, bgPrimary em vez de bg_primary).Opções de Configuração de Tema
| Propriedade | Descrição |
|---|---|
light | Configuração de cor para modo claro |
dark | Configuração de cor para modo escuro |
font_primary_url | URL para a fonte primária |
font_secondary_url | URL para a fonte secundária |
font_size | Tamanho da fonte: xs, sm, md, lg, xl, 2xl |
font_weight | Peso da fonte: normal, medium, bold, extraBold |
radius | Raio da borda para elementos da interface (por exemplo, 4px, 0.5rem, 8px) |
pay_button_text | Texto personalizado para o botão de pagamento (por exemplo, “Finalizar Compra”, “Assine Agora”) |
Configuração de Cor (Modo Claro/Escuro)
Cada modo (light e dark) suporta as seguintes propriedades de cor:
| Propriedade | Descrição |
|---|---|
bg_primary | Cor primária de fundo |
bg_secondary | Cor secundária de fundo |
text_primary | Cor primária do texto |
text_secondary | Cor secundária do texto |
text_placeholder | Cor do texto do placeholder |
text_error | Cor do texto de erro |
text_success | Cor do texto de sucesso |
border_primary | Cor primária da borda |
border_secondary | Cor secundária da borda |
button_primary | Cor de fundo do botão primário |
button_primary_hover | Cor de hover do botão primário |
button_secondary | Cor de fundo do botão secundário |
button_secondary_hover | Cor de hover do botão secundário |
button_text_primary | Cor do texto do botão primário |
button_text_secondary | Cor do texto do botão secundário |
input_focus_border | Cor da borda do foco de entrada |
Todos os campos de cor aceitam formatos de cor padrão do 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