Skip to main content
Bring Your Own Processor (BYOP) conecta sua própria conta Stripe ou Adyen ao Dodo Payments. Os pagamentos dos países escolhidos são processados na sua conta de processor, enquanto o Dodo Payments cuida de tudo ao redor da transação: produtos, assinaturas, chaves de licença e o mecanismo de entitlement, faturamento, o Customer Portal e analytics. Para cada país do cliente, você escolhe quem processa o pagamento: seu processor, que torna você o vendedor legal para essa rota, ou o Dodo Payments como seu Merchant of Record completo. Os pagamentos de países sem uma rota vão para o Dodo Payments.

Route by Geography

Envie pagamentos de países específicos para seu próprio processor e todo o restante para o Dodo Payments.

Keep Your Processor Accounts

Continue usando suas contas e relacionamentos existentes com Stripe ou Adyen.

Stay the Merchant of Record

Nas suas próprias rotas, você continua sendo o vendedor legal e controla impostos, disputas e repasses.

One Billing Layer

O Dodo Payments gerencia produtos, assinaturas, faturas e analytics nas duas rotas.

​
BYOP vs. Dodo como Merchant of Record

Os dois modelos funcionam lado a lado. Cada pagamento segue a rota definida para o país do cliente. Para ver essa comparação no dashboard, selecione Show Comparison em Settings → BYOP.
Uma configuração comum é híbrida: encaminhar para seu próprio processor um país onde você já tenha uma entidade registrada e um processor (por exemplo, seu mercado doméstico) e deixar o Dodo Payments cuidar do restante do mundo como Merchant of Record.

​
Processors compatíveis

Você pode conectar Stripe e Adyen.

Stripe

Adyen

Os pagamentos encaminhados pelo seu próprio processor aceitam apenas cartões de crédito e débito.
Stripe e Adyen exigem raw card API access na sua conta para que o Dodo Payments possa executar o billing sobre o seu processor. Cada processor habilita esse recurso mediante solicitação, portanto entre em contato com o suporte do processor antes de conectar. A etapa de conexão do assistente de configuração mostra o mesmo requisito, com um link View documentation para os guias de Stripe e Adyen.

​
Configurar o BYOP

Para iniciar o assistente de configuração, abra Settings → BYOP no dashboard e selecione Configure no card Bring Your Own Processor.
As conexões são configuradas por ambiente. Um processor conectado em modo de teste (exibido como Sandbox) é separado de um conectado em modo live (exibido como Production). Para testar antes de entrar em operação, configure ambos. O assistente de configuração usa o modo definido pelo seletor Live Mode na barra lateral.
Configurações BYOP mostrando as opções Merchant of Record e Traga Seu Próprio Processador com uma comparação de recursos
1

Choose a Payment Processor

Em Select Payment Processor, selecione Stripe ou Adyen e depois selecione Continue.
Diálogo de seleção de processador de pagamento com opções Stripe e Adyen
2

Connect Your Account

Insira os detalhes da conexão e selecione Connect processor:
  • Processor Name: um nome para esta conexão, com 2–75 caracteres. Um nome ajuda quando você conecta várias contas de um mesmo processor, por exemplo Stripe US e Stripe UK.
  • Secret Key: a API key do seu processor para o modo atual. Para Stripe, esta é sua chave secreta sk_....
  • Merchant Account (somente Adyen): o identificador da sua conta de merchant Adyen.
Etapa de conexão da conta Stripe mostrando nome do processador, chave secreta, endpoint de webhook e campos de segredo de assinatura
O Dodo Payments cria a conexão e exibe uma URL de Webhook Endpoint exclusiva para ela. Adicione essa URL como destino de webhook no dashboard do seu processor. Depois, cole o Webhook Signing Secret no Dodo Payments e selecione Save & continue:
  • Stripe: o signing secret do webhook endpoint adicionado.
  • Adyen: a HMAC key de Customer Area → Webhooks.
