Skip to main content

​
Introdução

O plugin Dodo Payments para WooCommerce adiciona Dodo Payments como método de pagamento ao checkout da sua loja. Os clientes pagam na página de checkout do Dodo Payments, que exibe os métodos de pagamento disponíveis para a localização, a moeda e o dispositivo deles, como cartões, carteiras digitais e UPI. Em seguida, os webhooks do Dodo Payments atualizam o status do pedido no WooCommerce.
O plugin requer WordPress 6.1 ou posterior, PHP 7.4 ou posterior e WooCommerce 7.9 ou posterior. Para vender assinaturas, você também precisa da extensão WooCommerce Subscriptions.
O plugin funciona com o checkout clássico do WooCommerce. Ele não oferece suporte ao checkout baseado em blocos nem ao envio de produtos físicos, e aceita apenas um código de desconto percentual por pedido.

​
Guia de instalação passo a passo

  1. Baixe dodo-payments-for-woocommerce.zip da versão mais recente no GitHub.

    Download Plugin

    Obtenha a versão mais recente do plugin Dodo Payments para WooCommerce
    Você também pode instalar o plugin pelo diretório de plugins do WordPress. Na página Adicionar plugins, pesquise por Dodo Payments for WooCommerce, clique em Instalar agora, depois em Ativar e continue com o guia de configuração.

    WordPress Plugin Directory

    Instale Dodo Payments for WooCommerce pelo WordPress.org
  2. Faça login no seu site WordPress como administrador. O WooCommerce deve estar instalado e ativo.
  3. Acesse Plugins → Adicionar novo plugin.
    Barra lateral de administração do WordPress com o menu Plugins aberto
  4. Clique em Enviar plugin. Um formulário de upload será exibido.
    Página Adicionar plugins com o botão Enviar plugin
    Formulário de upload de plugin com os botões Procurar e Instalar agora
  5. Clique em Procurar… e selecione o arquivo zip baixado.
  6. Clique em Instalar agora.
    Formulário de upload de plugin com o arquivo zip selecionado e o botão Instalar agora
  7. Quando a instalação terminar, clique em Ativar plugin. Você também pode ativar o plugin mais tarde em Plugins → Plugins instalados.
    Mensagem de plugin instalado com sucesso e o botão Ativar plugin
  8. O plugin está instalado, mas ainda não foi configurado. Continue com o guia de configuração abaixo.

​
Guia de configuração

​
Configuração de API Keys e Webhooks

O plugin precisa de dois valores para cada modo do Dodo Payments: uma API key para criar checkouts e uma chave de assinatura de webhook para verificar os webhooks que atualizam seus pedidos. Estas etapas configuram o modo live.
  1. Acesse WooCommerce → Settings → Payments ou clique em Payments em WooCommerce na barra lateral.
    Configurações de pagamento do WooCommerce com Dodo Payments ativo e um botão Manage
    Menu da barra lateral do WooCommerce com Payments destacado
  2. Ative Dodo Payments se ele ainda não estiver ativo e clique em Manage.
  3. As configurações do plugin são abertas, com uma descrição abaixo de cada opção. Verifique se Enable Dodo Payments está selecionado e comece com Live API Key.
    Configurações do plugin Dodo Payments com os campos Enable/Disable, Title, Description, Instructions, Test Mode e Live API Key
  4. No dashboard do Dodo Payments, ative o seletor Live Mode na barra lateral. Acesse Developer → API Keys ou use este link direto e clique em Add API key.
    Página API Keys do Dodo Payments sem chaves e com um botão Add API key
  5. Insira um nome para a chave, como WooCommerce Plugin, e clique em Create.
    Caixa de diálogo Create New API com o nome da chave WooCommerce Plugin e um botão Create
  6. Clique em Copy API Key. O dashboard mostra a chave apenas uma vez. Cole-a em Live API Key nas configurações do plugin.
    Caixa de diálogo New API key com os botões Copy API Key e Close
    Campo Live API Key nas configurações do plugin
  7. Em seguida, configure a signing key do webhook. O Dodo Payments envia atualizações de pagamento à sua loja por webhook, e o plugin usa a chave para verificar se cada webhook vem do Dodo Payments.
  8. Na parte inferior das configurações do plugin, em Webhook Endpoint, copie a URL. Ela tem o formato https://your-store.com/?wc-api=dodo_payments.
    URL do Webhook Endpoint na parte inferior das configurações do plugin, acima do botão Save changes
  9. No dashboard do Dodo Payments, ainda no modo live, acesse Developer → Webhooks e clique em Add endpoint.
    Página Webhooks no modo live sem endpoints e com um botão Add endpoint
  10. Cole a URL da etapa 8 em Endpoint URL. Deixe Subscribed events vazio para receber todos os eventos ou selecione apenas os eventos de pagamento, reembolso e assinatura, que são os eventos tratados pelo plugin. Em seguida, clique em Create endpoint.
    Caixa de diálogo Add endpoint com a URL do webhook do WooCommerce em Endpoint URL
  11. A aba Overview do endpoint é aberta. Em Signing secret, clique no ícone de olho para revelar o segredo e, em seguida, clique no ícone de cópia.
    Aba Overview do endpoint com o signing secret oculto, os ícones de revelar e copiar e Rotate secret
  12. Cole o segredo em Live Webhook Signing Key nas configurações do plugin e clique em Save changes.
    Campo Live Webhook Signing Key nas configurações do plugin
  13. Revise Global Tax Category e All Prices are Tax Inclusive. O plugin aplica essas opções ao criar um produto no Dodo Payments, o que acontece na primeira vez que um cliente finaliza a compra do produto. Depois disso, o produto mantém as configurações fiscais definidas no dashboard do Dodo Payments, onde você pode alterá-las por produto. Test API Key e Test Webhook Signing Key são necessários apenas para o Test Mode.
    Configurações Test API Key, Test Webhook Signing Key, Global Tax Category e All Prices are Tax Inclusive
