Começando & Configuração da Conta
Q1: Como faço para fazer login no Painel do Dodo Payments?
Q1: Como faço para fazer login no Painel do Dodo Payments?
Q2: Quais documentos eu preciso para completar o processo de verificação?
Q2: Quais documentos eu preciso para completar o processo de verificação?
Q3: O que acontece se minha verificação for rejeitada?
Q3: O que acontece se minha verificação for rejeitada?
Q4: Quanto tempo leva o processo de verificação?
Q4: Quanto tempo leva o processo de verificação?
Q5: Atualmente não tenho um site para meu negócio. Posso enviar a página do linkedin da minha empresa em vez disso?
Q5: Atualmente não tenho um site para meu negócio. Posso enviar a página do linkedin da minha empresa em vez disso?
Q6: Sou um indivíduo e não tenho um negócio registrado. Posso ainda usar o Dodo Payments?
Q6: Sou um indivíduo e não tenho um negócio registrado. Posso ainda usar o Dodo Payments?
Q7: Quero integrar meu outro negócio com o Dodo Payments. Devo criar uma nova conta?
Q7: Quero integrar meu outro negócio com o Dodo Payments. Devo criar uma nova conta?
Q8: Devo esperar a verificação ser concluída antes de integrar o Dodo Payments no meu sistema?
Q8: Devo esperar a verificação ser concluída antes de integrar o Dodo Payments no meu sistema?
Q9: Como obter acesso ao modo ao vivo?
Q9: Como obter acesso ao modo ao vivo?
Q10: O Dodo Payments tem um programa de afiliados?
Q10: O Dodo Payments tem um programa de afiliados?
Saiba mais sobre nosso programa de afiliados
Q11: Como posso excluir os produtos/clientes que criei?
Q11: Como posso excluir os produtos/clientes que criei?
Q12: Como posso ter uma interface personalizada para a página de pagamentos?
Q12: Como posso ter uma interface personalizada para a página de pagamentos?
Q13: Posso atualizar a marca na página de checkout?
Q13: Posso atualizar a marca na página de checkout?
- Ir para Painel → Configurações → Configuração do Negócio
- Atualizar seu logotipo, nome da marca e e-mail de suporte.
- As alterações serão refletidas em links estáticos e dinâmicos
Q14: Posso incorporar o Dodo Checkout em um iframe?
Q14: Posso incorporar o Dodo Checkout em um iframe?
- Redirecione os usuários para a URL de checkout do Dodo
- Ou use nosso Recurso de Checkout em Sobreposição. Documentos de Checkout em Sobreposição
Q15: Posso criar um pagamento de checkout hospedado único sem adicionar produtos ao Dodo Payments?
Q15: Posso criar um pagamento de checkout hospedado único sem adicionar produtos ao Dodo Payments?
Q16: Vocês suportam sites de e-commerce?
Q16: Vocês suportam sites de e-commerce?
Q17: Posso alternar entre marcas no Dodo Payments?
Q17: Posso alternar entre marcas no Dodo Payments?
Q18: Posso excluir uma marca ou atualizar a URL da Marca no Dodo Payments?
Q18: Posso excluir uma marca ou atualizar a URL da Marca no Dodo Payments?
- Excluir uma marca: Se uma marca não estiver em uso, você pode simplesmente ignorá-la — isso não afetará sua conta ou operações
- Alterar ou atualizar a URL da Marca: Uma vez criada, a URL da Marca não pode ser modificada. Mesmo que a URL esteja incorreta, isso não impacta sua configuração ou funcionalidade
Q19: Posso integrar o Dodo Payments com Shopify para vender produtos físicos?
Q19: Posso integrar o Dodo Payments com Shopify para vender produtos físicos?
Verificação, Imposto & Conformidade
Q20: Por que minha verificação está demorando tanto?
Q20: Por que minha verificação está demorando tanto?
- Alto volume de aplicações
- Fins de semana e feriados
- Submissões incompletas ou incorretas
- Revisões manuais para risco ou conformidade
Q21: Enviei meu formulário W-8BEN, mas a seção de assinatura não funciona corretamente. O que devo fazer?
Q21: Enviei meu formulário W-8BEN, mas a seção de assinatura não funciona corretamente. O que devo fazer?
- Adobe Acrobat
- Mac Preview (funciona para a maioria)
- Smallpdf ou PDFescape (editores online)
- Você está salvando o arquivo após aplicar a assinatura.
- A ferramenta está achatando a camada de assinatura (alguns editores não fazem isso).
Q22: Escolhi o tipo de registro errado (empresa vs indivíduo). Como posso corrigir isso?
Q22: Escolhi o tipo de registro errado (empresa vs indivíduo). Como posso corrigir isso?
Q23: Minha verificação foi recusada devido a incompatibilidade de entidade. O que devo fazer?
Q23: Minha verificação foi recusada devido a incompatibilidade de entidade. O que devo fazer?
Q24: Alcancei $100 em ganhos. Minha conta será verificada mais rapidamente?
Q24: Alcancei $100 em ganhos. Minha conta será verificada mais rapidamente?
Q25: Posso usar um nome diferente (como o de meu pai) para me inscrever e ser verificado?
Q25: Posso usar um nome diferente (como o de meu pai) para me inscrever e ser verificado?
- Ele deve se inscrever usando seu e-mail e número de celular.
- Todos os documentos devem estar em seu nome.
Q26: Como posso verificar o motivo da rejeição da verificação?
Q26: Como posso verificar o motivo da rejeição da verificação?
- O painel do Dodo Payments, na seção de verificação.
- Notificações por e-mail (se habilitadas)
Q27: Posso criar uma nova conta de negócios se a minha anterior foi recusada?
Q27: Posso criar uma nova conta de negócios se a minha anterior foi recusada?
- Você corrigiu os problemas que levaram à rejeição.
- Você não está tentando contornar decisões de risco (por exemplo, desativação por preocupações de fraude).
Q28: Fui informado de que minha conta foi anteriormente desativada. O que isso significa?
Q28: Fui informado de que minha conta foi anteriormente desativada. O que isso significa?
- Isso significa que o Dodo Payments encontrou problemas significativos de conformidade ou risco com sua atividade ou negócio.
- Tentar criar novas contas usando a mesma identidade ou detalhes de negócios provavelmente será rejeitado novamente.
Q29: Como posso acelerar a verificação de pagamento?
Q29: Como posso acelerar a verificação de pagamento?
- Envie documentos claros e formatados corretamente
- Evite mensagens/tag repetidas no Discord — isso desacelera a fila
- Mencione se você ultrapassou o limite de pagamento ou tem prazos urgentes
- Envie uma DM para seu ID de e-mail registrado, se solicitado
Q30: E se eu escolhi o formulário errado (W-8BEN vs W-8BEN-E)?
Q30: E se eu escolhi o formulário errado (W-8BEN vs W-8BEN-E)?
- W-8BEN é para Indivíduos
- W-8BEN-E é para Organizações
- Entre em contato com o suporte para redefinir seu formulário.
- Preencha e envie o tipo de formulário correto.
- Certifique-se de que o PAN esteja no campo correto (Linha 6a para indivíduos).
Q31: Tenho um GST com um nome comercial. Isso é considerado uma organização?
Q31: Tenho um GST com um nome comercial. Isso é considerado uma organização?
Q32: Minha conta foi desativada. Posso apenas criar uma nova?
Q32: Minha conta foi desativada. Posso apenas criar uma nova?
- A nova conta também pode ser sinalizada ou rejeitada
- Decisões de risco se aplicam a todas as inscrições se o negócio ou a pessoa subjacente forem os mesmos
Q33: Como o Dodo Payments lida com GST para comerciantes de SaaS indianos?
Q33: Como o Dodo Payments lida com GST para comerciantes de SaaS indianos?
Q34: O Dodo Payments lida com vendas internacionais?
Q34: O Dodo Payments lida com vendas internacionais?
Q35: Os dados de endereço, como cidade, estado e código postal, são obrigatórios? Posso excluir a solicitação desses valores do meu cliente?
Q35: Os dados de endereço, como cidade, estado e código postal, são obrigatórios? Posso excluir a solicitação desses valores do meu cliente?
Q36: Preciso declarar impostos nos EUA se vender lá?
Q36: Preciso declarar impostos nos EUA se vender lá?
- Declarar imposto de renda em seu país de origem (por exemplo, Índia)
- Enviar W-8BEN(-E) para evitar a retenção padrão de 30% nos EUA
Q37: Não sei se devo preencher W-8BEN ou W-8BEN-E — ajuda?
Q37: Não sei se devo preencher W-8BEN ou W-8BEN-E — ajuda?
| Você é… | Formulário a Enviar | Tipo de Comerciante |
|---|---|---|
| Proprietário Único, Freelancer, Indivíduo | W-8BEN | Indivíduo |
| Pvt Ltd, LLP, Organização Registrada | W-8BEN-E | Organização |
- Se sua conta bancária estiver em seu nome pessoal, você provavelmente é um Indivíduo → Use W-8BEN
- Se sua conta bancária estiver em nome de uma empresa, você é uma Organização → Use W-8BEN-E
- Se você tem um GST, mas opera com uma conta bancária pessoal, você ainda é considerado um Indivíduo → Use W-8BEN
Q38: Preciso de um PAN ou GST para receber pagamentos?
Q38: Preciso de um PAN ou GST para receber pagamentos?
Q39: Tenho um certificado Udyam/MSME. Devo enviar W-8BEN ou W-8BEN-E?
Q39: Tenho um certificado Udyam/MSME. Devo enviar W-8BEN ou W-8BEN-E?
- Se você opera com uma conta bancária pessoal (mesmo com o certificado Udyam/MSME): Você é considerado um Indivíduo → Envie W-8BEN
- Se você opera com uma conta bancária de empresa (entidade registrada): Você é uma Organização → Envie W-8BEN-E
Q40: Se o Dodo lida com impostos, por que preciso preencher W-8BEN(-E)?
Q40: Se o Dodo lida com impostos, por que preciso preencher W-8BEN(-E)?
Pagamentos & Transações
Q41: Que tipos de pagamentos posso aceitar com o Dodo Payments?
Q41: Que tipos de pagamentos posso aceitar com o Dodo Payments?
Q42: Por que o primeiro pagamento foi marcado como bem-sucedido com um valor de $0 para a assinatura?
Q42: Por que o primeiro pagamento foi marcado como bem-sucedido com um valor de $0 para a assinatura?
Q43: Após o término do período de teste, o cliente precisa pagar (preço do produto (por exemplo, $25)) novamente manualmente?
Q43: Após o término do período de teste, o cliente precisa pagar (preço do produto (por exemplo, $25)) novamente manualmente?
Q44: E se o período de teste mostrar de forma diferente no meu aplicativo em comparação com o painel do Dodo Payments?
Q44: E se o período de teste mostrar de forma diferente no meu aplicativo em comparação com o painel do Dodo Payments?
Q45: Preciso testar o recurso de teste antes de ir ao vivo?
Q45: Preciso testar o recurso de teste antes de ir ao vivo?
Q46: Como posso rastrear os status dos pagamentos?
Q46: Como posso rastrear os status dos pagamentos?
Q47: O que devo fazer se um pagamento falhar?
Q47: O que devo fazer se um pagamento falhar?
Q48: Os comerciantes são notificados quando o pagamento de um usuário falha?
Q48: Os comerciantes são notificados quando o pagamento de um usuário falha?
- Notificações por e-mail
- Eventos de webhook
- Notificações móveis
- Notificações no painel Isso garante que os comerciantes fiquem informados sobre transações falhadas.
Q49: O que acontece com uma assinatura se um pagamento falhar?
Q49: O que acontece com uma assinatura se um pagamento falhar?
- Clicando na assinatura em espera no seu painel e usando o botão Atualizar Método de Pagamento
- Ou usando o endpoint da API: https://docs.dodopayments.com/api-reference/subscriptions/update-payment-method
Q50: Se eu tentar pagamentos novamente, preciso do ID do pagamento falhado?
Q50: Se eu tentar pagamentos novamente, preciso do ID do pagamento falhado?
Q51: Como um pagamento de assinatura pode falhar com INCORRECT_NUMBER se os ciclos anteriores foram bem-sucedidos?
Q51: Como um pagamento de assinatura pode falhar com INCORRECT_NUMBER se os ciclos anteriores foram bem-sucedidos?
Q52: O chargeback se aplica ao negócio mesmo que minha empresa tenha uma política de não reembolso?
Q52: O chargeback se aplica ao negócio mesmo que minha empresa tenha uma política de não reembolso?
Q53: Por que payment.status às vezes é nulo?
Q53: Por que payment.status às vezes é nulo?
- Logo após a criação, mas antes que o processamento seja concluído
- Durante falhas de cobrança de assinatura ou tentativas
Q54: Por que product_cart é nulo mesmo sendo um checkout?
Q54: Por que product_cart é nulo mesmo sendo um checkout?
- Para pagamentos de assinatura, product_cart está vazio porque não há um item único sendo comprado
- product_cart só é preenchido para pagamentos únicos
Q55: Por que meu cartão real foi bloqueado durante os testes?
Q55: Por que meu cartão real foi bloqueado durante os testes?
- Usam dinheiro real
- Passam por bancos reais
- Podem ser sinalizados como suspeitos se o volume for baixo ou inconsistente
- Modo de Teste no painel
- Números de cartão de teste fornecidos na documentação
Q56: Meu cliente completou o pagamento, mas não recebi o webhook?
Q56: Meu cliente completou o pagamento, mas não recebi o webhook?
- Confirme se o webhook está configurado em Painel > Desenvolvedores -> Webhooks
- Verifique se o webhook está falhando silenciosamente devido a uma resposta não-2xx
- Verifique os logs: foi retornado um 429 ou timeout?
Q57: Por que meu painel mostra sucesso, mas meu aplicativo não foi atualizado?
Q57: Por que meu painel mostra sucesso, mas meu aplicativo não foi atualizado?
- Webhooks
- Chamada de confirmação da API
- Sempre ouça o webhook payment.succeeded
- Ou consulte a API para confirmar a transação após o redirecionamento
Q58: Não estou vendo UPI como uma opção de pagamento — por quê?
Q58: Não estou vendo UPI como uma opção de pagamento — por quê?
- O país de cobrança não foi definido como IN
- O UPI não foi habilitado para o seu negócio
Q59: O Dodo suporta UPI para assinaturas?
Q59: O Dodo suporta UPI para assinaturas?
- Limites de Mandato:
- Cobranças abaixo de ₹15.000: Um mandato sob demanda de ₹15.000 INR é criado
- Cobranças de ₹15.000 ou mais: Um mandato de assinatura para o valor exato da assinatura é criado
- Atraso de Processamento de 48 Horas: As cobranças são iniciadas na data programada, mas a dedução real ocorre 48 horas após a iniciação (pode se estender por até 2-3 horas adicionais)
- Cancelamento de Mandato: Os clientes podem cancelar mandatos através de seus aplicativos bancários durante a janela de 48 horas
Q60: Como habilito Google Pay / Apple Pay em links de pagamento estáticos?
Q60: Como habilito Google Pay / Apple Pay em links de pagamento estáticos?
Q61: Como posso habilitar 3DS no Dodo Payments?
Q61: Como posso habilitar 3DS no Dodo Payments?
Q62: Como posso coletar detalhes de cobrança sem passá-los na API?
Q62: Como posso coletar detalhes de cobrança sem passá-los na API?
- Use links estáticos, que coletam automaticamente a cobrança
- Para fluxos dinâmicos, você deve coletar as informações manualmente e passá-las na API
Q63: Qual é a diferença entre links de pagamento estáticos e dinâmicos?
Q63: Qual é a diferença entre links de pagamento estáticos e dinâmicos?
- São configurados a partir do painel
- Coletam automaticamente informações de cobrança
- Não podem ser personalizados por cliente/sessão
- Exigem que você passe as informações de cobrança explicitamente
- Podem ser personalizados em tempo real (preço, ID do usuário, URL de redirecionamento, etc.)
Q64: Receberei dois eventos de webhook quando alguém iniciar uma assinatura?
Q64: Receberei dois eventos de webhook quando alguém iniciar uma assinatura?
subscription.createdwebhookpayment.succeededwebhooksubscription.renewalwebhook
Q65: O que significa subscription.cancelled_at? É um cancelamento programado?
Q65: O que significa subscription.cancelled_at? É um cancelamento programado?
- Cancelamento imediato: O timestamp subscription.cancelled_at é definido imediatamente e a assinatura termina naquele momento
- Cancelamento programado: Use o parâmetro
cancel_at_next_billing_datena API de patch de assinatura para cancelar no final do período de cobrança atual
Q66: Quando uma assinatura é cobrada?
Q66: Quando uma assinatura é cobrada?
Q67: Por que a API de Alterar Plano retorna uma resposta vazia?
Q67: Por que a API de Alterar Plano retorna uma resposta vazia?
Q68: Por que não foi solicitado um novo pagamento ao mudar de um plano mensal para um anual?
Q68: Por que não foi solicitado um novo pagamento ao mudar de um plano mensal para um anual?
Q69: Por que o preço do meu produto (₹100) mostra um valor maior (₹104) durante o checkout?
Q69: Por que o preço do meu produto (₹100) mostra um valor maior (₹104) durante o checkout?
Q70: Por que o checkout ignora assinaturas ativas existentes e cria uma nova?
Q70: Por que o checkout ignora assinaturas ativas existentes e cria uma nova?
Q71: Por que estou vendo um erro TRANSACTION_NOT_ALLOWED durante uma atualização/redução de assinatura?
Q71: Por que estou vendo um erro TRANSACTION_NOT_ALLOWED durante uma atualização/redução de assinatura?
- Cartão não permitido para pagamentos online, internacionais ou recorrentes
- Categoria de comerciante (MCC) bloqueada
- Regras de fraude do banco impediram a cobrança
- Cartões pré-pagos ou restritos podem não suportar esses pagamentos
Q72: Existe uma maneira de testar no modo ao vivo sem fazer pagamentos reais?
Q72: Existe uma maneira de testar no modo ao vivo sem fazer pagamentos reais?
Q73: O que é o método de pagamento de $0?
Q73: O que é o método de pagamento de $0?
Q74: Parece que minha conta está suspensa, mas a conformidade diz que está tudo bem. O que devo fazer?
Q74: Parece que minha conta está suspensa, mas a conformidade diz que está tudo bem. O que devo fazer?
Pagamentos & Integração Bancária
Q75: Como funcionam os pagamentos com o Dodo Payments?
Q75: Como funcionam os pagamentos com o Dodo Payments?
- Bimestral (Padrão):
- Período de Cobrança 1: 1 a 15 → Pagamento no dia 18 do mesmo mês
- Período de Cobrança 2: 16 até o final do mês → Pagamento no dia 4 do mês seguinte
- Semanal: Disponível para negócios com volumes de transação mais altos (entre em contato com o suporte para solicitar)
- Mensal:
- Período de Cobrança: 1 até o final do mês → Pagamento no dia 11 do mês seguinte
Q76: Qual é o valor mínimo de limite após taxas e impostos para processar pagamentos?
Q76: Qual é o valor mínimo de limite após taxas e impostos para processar pagamentos?
Q77: Como vinculo minha conta bancária para receber pagamentos?
Q77: Como vinculo minha conta bancária para receber pagamentos?
Q78: Posso rastrear o status dos meus pagamentos?
Q78: Posso rastrear o status dos meus pagamentos?
Q79: Quais são as taxas de pagamento e quanto elas são?
Q79: Quais são as taxas de pagamento e quanto elas são?
Q80: Recebi um e-mail de 'pagamento processado' — quando os fundos chegarão?
Q80: Recebi um e-mail de 'pagamento processado' — quando os fundos chegarão?
Q81: Como adiciono o Payoneer como uma conta de pagamento?
Q81: Como adiciono o Payoneer como uma conta de pagamento?
Q82: Posso receber pagamentos em uma conta Payoneer?
Q82: Posso receber pagamentos em uma conta Payoneer?
- Inserindo os detalhes da sua conta Payoneer no Formulário de Informações Bancárias no painel do Dodo
- Certifique-se de que sua conta esteja aprovada e suporte USD ou a moeda que você está retirando
Q83: Minhas informações bancárias e formulário de conformidade ainda estão em revisão — o que devo fazer?
Q83: Minhas informações bancárias e formulário de conformidade ainda estão em revisão — o que devo fazer?
- Envie um e-mail para [email protected]
Q84: O que acontece se meu dia de pagamento cair em uma sexta-feira ou fim de semana?
Q84: O que acontece se meu dia de pagamento cair em uma sexta-feira ou fim de semana?
- Se houver um feriado bancário ou fim de semana, pode ser adiado para o próximo dia útil (geralmente segunda-feira).
- O horário exato pode depender das regras de processamento do seu banco.
Q85: Como posso acelerar a conformidade de pagamento se eu tiver um lançamento urgente ou campanha publicitária planejada?
Q85: Como posso acelerar a conformidade de pagamento se eu tiver um lançamento urgente ou campanha publicitária planejada?
- Mencione sua urgência claramente nas conversas de suporte (por exemplo, lançamento ao vivo, campanhas pagas).
- Inclua seu ID de negócio e e-mail.
- Evite spamar ou marcar vários membros da equipe — isso pode desacelerar a fila.
Q86: Enviei os detalhes da conta bancária errados. Como posso atualizá-los?
Q86: Enviei os detalhes da conta bancária errados. Como posso atualizá-los?
- Entre em contato com o suporte via Intercom ou Discord ou e-mail.
- Envie uma DM com seu ID de e-mail e solicite uma redefinição manual da seção de verificação bancária se você entrar pelo Discord.
- Aguarde a equipe de conformidade reabrir a seção para você reenviar.
Q87: Posso usar minha conta bancária pessoal se eu tiver uma empresa registrada?
Q87: Posso usar minha conta bancária pessoal se eu tiver uma empresa registrada?
Q88: Meu país não usa códigos SWIFT. Como isso afetará minha verificação?
Q88: Meu país não usa códigos SWIFT. Como isso afetará minha verificação?
- Entre em contato com o suporte e explique que seu país não emite códigos SWIFT
- Envie documentos bancários oficiais que confirmem:
- Seu número da conta
- Nome do titular da conta
- Que nenhum código SWIFT é emitido em seu país
- Em alguns casos, um código SWIFT genérico pode ser usado com base no seu país
Q89: Que documentação alternativa posso fornecer se meu país não usar códigos SWIFT?
Q89: Que documentação alternativa posso fornecer se meu país não usar códigos SWIFT?
- Extrato bancário oficial ou certificado mostrando os detalhes da sua conta
- Carta do banco confirmando seu número da conta, nome do titular e que códigos SWIFT não são emitidos
- Qualquer documento emitido pelo governo que confirme o formato das informações de roteamento do seu banco
Faturamento & Relatórios
Q90: O Dodo Payments gera faturas automaticamente?
Q90: O Dodo Payments gera faturas automaticamente?
Q91: Posso personalizar as faturas?
Q91: Posso personalizar as faturas?
Q92: Como acesso ou baixo uma fatura?
Q92: Como acesso ou baixo uma fatura?
Q93: Como vejo relatórios sobre minhas transações e pagamentos?
Q93: Como vejo relatórios sobre minhas transações e pagamentos?
Reembolsos & Disputas
Q94: Como faço para emitir um reembolso?
Q94: Como faço para emitir um reembolso?
Q95: Quanto tempo leva para um cliente receber seu reembolso?
Q95: Quanto tempo leva para um cliente receber seu reembolso?
Q96: Estou enfrentando uma disputa ou chargeback. O que posso fazer?
Q96: Estou enfrentando uma disputa ou chargeback. O que posso fazer?
- Você pode perder tanto o valor da transação quanto uma taxa de disputa
- Você pode enviar evidências de entrega do produto, registros de uso ou comunicação com o cliente
- No entanto, a decisão final cabe ao banco emissor do cliente
- ID da Disputa
- ID do Pagamento
- Provas relevantes
Q97: O cliente contestou a cobrança após usar o serviço. Posso apelar isso?
Q97: O cliente contestou a cobrança após usar o serviço. Posso apelar isso?
- Compartilhar documentação (registros de chat, registros de uso, confirmação de entrega)
- Explicar que o serviço foi cumprido
- Solicitar a isenção da taxa de disputa se for um problema de primeira vez ou se a fraude for comprovável
Webhooks & Integração
Q98: Posso verificar manualmente os webhooks do Dodo Payments em Python?
Q98: Posso verificar manualmente os webhooks do Dodo Payments em Python?
Q99: Onde posso encontrar a documentação oficial sobre verificação manual de webhooks?
Q99: Onde posso encontrar a documentação oficial sobre verificação manual de webhooks?
Q100: Meu webhook não está recebendo uma solicitação POST, apenas uma GET. Por quê?
Q100: Meu webhook não está recebendo uma solicitação POST, apenas uma GET. Por quê?
?subscription_id=...&status=active em uma solicitação GET. Esta não é sua webhook.Para receber cargas úteis POST estruturadas do Dodo Payments:- Configure um webhook em Painel → Desenvolvedores → Webhooks
- Certifique-se de que a URL aceite solicitações POST e verifique a assinatura
Q101: Estou recebendo um erro 401 Unauthorized usando o SDK Python. Por quê?
Q101: Estou recebendo um erro 401 Unauthorized usando o SDK Python. Por quê?
Q102: Existe uma maneira de acionar manualmente um evento de webhook para teste?
Q102: Existe uma maneira de acionar manualmente um evento de webhook para teste?
Q103: Qual é a diferença entre webhook e URL de redirecionamento?
Q103: Qual é a diferença entre webhook e URL de redirecionamento?
- Webhook URL: Configurado no painel. Recebe cargas úteis POST sobre eventos.
- Redirect URL: Enviado na solicitação da API de pagamento. Envia o usuário de volta ao seu aplicativo com parâmetros de consulta (
?status=success).
Q104: Por que não recebi o ID do produto no webhook payment.succeeded para um produto de assinatura?
Q104: Por que não recebi o ID do produto no webhook payment.succeeded para um produto de assinatura?
subscription_id associado à assinatura, junto com outros detalhes relevantes.Q105: Como posso verificar se os webhooks que recebo são realmente do dodo payments e não de atores maliciosos?
Q105: Como posso verificar se os webhooks que recebo são realmente do dodo payments e não de atores maliciosos?
- Verifique a Assinatura: Cada webhook enviado pelo Dodo Payments inclui uma assinatura única no cabeçalho
webhook-signature. Esta assinatura é gerada usando a chave secreta do seu webhook e a carga útil do evento. - Recupere a Chave Secreta: Certifique-se de ter a chave secreta para seu webhook, que pode ser encontrada no painel do Dodo Payments sob as configurações de Webhooks.
- Recalcule a Assinatura: Use o mesmo algoritmo de assinatura (HMAC-SHA256) que o Dodo Payments para calcular a assinatura em seu servidor. Use a carga útil do webhook e sua chave secreta do webhook.
- Compare as Assinaturas: Compare a assinatura recalculada com a fornecida no cabeçalho
webhook-signature. Se elas coincidirem, o webhook é autêntico; se não, deve ser rejeitado. - Use HTTPS: Certifique-se de que seu endpoint de webhook use HTTPS para proteger a comunicação e evitar adulterações durante a transmissão de dados. Ao implementar esses passos, você pode verificar com confiança a autenticidade dos webhooks enviados pelo Dodo Payments.
Q106: Por que estou recebendo um webhook subscription.renew mesmo para o pagamento do primeiro mês?
Q106: Por que estou recebendo um webhook subscription.renew mesmo para o pagamento do primeiro mês?
subscription.renew será acionado sempre que o valor da assinatura for deduzido. Portanto, sim, esse é um comportamento esperado.Q107: Como posso testar webhooks localmente?
Q107: Como posso testar webhooks localmente?
- Use uma Ferramenta de Túnel: Ferramentas como ngrok, LocalTunnel ou Cloudflare Tunnel podem expor seu servidor local à internet. Isso fornece uma URL pública que o Dodo Payments pode usar para enviar eventos de webhook para seu ambiente local.
- Configure o Endpoint do Webhook: Crie um endpoint de webhook em sua aplicação local para lidar com eventos de webhook recebidos. Certifique-se de que ele escute solicitações HTTP POST.
- Configure o Webhook no Dodo Payments: Vá para o painel do Dodo Payments, navegue até as configurações de Webhooks e atualize a URL do webhook para a URL pública gerada pela ferramenta de túnel.
Q108: Por que meu webhook não está sendo chamado após o pagamento?
Q108: Por que meu webhook não está sendo chamado após o pagamento?
- Você não confundiu a URL do webhook com a URL de redirecionamento
- O webhook está configurado em Desenvolvedores > Webhooks
- Sua URL aceita solicitações POST e responde com 2xx
- A validação da assinatura (se habilitada) está implementada corretamente
Q109: É seguro confiar em status=success nos parâmetros de consulta da URL?
Q109: É seguro confiar em status=success nos parâmetros de consulta da URL?
- Valide a transação novamente com uma chamada de API
- Ou aguarde o webhook payment.succeeded
Q110: Posso integrar o Dodo Payments com meu site ou plataforma existente?
Q110: Posso integrar o Dodo Payments com meu site ou plataforma existente?
Testes & Desenvolvimento Local
Q111: Posso testar assinaturas no Modo de Teste?
Q111: Posso testar assinaturas no Modo de Teste?
Q112: Como faço para alternar entre o Modo de Teste e o Modo Ao Vivo?
Q112: Como faço para alternar entre o Modo de Teste e o Modo Ao Vivo?
- No seu painel do Dodo, procure um botão de alternância do Modo de Teste.
- Ative-o para usar chaves de API de teste e simular pagamentos.
Q113: Posso usar dados reais de clientes no Modo de Teste?
Q113: Posso usar dados reais de clientes no Modo de Teste?
- Nenhum dinheiro real será transferido
- Você pode simular webhooks e fluxos
- Os detalhes do cartão ainda devem ser cartões de teste
Q114: Estou recebendo: 'Você deve fornecer um mandato para pagamentos de cartão fora da sessão'
Q114: Estou recebendo: 'Você deve fornecer um mandato para pagamentos de cartão fora da sessão'
- Um cartão indiano está sendo usado para fazer o pagamento, mas o país de cobrança não está definido como IN.
- Você provavelmente passou um país de cobrança incorreto.
Suporte & Comunicação
Q115: Como faço para entrar em contato com o suporte?
Q115: Como faço para entrar em contato com o suporte?
Q116: Minhas mensagens de suporte não estão recebendo resposta. O que devo fazer?
Q116: Minhas mensagens de suporte não estão recebendo resposta. O que devo fazer?
- Intercom sem resposta
- Discord sem reconhecimento
- Escale via [email protected] ou [email protected] com o assunto Urgente: Sem Resposta – [Seu E-mail]
Segurança & Prevenção de Fraude
Q117: Como o Dodo Payments protege meu negócio contra fraudes?
Q117: Como o Dodo Payments protege meu negócio contra fraudes?
Q118: Os dados dos meus clientes estão seguros com o Dodo Payments?
Q118: Os dados dos meus clientes estão seguros com o Dodo Payments?
Q119: Encontrei uma vulnerabilidade de segurança no Dodo Payments. Como devo relatá-la?
Q119: Encontrei uma vulnerabilidade de segurança no Dodo Payments. Como devo relatá-la?
Q120: O Dodo Payments oferece recompensas por bugs?
Q120: O Dodo Payments oferece recompensas por bugs?