Até que você salve o signing secret, a conexão aparece como Incomplete em Edit Configuration. Depois de salvá-lo, a conexão aparece como Connected.
Depois que você se conecta, sua secret key é armazenada com segurança e não pode ser visualizada nem alterada. A conta de merchant Adyen também não pode ser alterada após a configuração. No seu processor, você configura apenas a URL do webhook gerada pelo Dodo Payments; nunca trabalha diretamente com a infraestrutura subjacente.
3

Configure Payment Routing

Adicione regras de roteamento que associem países de clientes a um processor. Cada país é encaminhado para exatamente um processor:
  • Seu processor processa os pagamentos dos países atribuídos a ele.
  • Dodo Payments processa o Rest of the World, ou seja, todos os países que você não encaminhar, como Merchant of Record.
Etapa de Configuração de Roteamento de Pagamentos mostrando Stripe US roteado para Estados Unidos e Dodo Payments como padrão de Resto do Mundo
Para atribuir um ou mais países a um processor, selecione Add Route, escolha o processor e selecione os países. Um país que já esteja encaminhado para outro processor não pode ser adicionado.
Painel de Adição de Rota selecionando um processador e países
Diretrizes de roteamento
  • Rest of the World abrange todos os países sem uma rota.
  • As rotas do Dodo Payments como Merchant of Record gerenciam automaticamente a conformidade e os impostos.
  • As rotas no seu próprio processor de pagamentos exigem uma configuração fiscal separada, se necessário.
4

Configure Invoice Information

Nos pagamentos encaminhados pelo seu próprio processor, você é o vendedor na fatura. Insira os dados comerciais dessas faturas:
  • Registered Business Name (obrigatório).
  • Tax ID (EIN, SSN, etc.) (opcional): 3–32 letras, números ou hífens. A validação de formato está disponível para EINs dos EUA.
  • Statement Descriptor (obrigatório): o que os clientes veem no extrato bancário. Use de 5–22 letras, números, espaços, _ ou -.
  • Registered Business Address (obrigatório): comece a digitar para buscar seu endereço ou insira-o manualmente.
  • Privacy Policy Link e Terms of Service Link (obrigatórios).
A Invoice Header Preview mostra como os dados aparecem. Esses dados se aplicam somente às faturas das rotas processadas pelo seu próprio processor. Os pagamentos encaminhados ao Dodo Payments mantêm os dados do Dodo Payments como Merchant of Record.
Etapa Configurar Informação de Fatura com detalhes do negócio e uma visualização ao vivo do cabeçalho da fatura
5

Review and Finish

Revise a conexão do processor, as regras de roteamento e os detalhes da fatura. Selecione I confirm that the routing and billing details are correct e depois selecione Finish setup.
Etapa Revisar Sua Configuração resumindo o processador, roteamento e detalhes de fatura
Após a configuração, o card Bring Your Own Processor exibe Edit Configuration, onde você pode adicionar processors e editar os detalhes de roteamento e das faturas. Para enviar novamente todos os pagamentos pelo Dodo Payments como Merchant of Record, selecione Edit routing rules, abra cada rota e desative Enable processor. Processors desativados são ignorados durante o roteamento de pagamentos, e assinaturas em um processor desativado não podem ser renovadas.
Configurações BYOP após configuração mostrando opções de Editar Configuração e roteamento

​
Como funciona o roteamento

O Dodo Payments escolhe a rota com base no país de cobrança do cliente quando o pagamento é criado. A mesma regra se aplica a pagamentos únicos, sessões de checkout e novas assinaturas. As renovações reutilizam o processor no qual a assinatura foi criada (consulte Subscriptions). Em uma rota processada pelo seu processor:
  • O pagamento é processado na conta do seu processor, na moeda de cobrança.
  • O Dodo Payments não calcula nem cobra impostos. Você é responsável pelos impostos nessa rota.
  • As faturas mostram os dados comerciais e o statement descriptor configurados por você, sem os dados do Merchant of Record do Dodo Payments.
  • Seu processor faz o repasse diretamente para você. O valor do pagamento nunca entra no seu saldo do Dodo Payments; somente a taxa de billing do BYOP é registrada nele.