Em Checkout Feature Flags, você também pode controlar opções da página de checkout do Dodo Payments, como Allow Currency Selection e Allow Discount Codes. Uma flag deixada como Default não é enviada, então o Dodo Payments aplica seu próprio padrão.
Para aceitar pagamentos de teste, ative o Test Mode nas configurações do plugin. O plugin passa a usar Test API Key e Test Webhook Signing Key e se conecta ao ambiente de teste do Dodo Payments. O modo de teste tem suas próprias API keys e endpoints de webhook. Para obtê-las, desative o seletor Live Mode no dashboard, siga as etapas 4 a 12 no modo de teste e cole os valores nos campos de teste. Desative o Test Mode antes de entrar em produção.

​
Está tudo pronto!

Os clientes agora podem escolher Dodo Payments no checkout.
Página de checkout do WooCommerce com o formulário de cobrança e o botão Place order
Quando um cliente faz um pedido, o plugin o direciona à página de checkout do Dodo Payments para efetuar o pagamento. Após o pagamento, o Dodo Payments envia um webhook, e o plugin atualiza o status do pedido.
Página de checkout do Dodo Payments com opções de pagamento por cartão, QR code UPI e UPI ID

​
Principais recursos

  • Hosted Checkout: Os clientes pagam em uma página de checkout do Dodo Payments e depois retornam à página de confirmação do pedido na sua loja.
  • Multiple Payment Methods: O checkout exibe os métodos de pagamento disponíveis para a localização, a moeda e o dispositivo de cada cliente.
  • Order Status Sync: Webhooks definem o pedido como Completed, Processing, Failed ou Cancelled conforme o status do pagamento muda. Pagamentos com falha ou cancelados devolvem os itens ao estoque.
  • Refunds: Emita reembolsos no dashboard do Dodo Payments. Quando um reembolso é concluído, o plugin define o pedido como Refunded.
  • Subscriptions: Com o WooCommerce Subscriptions, as alterações de status são sincronizadas nos dois sentidos, inclusive quando uma assinatura é cancelada, suspensa ou reativada. Alterações nas datas da assinatura no WooCommerce não são sincronizadas.
  • Order Notes: O plugin adiciona notas ao pedido para cada sessão de checkout, alteração de status e erro, permitindo acompanhar cada pagamento na página do pedido.
  • Multi-currency Support: Os produtos são sincronizados com o Dodo Payments na moeda da sua loja WooCommerce. A flag Allow Currency Selection controla se os clientes podem alterar a moeda no checkout.

​
Solução de problemas

​
Problemas comuns

  1. Falhas no processamento de pagamentos
    • Verifique se a API key corresponde ao modo do plugin. Com o Test Mode desativado, o plugin usa Live API Key, que deve vir do dashboard no modo live. Com o Test Mode ativado, ele usa Test API Key.
    • Verifique as notas do pedido. Quando o plugin não consegue criar um checkout, ele adiciona uma nota com o erro, como uma que começa com Dodo Payments Error:.
    • Se o Dodo Payments não aparecer no checkout, verifique se a página de checkout usa o checkout clássico, e não o bloco Checkout.
    • Se o pedido tiver um código de desconto, verifique se ele é um código percentual único.
    • Os pagamentos live começam depois que sua conta é aprovada no processo de verificação da conta.
  2. Problemas de sincronização de webhook
    • Verifique se Endpoint URL é exatamente a URL exibida em Webhook Endpoint nas configurações do plugin.
    • Verifique se a signing key no plugin corresponde ao Signing secret do endpoint e se ambas vêm do mesmo modo.
    • Verifique o log de erros do PHP em busca de linhas que começam com Dodo Payments:, como Dodo Payments: Could not verify webhook event. No modo live, o plugin retorna 200 mesmo quando a verificação falha, então os logs do Dodo Payments mostram a entrega como bem-sucedida. No Test Mode, ele retorna 401.
    • Verifique se o site tem um certificado SSL válido. Endpoint URL aceita apenas URLs HTTPS.
    • Verifique se o servidor, o firewall e os plugins de segurança aceitam solicitações POST para a URL do webhook a partir dos endereços IP do Dodo Payments.
    • Abra a aba Logs em Developer → Webhooks para ver cada entrega e a resposta do seu site.

​
Recursos de suporte

Para obter mais ajuda:

​
Práticas recomendadas de manutenção

  1. Atualize o plugin quando uma nova versão for lançada para obter correções de segurança e novos recursos.
  2. Teste todos os fluxos de pagamento no Test Mode antes de aceitar pagamentos live.
  3. Mantenha o WordPress e o WooCommerce atualizados.
  4. Faça backups do site regularmente.
  5. Monitore seus pedidos e o dashboard do Dodo Payments em busca de atividades incomuns.
  6. Armazene as API keys com segurança e nunca as compartilhe publicamente.
Última modificação em 26 de setembro de 2026