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?
Q20: Meu produto INR está mostrando USD no checkout. Como posso corrigir isso?
Q20: Meu produto INR está mostrando USD no checkout. Como posso corrigir isso?
Verificação, Imposto e Conformidade
Q21: Por que minha verificação está demorando tanto?
Q21: Por que minha verificação está demorando tanto?
- Alto volume de aplicações
- Finais de semana e feriados
- Submissões incompletas ou incorretas
- Revisões manuais para risco ou conformidade
Q22: Eu enviei meu formulário W-8BEN, mas a seção de assinatura não funciona corretamente. O que eu faço?
Q22: Eu enviei meu formulário W-8BEN, mas a seção de assinatura não funciona corretamente. O que eu faço?
- 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).
Q23: Eu escolhi o tipo de registro errado (empresa vs individual). Como posso corrigir isso?
Q23: Eu escolhi o tipo de registro errado (empresa vs individual). Como posso corrigir isso?
Q24: Minha verificação foi recusada devido a incompatibilidade de entidade. O que devo fazer?
Q24: Minha verificação foi recusada devido a incompatibilidade de entidade. O que devo fazer?
Q25: Eu alcancei $100 em ganhos. Minha conta será verificada mais rápido?
Q25: Eu alcancei $100 em ganhos. Minha conta será verificada mais rápido?
Q26: Posso usar um nome diferente (como o de meu pai) para me inscrever e ser verificado?
Q26: 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.
Q27: Como posso verificar o motivo da rejeição da verificação?
Q27: Como posso verificar o motivo da rejeição da verificação?
- O painel da Dodo Payments, na seção de verificação.
- Notificações por e-mail (se habilitadas)
Q28: Posso criar uma nova conta comercial se minha anterior foi recusada?
Q28: Posso criar uma nova conta comercial se minha anterior foi recusada?
- Você corrigiu os problemas que levaram à recusa.
- Você não está tentando contornar decisões de risco (por exemplo, desativação por preocupações de fraude).
Q29: Disseram-me que minha conta foi anteriormente desativada. O que isso significa?
Q29: Disseram-me que minha conta foi anteriormente desativada. O que isso significa?
- Isso significa que a 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 do negócio provavelmente será rejeitado novamente.
Q30: Como posso acelerar a verificação do meu pagamento?
Q30: Como posso acelerar a verificação do meu pagamento?
- Envie documentos claros e formatados corretamente
- Evite mensagens/tagging 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
Q31: E se eu escolhi o formulário errado (W-8BEN vs W-8BEN-E)?
Q31: 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 está no campo correto (Linha 6a para indivíduos).
Q32: Eu tenho um GST com um nome comercial. Isso é considerado uma organização?
Q32: Eu tenho um GST com um nome comercial. Isso é considerado uma organização?
Q33: Minha conta foi desativada. Posso apenas criar uma nova?
Q33: 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
Q34: Como a Dodo Payments lida com GST para comerciantes de SaaS indianos?
Q34: Como a Dodo Payments lida com GST para comerciantes de SaaS indianos?
Q35: A Dodo Payments lida com vendas internacionais?
Q35: A Dodo Payments lida com vendas internacionais?
Q36: 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: 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?
Q37: Preciso declarar impostos nos EUA se vender lá?
Q37: 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
Q38: Não sei se devo preencher W-8BEN ou W-8BEN-E — ajuda?
Q38: 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 | Individual |
| 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
Q39: Preciso de um PAN ou GST para receber pagamentos?
Q39: Preciso de um PAN ou GST para receber pagamentos?
Q40: Eu tenho um certificado Udyam/MSME. Devo enviar W-8BEN ou W-8BEN-E?
Q40: Eu 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
Q41: Se a Dodo lida com impostos, por que preciso preencher W-8BEN(-E)?
Q41: Se a Dodo lida com impostos, por que preciso preencher W-8BEN(-E)?
Pagamentos e Transações
Q42: Que tipos de pagamentos posso aceitar com a Dodo Payments?
Q42: Que tipos de pagamentos posso aceitar com a Dodo Payments?
Q43: Por que o primeiro pagamento foi marcado como bem-sucedido com um valor de $0 para assinatura?
Q43: Por que o primeiro pagamento foi marcado como bem-sucedido com um valor de $0 para assinatura?
Q44: Após o término do período de teste, o cliente precisa pagar (preço do produto (por exemplo, $25)) novamente manualmente?
Q44: Após o término do período de teste, o cliente precisa pagar (preço do produto (por exemplo, $25)) novamente manualmente?
Q45: E se o período de teste mostrar de forma diferente no meu aplicativo em comparação com o painel da Dodo Payments?
Q45: E se o período de teste mostrar de forma diferente no meu aplicativo em comparação com o painel da Dodo Payments?
Q46: Preciso testar o recurso de teste antes de ir ao vivo?
Q46: Preciso testar o recurso de teste antes de ir ao vivo?
Q47: Como posso rastrear os status dos pagamentos?
Q47: Como posso rastrear os status dos pagamentos?
Q48: O que devo fazer se um pagamento falhar?
Q48: O que devo fazer se um pagamento falhar?
Q49: Os comerciantes são notificados quando o pagamento de um usuário falha?
Q49: 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.
Q50: O que acontece com uma assinatura se um pagamento falhar?
Q50: 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
Q51: Se eu tentar pagamentos novamente, preciso do ID do pagamento falhado?
Q51: Se eu tentar pagamentos novamente, preciso do ID do pagamento falhado?
Q52: Como um pagamento de assinatura pode falhar com INCORRECT_NUMBER se os ciclos anteriores foram bem-sucedidos?
Q52: Como um pagamento de assinatura pode falhar com INCORRECT_NUMBER se os ciclos anteriores foram bem-sucedidos?
Q53: O chargeback se aplica ao negócio mesmo que minha empresa tenha uma política de não reembolso?
Q53: O chargeback se aplica ao negócio mesmo que minha empresa tenha uma política de não reembolso?
Q54: Por que payment.status às vezes é nulo?
Q54: 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
Q55: Por que product_cart é nulo mesmo sendo um checkout?
Q55: 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 é preenchido apenas para pagamentos únicos
Q56: Por que meu cartão real foi bloqueado durante os testes?
Q56: 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
Q57: Meu cliente completou o pagamento, mas não recebi o webhook?
Q57: 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?
Q58: Por que meu painel mostra sucesso, mas meu aplicativo não foi atualizado?
Q58: 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
Q59: Não estou vendo UPI como uma opção de pagamento — por quê?
Q59: 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
- UPI não foi habilitado para o seu negócio
Q60: A Dodo suporta UPI para assinaturas?
Q60: A Dodo suporta UPI para assinaturas?
- Limites de Mandato:
- Cobranças abaixo de R 15.000 é criado
- Cobranças de R$ 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
Q61: Como habilito Google Pay / Apple Pay em links de pagamento estáticos?
Q61: Como habilito Google Pay / Apple Pay em links de pagamento estáticos?
Q62: Como posso habilitar 3DS na Dodo Payments?
Q62: Como posso habilitar 3DS na Dodo Payments?
Q63: Como posso coletar detalhes de cobrança sem passá-los na API?
Q63: 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
Q64: Qual é a diferença entre links de pagamento estáticos e dinâmicos?
Q64: 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.)
Q65: Receberei dois eventos de webhook quando alguém iniciar uma assinatura?
Q65: Receberei dois eventos de webhook quando alguém iniciar uma assinatura?
subscription.createdwebhookpayment.succeededwebhooksubscription.renewalwebhook
Q66: O que significa subscription.cancelled_at? É um cancelamento programado?
Q66: 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
cancel_at_next_billing_dateparâmetro na API de patch de assinatura para cancelar no final do período de cobrança atual
Q67: Quando uma assinatura é cobrada?
Q67: Quando uma assinatura é cobrada?
Q68: Por que a API de Alteração de Plano retorna uma resposta vazia?
Q68: Por que a API de Alteração de Plano retorna uma resposta vazia?
Q69: Por que não foi solicitado um novo pagamento ao mudar de um plano mensal para um anual?
Q69: Por que não foi solicitado um novo pagamento ao mudar de um plano mensal para um anual?
Q70: Por que o preço do meu produto (R$ 100) mostra um valor maior (R$ 104) durante o checkout?
Q70: Por que o preço do meu produto (R$ 100) mostra um valor maior (R$ 104) durante o checkout?
Q71: Por que o checkout ignora assinaturas ativas existentes e cria uma nova?
Q71: Por que o checkout ignora assinaturas ativas existentes e cria uma nova?
Q72: Por que estou vendo um erro TRANSACTION_NOT_ALLOWED durante uma atualização/downgrade de assinatura?
Q72: Por que estou vendo um erro TRANSACTION_NOT_ALLOWED durante uma atualização/downgrade 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
Q73: Existe uma maneira de testar no modo ao vivo sem fazer pagamentos reais?
Q73: Existe uma maneira de testar no modo ao vivo sem fazer pagamentos reais?
Q74: O que é o método de pagamento de $0?
Q74: O que é o método de pagamento de $0?
Q75: Parece que minha conta está suspensa, mas a conformidade diz que está tudo bem. O que devo fazer?
Q75: Parece que minha conta está suspensa, mas a conformidade diz que está tudo bem. O que devo fazer?
Pagamentos e Integração Bancária
Q76: Como funcionam os pagamentos com a Dodo Payments?
Q76: Como funcionam os pagamentos com a 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 empresas 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
Q77: Qual é o valor mínimo de limite após taxas e impostos para processar pagamentos?
Q77: Qual é o valor mínimo de limite após taxas e impostos para processar pagamentos?
Q78: Como vinculo minha conta bancária para receber pagamentos?
Q78: Como vinculo minha conta bancária para receber pagamentos?
Q79: Posso rastrear o status dos meus pagamentos?
Q79: Posso rastrear o status dos meus pagamentos?
Q80: Quais são as taxas de pagamento e quanto elas são?
Q80: Quais são as taxas de pagamento e quanto elas são?
Q81: Recebi um e-mail de "pagamento processado" — quando os fundos chegarão?
Q81: Recebi um e-mail de "pagamento processado" — quando os fundos chegarão?
Q82: Como adiciono o Payoneer como uma conta de pagamento?
Q82: Como adiciono o Payoneer como uma conta de pagamento?
Q83: Posso receber pagamentos em uma conta Payoneer?
Q83: Posso receber pagamentos em uma conta Payoneer?
- Inserir os detalhes da sua conta Payoneer no Formulário de Informações Bancárias no painel da Dodo
- Garantir que sua conta esteja aprovada e suporte USD ou a moeda que você está retirando
Q84: Minhas informações bancárias e formulário de conformidade ainda estão em revisão — o que devo fazer?
Q84: 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]
Q85: O que acontece se meu dia de pagamento cair em uma sexta-feira ou no final de semana?
Q85: O que acontece se meu dia de pagamento cair em uma sexta-feira ou no final de semana?
- Se houver um feriado bancário ou final 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.
Q86: Como posso acelerar a conformidade do pagamento se eu tiver um lançamento urgente ou campanha publicitária planejada?
Q86: Como posso acelerar a conformidade do pagamento se eu tiver um lançamento urgente ou campanha publicitária planejada?
- Mencione sua urgência claramente nos chats 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.
Q87: Enviei os detalhes da conta bancária errados. Como posso atualizá-los?
Q87: 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 para 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.
Q88: Posso usar minha conta bancária pessoal se eu tiver uma empresa registrada?
Q88: Posso usar minha conta bancária pessoal se eu tiver uma empresa registrada?
Q89: Meu país não usa códigos SWIFT. Como isso afetará minha verificação?
Q89: 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 de 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 em seu país
Q90: Que documentação alternativa posso fornecer se meu país não usar códigos SWIFT?
Q90: 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 de conta, nome do titular e que os 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
Q91: Posso definir um limite de pagamento inferior a $50?
Q91: Posso definir um limite de pagamento inferior a $50?
Faturamento e Relatórios
Q92: A Dodo Payments gera faturas automaticamente?
Q92: A Dodo Payments gera faturas automaticamente?
Q93: Posso personalizar as faturas?
Q93: Posso personalizar as faturas?
Q94: Como acesso ou baixo uma fatura?
Q94: Como acesso ou baixo uma fatura?
Q95: Como vejo relatórios sobre minhas transações e pagamentos?
Q95: Como vejo relatórios sobre minhas transações e pagamentos?
Reembolsos e Disputas
Q96: Como faço um reembolso?
Q96: Como faço um reembolso?
Q97: Quanto tempo leva para um cliente receber seu reembolso?
Q97: Quanto tempo leva para um cliente receber seu reembolso?
Q98: Estou enfrentando uma disputa ou chargeback. O que posso fazer?
Q98: 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
Q99: O cliente contestou a cobrança após usar o serviço. Posso apelar isso?
Q99: 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 e Integração
Q100: Como a prorrata é calculada — sobre o preço do produto ou o valor total?
Q100: Como a prorrata é calculada — sobre o preço do produto ou o valor total?
Q101: Por que usamos o `subscription.renewed` webhook para a primeira assinatura?
Q101: Por que usamos o `subscription.renewed` webhook para a primeira assinatura?
subscription.renewed é enviado para indicar que um período de cobrança agora está ativo e o próximo ciclo de cobrança foi agendado.
Este webhook é usado para cada período de cobrança — incluindo o primeiro — para que a lógica de cobrança possa ser tratada de forma consistente a cada vez.Q102: Posso verificar manualmente os webhooks da Dodo Payments em Python?
Q102: Posso verificar manualmente os webhooks da Dodo Payments em Python?
Q103: Onde posso encontrar a documentação oficial sobre verificação manual de webhooks?
Q103: Onde posso encontrar a documentação oficial sobre verificação manual de webhooks?
Q104: Meu webhook não está recebendo uma solicitação POST, apenas uma GET. Por quê?
Q104: 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 da Dodo Payments:- Configure um webhook em Painel → Desenvolvedores → Webhooks
- Certifique-se de que a URL aceite solicitações POST e verifique a assinatura
Q105: Estou recebendo um erro 401 Unauthorized usando o SDK Python. Por quê?
Q105: Estou recebendo um erro 401 Unauthorized usando o SDK Python. Por quê?
Q106: Existe uma maneira de acionar manualmente um evento de webhook para teste?
Q106: Existe uma maneira de acionar manualmente um evento de webhook para teste?
Q107: Qual é a diferença entre webhook e URL de redirecionamento?
Q107: Qual é a diferença entre webhook e URL de redirecionamento?
- Webhook URL: Configurado no painel. Recebe cargas úteis POST sobre eventos.
- Redirect URL: Enviada na solicitação da API de pagamento. Envia o usuário de volta ao seu aplicativo com parâmetros de consulta (
?status=success).
Q108: Por que não recebi o id do produto no webhook payment.succeeded para um produto de assinatura?
Q108: Por que não recebi o id do produto no webhook payment.succeeded para um produto de assinatura?
subscription_id associado à assinatura, juntamente com outros detalhes relevantes.Q109: Como posso verificar se os webhooks que recebo são realmente da Dodo Payments e não de atores maliciosos?
Q109: Como posso verificar se os webhooks que recebo são realmente da Dodo Payments e não de atores maliciosos?
- Verifique a Assinatura: Cada webhook enviado pela 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 da Dodo Payments nas configurações de Webhooks.
- Recalcule a Assinatura: Use o mesmo algoritmo de assinatura (HMAC-SHA256) que a 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 essas etapas, você pode verificar com confiança a autenticidade dos webhooks enviados pela Dodo Payments.
Q110: Por que estou recebendo um webhook subscription.renew mesmo para o pagamento do primeiro mês?
Q110: 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.Q111: Como posso testar webhooks localmente?
Q111: Como posso testar webhooks localmente?
- Use uma Ferramenta de Túnel: Ferramentas como ngrok, LocalTunnel, ou Cloudflare Tunnel podem expor seu servidor local para a internet. Isso fornece uma URL pública que a 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 na Dodo Payments: Vá para o painel da 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.
Q112: Por que meu webhook não está sendo chamado após o pagamento?
Q112: 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
Q113: É seguro confiar em status=success nos parâmetros de consulta da URL?
Q113: É seguro confiar em status=success nos parâmetros de consulta da URL?
- Valide a transação com uma chamada de API
- Ou aguarde o webhook payment.succeeded
Q114: Posso integrar a Dodo Payments com meu site ou plataforma existente?
Q114: Posso integrar a Dodo Payments com meu site ou plataforma existente?
Testes e Desenvolvimento Local
Q115: Posso testar assinaturas no Modo de Teste?
Q115: Posso testar assinaturas no Modo de Teste?
Q116: Como alterno entre o Modo de Teste e o Modo Ao Vivo?
Q116: Como alterno entre o Modo de Teste e o Modo Ao Vivo?
- No seu painel da Dodo, procure um botão de alternância do Modo de Teste.
- Ative-o para usar chaves de API de teste e simular pagamentos.
Q117: Posso usar dados reais de clientes no Modo de Teste?
Q117: 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
Q118: Estou recebendo: "Você deve fornecer um mandato para pagamentos de cartão fora da sessão"
Q118: 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 e Comunicação
Q119: Como entro em contato com o suporte?
Q119: Como entro em contato com o suporte?
Q120: Minhas mensagens de suporte não estão recebendo resposta. O que devo fazer?
Q120: 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 e Prevenção de Fraude
Q121: Como a Dodo Payments protege meu negócio contra fraudes?
Q121: Como a Dodo Payments protege meu negócio contra fraudes?
Q122: Os dados dos meus clientes estão seguros com a Dodo Payments?
Q122: Os dados dos meus clientes estão seguros com a Dodo Payments?
Q123: Encontrei uma vulnerabilidade de segurança na Dodo Payments. Como devo relatá-la?
Q123: Encontrei uma vulnerabilidade de segurança na Dodo Payments. Como devo relatá-la?
Q124: A Dodo Payments oferece recompensas por bugs?
Q124: A Dodo Payments oferece recompensas por bugs?
Falhas de Pagamento
Q125: Por que o status do meu pagamento está mostrando 'Não Iniciado'?
Q125: Por que o status do meu pagamento está mostrando 'Não Iniciado'?
Q126: Por que o status do meu pagamento está mostrando 'Requer Método de Pagamento'?
Q126: Por que o status do meu pagamento está mostrando 'Requer Método de Pagamento'?
Q127: Por que estou recebendo um erro 'Detalhes de autorização inválidos'?
Q127: Por que estou recebendo um erro 'Detalhes de autorização inválidos'?
Q128: Por que estou recebendo um erro 'Falha na autenticação' para pagamentos?
Q128: Por que estou recebendo um erro 'Falha na autenticação' para pagamentos?