Em uma rota processada pelo Dodo Payments (Rest of the World), o Dodo Payments é seu Merchant of Record completo. Ele gerencia impostos, conformidade, análise de fraude e repasses agregados, além de fornecer ferramentas para prevenir e responder a disputas. Você arca com o custo das disputas nesses pagamentos.

​
Assinaturas

Uma assinatura permanece no processor no qual foi criada. Na renovação, o Dodo Payments cobra esse mesmo processor usando o payment mandate armazenado quando o cliente assinou, sem reavaliar as regras de roteamento. As atualizações do método de pagamento da assinatura passam pelo mesmo processor. O fato de o Dodo Payments calcular ou não os impostos de uma assinatura também é definido quando a assinatura é criada.

​
Ver qual processor processou um pagamento

Depois que você configura o BYOP, as tabelas Payments e Disputes mostram um ícone de processor (Stripe, Adyen ou Dodo Payments) em cada linha. As páginas de detalhes de pagamentos e disputas incluem o campo Payment Processor, para que você saiba qual rota processou uma transação.

​
Reembolsos, disputas e repasses

Inicie os reembolsos no dashboard do Dodo como de costume. Para um pagamento encaminhado pelo seu próprio processor, o Dodo Payments envia o reembolso para esse processor, que devolve os fundos; o reembolso não utiliza seu saldo do Dodo Payments. Para um pagamento encaminhado ao Dodo, o Dodo Payments processa o reembolso.

​
Analytics

Os analytics de receita, impostos e assinaturas incluem as duas rotas, para que você veja todo o seu billing em um só lugar. Os widgets de disputas e repasses mostram apenas a atividade processada pelo Dodo. A atividade no seu próprio processor também aparece no dashboard desse processor.

​
Taxa de billing

O Dodo Payments cobra uma taxa de billing do BYOP em cada pagamento encaminhado pelo seu próprio processor, porque o Dodo Payments continua gerenciando seus produtos, assinaturas, faturamento e analytics nesses pagamentos. A taxa padrão é de 0,5% do valor equivalente do pagamento em USD, e a taxa exata é confirmada quando o BYOP é habilitado para sua conta. A taxa aparece como uma entrada byop_fee no seu ledger de saldo. Para discutir sua taxa, entre em contato com a equipe.

​
Perguntas frequentes

Stripe e Adyen. Ambos exigem raw card API access na sua conta, solicitado ao suporte do processor. Consulte os guias de Stripe e Adyen.
Sim. Atribua países específicos ao seu processor e deixe o restante como Rest of the World, que o Dodo Payments processa como Merchant of Record. Cada país é encaminhado para exatamente um processor.
Você é. Nas rotas processadas pelo seu próprio processor, você continua sendo o vendedor legal e é responsável por impostos, chargebacks, conformidade com PCI e repasses nessas transações.
Não. O Dodo Payments não calcula nem cobra impostos nas rotas processadas pelo seu próprio processor; você gerencia os impostos dessas transações. O Dodo Payments continua gerenciando os impostos dos pagamentos encaminhados ao Dodo Payments como Merchant of Record.
As renovações nesse processor falham enquanto ele estiver desativado, porque cada assinatura é renovada no processor em que foi criada. Essas renovações aparecem como pagamentos com falha no dashboard.O Dodo Payments também pausa os e-mails de recuperação de pagamentos dessas assinaturas. Reative o processor para restaurar as renovações; as tentativas de recuperação pausadas serão retomadas.

​
Começar

What is Merchant of Record?

Entenda como funciona o modelo de Merchant of Record completo do Dodo Payments.
Última modificação em 26 de setembro de 2026