Pular para o conteúdo

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

  1. No dashboard, va ate Configuracao > Eventos
  2. Selecione o evento desejado
  3. 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:

PlataformaSuportada
EduzzSim
XgrowSim
HotmartSim
KiwifySim
MonetizzeSim
GuruSim
PerfectPaySim
StripeSim

Configurando na Eduzz

  1. Acesse sua conta na Eduzz
  2. Va ate Configuracoes > Webhooks (ou “Notificacoes de Postback”)
  3. Clique em Adicionar Webhook (ou similar)
  4. No campo de URL, cole a URL que voce copiou no painel do evento
  5. Selecione os eventos que deseja receber (pelo menos: venda aprovada, venda cancelada, reembolso)
  6. 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

  1. Acesse sua conta na Xgrow
  2. Va ate a area de Integracoes ou Webhooks
  3. Adicione um novo webhook
  4. No campo de URL, cole a URL que voce copiou no painel do evento
  5. Selecione os eventos de venda que deseja receber
  6. Salve

Screenshot: [Tela de configuracao de webhook na Xgrow]


Configurando na Hotmart

  1. Acesse sua conta na Hotmart
  2. Va ate Ferramentas > Webhooks (no menu lateral)
  3. Clique em Criar Webhook
  4. No campo de URL, cole a URL que voce copiou no painel do evento
  5. Marque os eventos: PURCHASE_COMPLETE, PURCHASE_CANCELED, PURCHASE_REFUNDED, PURCHASE_CHARGEBACK
  6. 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

  1. Acesse sua conta na Kiwify
  2. Va ate Configuracoes > Webhooks
  3. Adicione um novo webhook com a URL que voce copiou no painel do evento
  4. Selecione os eventos de venda
  5. Salve

Configurando na Monetizze

  1. Acesse sua conta na Monetizze
  2. Va ate Minha Conta > Configuracoes > Postback
  3. Cole a URL que voce copiou no painel do evento
  4. Configure os eventos desejados
  5. Salve

Configurando no Guru

  1. Acesse sua conta no Guru
  2. Va ate Configuracoes > Integracao > Webhooks
  3. Adicione a URL que voce copiou no painel do evento
  4. Selecione os eventos de transacao
  5. Salve

Configurando na PerfectPay

  1. Acesse sua conta na PerfectPay
  2. Va ate Configuracoes > Webhooks
  3. Cole a URL que voce copiou no painel do evento
  4. Selecione os eventos
  5. 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

  1. Faca uma compra de teste na plataforma (muitas oferecem modo sandbox ou valor de R$ 1)
  2. Aguarde alguns segundos
  3. No Oraculo, va ate Operacao > Vendas
  4. 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:

  1. A URL do webhook esta correta (copiou a URL completa do painel do evento)
  2. Os eventos de venda estao selecionados na plataforma
  3. 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