Skip to main content
Os pagamentos B2B permitem coletar Tax IDs e nomes comerciais durante o checkout, validar os Tax IDs e aplicar o tratamento tributário correto com base no país e nas regulamentações do cliente.

​
Validação de Tax ID para transações B2B

Quando um Tax ID válido é fornecido durante o checkout:
  • A fatura inclui o Tax ID do cliente.
  • As deduções fiscais são determinadas com base nas regulamentações aplicáveis ao país do cliente.
  • A fatura inclui os dados fiscais da Dodo Payments e o imposto aplicado à transação.

​
Coleta do nome comercial para faturas B2B

Para compras B2B, você pode fazer com que o nome comercial legal do cliente seja exibido na fatura em vez do nome pessoal do comprador. Essa informação é coletada junto com o Tax ID por meio do campo customer_business_name. Quando o cliente seleciona Comprar como empresa no checkout, ele é solicitado a informar tanto um Nome comercial quanto um Número de Tax ID. O Tax ID é validado em tempo real enquanto o cliente digita. Para os estados-membros da UE, a Grã-Bretanha e a Austrália, o checkout realiza a validação de formato e checksum, além de uma consulta em tempo real ao registro (VIES, HMRC e ABR, respectivamente), e preenche automaticamente o nome comercial legal registrado quando uma correspondência é encontrada. Para todos os outros países, apenas a validação de formato e checksum é realizada.
Página de checkout com o botão 'Comprar como empresa' ativado, exibindo os campos Nome comercial e Número de Tax ID
O nome comercial aparece na fatura somente quando as três condições a seguir são atendidas:
  1. A transação é B2B (b2b = true).
  2. Um tax_id está presente.
  3. Um customer_business_name não vazio é fornecido.
Se alguma condição não for atendida, o nome pessoal do cliente será usado.

​
Configuração no checkout

Passe customer_business_name diretamente e/ou ative allow_customer_editing_business_name para permitir que o cliente o informe ou edite na página de checkout, ao lado do Tax ID:
customer_business_name não pode ser definido sem um tax_id — a solicitação é rejeitada. Limpar o tax_id também limpa o nome comercial, pois os dois estão vinculados na fatura. Os espaços em branco ao redor são removidos, e valores compostos apenas por espaços em branco são tratados como uma limpeza explícita.

​
Tornando o Tax ID obrigatório

Por padrão, o Tax ID é opcional — o cliente decide se deseja comprar como empresa. Se você vende exclusivamente para empresas registradas, defina o sinalizador de recurso require_tax_id na sessão de checkout para torná-lo obrigatório:

​
O que muda no checkout

  • Comprar como empresa fica pré-selecionado e não pode ser desmarcado. Não há uma opção para compradores pessoa física nessas sessões.
  • Nome comercial e Número de Tax ID são marcados como obrigatórios e devem ser preenchidos.
  • Continuar para o pagamento permanece desativado enquanto qualquer um dos campos estiver vazio ou enquanto o Tax ID informado for rejeitado pela validação.
A validação do Tax ID continua sendo fail-open — uma indisponibilidade na consulta ou um país não compatível nunca bloqueia o cliente, portanto o botão permanece clicável mesmo quando está desativado.
Passar tax_id e customer_business_name na sessão preenche previamente os dois campos, atendendo ao requisito antes de o cliente interagir com o formulário. Omita-os se quiser que o cliente forneça os próprios dados.

​
Regras e limites

Um tax_id vazio ou composto apenas por espaços em branco é considerado ausente, tanto na verificação confirm: true quanto na confirmação de uma sessão de página hospedada.
Em uma página de checkout hospedada (confirm: false), o requisito é aplicado no navegador. A API rejeita um Tax ID vazio na confirmação, mas não consegue distinguir um comprador pessoa física de um comprador empresarial que omitiu o campo. Portanto, trate require_tax_id em sessões hospedadas como um controle da experiência de checkout, e não como uma garantia de que todo pagamento terá um Tax ID. Uma sessão confirm: true é um caso mais rigoroso: ela é sempre tratada como uma compra empresarial e é rejeitada diretamente sem um Tax ID.

​
Tratamento tributário para transações B2C

As transações nas quais um Tax ID válido não é fornecido são tratadas como transações B2C, e o imposto é deduzido de acordo com as regulamentações tributárias aplicáveis no país do cliente. A fatura inclui os dados fiscais da Dodo Payments e o imposto aplicado à transação.

​
Mecanismo de reverse charge

Em geral, o fornecedor de bens ou serviços é responsável pelo pagamento de VAT, imposto sobre serviços ou GST. No entanto, em casos específicos, como importações e outros fornecimentos notificados, a responsabilidade cabe ao destinatário (cliente) de acordo com o mecanismo de reverse charge. Reverse Charge significa que a responsabilidade pelo pagamento do imposto cabe ao destinatário do fornecimento de bens ou serviços, e não ao fornecedor, no caso de categorias de fornecimento notificadas.

​
Aplicabilidade do reverse charge

Em determinados casos, quando aplicável por lei, o imposto não é deduzido no checkout e a transação fica sujeita a um mecanismo de reverse charge. A fatura indica claramente quando o reverse charge se aplica, conforme as exigências regulatórias.
Última modificação em 26 de setembro de 2026