Configurando webhooks de pagamento
Para que as vendas entrem automaticamente no Oraculo, voce precisa configurar o webhook na sua plataforma de pagamento. O webhook e como um “aviso automatico” que a plataforma envia toda vez que uma venda acontece.
Onde encontrar a URL do webhook
- No dashboard, va ate Configuracao > Eventos
- Selecione o evento desejado
- Na aba de webhooks, copie a URL do webhook de pagamento (ela ja vem pronta para colar na plataforma)
Screenshot: [Configuracao do evento mostrando URL de webhook de pagamento pronta para copiar]
Plataformas suportadas
O Oraculo aceita webhooks das seguintes plataformas:
| Plataforma | Suportada |
|---|---|
| Eduzz | Sim |
| Xgrow | Sim |
| Hotmart | Sim |
| Kiwify | Sim |
| Monetizze | Sim |
| Guru | Sim |
| PerfectPay | Sim |
| Stripe | Sim |
Configurando na Eduzz
- Acesse sua conta na Eduzz
- Va ate Configuracoes > Webhooks (ou “Notificacoes de Postback”)
- Clique em Adicionar Webhook (ou similar)
- No campo de URL, cole a URL que voce copiou no painel do evento
- Selecione os eventos que deseja receber (pelo menos: venda aprovada, venda cancelada, reembolso)
- Salve as configuracoes
Screenshot: [Tela de configuracao de webhook na Eduzz com a URL do Oraculo preenchida]
Testando na Eduzz
Apos salvar, a Eduzz geralmente tem um botao para “Testar webhook”. Clique nele e verifique se o Oraculo recebeu o teste (a venda de teste aparecera no dashboard de vendas).
Configurando na Xgrow
- Acesse sua conta na Xgrow
- Va ate a area de Integracoes ou Webhooks
- Adicione um novo webhook
- No campo de URL, cole a URL que voce copiou no painel do evento
- Selecione os eventos de venda que deseja receber
- Salve
Screenshot: [Tela de configuracao de webhook na Xgrow]
Configurando na Hotmart
- Acesse sua conta na Hotmart
- Va ate Ferramentas > Webhooks (no menu lateral)
- Clique em Criar Webhook
- No campo de URL, cole a URL que voce copiou no painel do evento
- Marque os eventos: PURCHASE_COMPLETE, PURCHASE_CANCELED, PURCHASE_REFUNDED, PURCHASE_CHARGEBACK
- Salve
Screenshot: [Tela de configuracao de webhook na Hotmart com eventos selecionados]
Testando na Hotmart
A Hotmart permite enviar eventos de teste. Use essa funcao para validar que a conexao esta funcionando antes de lancar.
Configurando na Kiwify
- Acesse sua conta na Kiwify
- Va ate Configuracoes > Webhooks
- Adicione um novo webhook com a URL que voce copiou no painel do evento
- Selecione os eventos de venda
- Salve
Configurando na Monetizze
- Acesse sua conta na Monetizze
- Va ate Minha Conta > Configuracoes > Postback
- Cole a URL que voce copiou no painel do evento
- Configure os eventos desejados
- Salve
Configurando no Guru
- Acesse sua conta no Guru
- Va ate Configuracoes > Integracao > Webhooks
- Adicione a URL que voce copiou no painel do evento
- Selecione os eventos de transacao
- Salve
Configurando na PerfectPay
- Acesse sua conta na PerfectPay
- Va ate Configuracoes > Webhooks
- Cole a URL que voce copiou no painel do evento
- Selecione os eventos
- Salve
Stripe
A configuracao do Stripe e feita diretamente no painel do expert no Oraculo, na secao de integracoes. Copie a URL do webhook no painel e configure no Stripe.
Como testar se o webhook esta funcionando
Teste 1: Venda de teste
- Faca uma compra de teste na plataforma (muitas oferecem modo sandbox ou valor de R$ 1)
- Aguarde alguns segundos
- No Oraculo, va ate Operacao > Vendas
- A venda de teste deve aparecer na lista
Teste 2: Verificar nos logs
Se a venda nao aparecer, verifique os logs do evento em Configuracao > Eventos > [seu evento] > Logs. Webhooks recebidos (com sucesso ou erro) sao registrados nos logs.
Problemas comuns
”A venda nao esta aparecendo no Oraculo”
Verifique:
- A URL do webhook esta correta (copiou a URL completa do painel do evento)
- Os eventos de venda estao selecionados na plataforma
- A URL foi colada no lugar certo na plataforma de pagamento
”As vendas entram como orfas”
Isso acontece quando o telefone e email da compra nao batem com nenhum lead cadastrado. Certifique-se de que os leads estao sendo captados corretamente antes da etapa de vendas.
Resumo
- Cada plataforma precisa ser configurada com a URL de webhook do Oraculo
- Copie a URL na configuracao do evento no dashboard
- Cole essa URL na sua plataforma de pagamento
- Teste com uma compra de teste para garantir que tudo funciona
- Plataformas suportadas: Eduzz, Xgrow, Hotmart, Kiwify, Monetizze, Guru, PerfectPay, Stripe