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 Settings → Business
  2. Selecionar: os clientes podem trocar de moeda diretamente no checkout
  3. Converter: os preços são convertidos dinamicamente usando taxas de câmbio em tempo real
  4. 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
Inserção de código de desconto no checkout

Integração com a API

Aplique previamente um ou mais códigos de desconto cumulativos ou ative o campo de entrada de desconto:
discount_codes aceita um array de até 20 códigos, aplicados em ordem. O campo singular discount_code está obsoleto, mas ainda funciona — 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 entrada flexível de endereço para agilizar a conclusão.

Opções disponíveis

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

Modo de endereço mínimo

Para maximizar a conversão, ative a coleta mínima de endereço e reduza o atrito no checkout. Quando minimal_address é definido como true, o checkout coleta apenas:
  • País — sempre obrigatório para determinar os impostos
  • CEP — somente em regiões onde é necessário para calcular impostos sobre vendas, 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 exibindo apenas os campos de país e CEP no checkout
A coleta completa de endereço continua sendo o padrão. Ative minimal_address para produtos digitais e fluxos 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 Checkout Sessions API.

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 exige 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 seja necessário um canal de contato verificado para suporte, análise de fraude ou conformidade.

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, 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 do 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 dos Termos

Para garantir transparência jurídica e de conformidade:
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ções

As Product Collections permitem uma experiência de checkout unificada, na qual 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. Comparar 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 um array product_cart vazio. Códigos de desconto não podem ser pré-aplicados na 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 Checkout Sessions API:
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 da 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 combinar com sua marca usando o parâmetro customization.theme_config ao criar uma sessão de checkout pela 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 temas visualmente pelo dashboard com temas predefinidos, tipografia, cores e visualização em tempo real.
Esta seção aborda a configuração de temas da API no servidor usando customization.theme_config. Se você estiver usando o Checkout SDK (checkout em sobreposição ou incorporado), 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 de cor CSS padrão:
  • 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)
  • Cores nomeadas: red, blue, transparent

Exemplo

Não é necessário especificar todas as propriedades de cor. As propriedades não especificadas usarão os valores do tema padrão.
Última modificação em 31 de julho de 2026