Pular para o conteúdo
Oráculo

Configurando o gateway de pagamento

Resumo rapido

Para que o Oráculo registre as vendas do expert automaticamente, você precisa conectar a plataforma de pagamento dele. Isso e feito com um webhook — um link especial que a plataforma de pagamento usa para avisar o Oráculo toda vez que uma venda acontece.

Parece complicado, mas e só copiar e colar um link. Vamos la.

O que é um webhook? (explicação simples)

Pense no webhook como um “telefone” entre dois sistemas.

Quando alguem compra um produto na Hotmart (por exemplo), a Hotmart liga para o Oráculo usando esse telefone e diz: “Ei, o Joao acabou de comprar o curso X!”

O Oráculo recebe essa ligacao e registra a venda automaticamente.

Sem o webhook, você teria que entrar na plataforma de pagamento, verificar cada venda e registrar manualmente. Com o webhook, tudo e automatico.

Plataformas suportadas

O Oráculo funciona com as seguintes plataformas:

PlataformaChave de seguranca
HotmartHottok
KiwifySecret do Webhook
EduzzSecret Key
MonetizzeChave Unica
GuruAPI Token
PerfectPayToken
XgrowWebhook Secret

Cada expert usa uma plataforma de pagamento.

Passo a passo geral (vale para todas as plataformas)

1. Abra a página do Expert

  1. Va em Experts no menu lateral
  2. Clique no expert que quer configurar
  3. Clique na aba Pagamento

Screenshot: [Pagina de detalhes do Expert com a aba “Pagamento” selecionada, mostrando os cards de todas as plataformas disponíveis]

2. Clique na plataforma desejada

Você vera cards com o nome de cada plataforma. Clique em Conectar na plataforma que o expert usa.

Uma janela vai abrir com 3 passos. No Passo 1, você vai ver um link. Clique em Copiar para copiar esse link.

Screenshot: [Janela de conexão mostrando o Passo 1 com a URL do webhook e botao “Copiar”]

O link tem este formato:

https://api.oraculo.work/webhook/{id-do-expert}/{plataforma}

Abra a plataforma de pagamento do expert e cole o link na area de webhooks. Veja abaixo como fazer em cada plataforma.

5. Copie a chave de seguranca da plataforma

Cada plataforma gera uma chave de seguranca (secret/token). Copie essa chave e cole no Passo 3 da janela do Oráculo.

6. Clique em “Salvar e Conectar”

Pronto! A integração está configurada.

Screenshot: [Janela de conexão com todos os 3 passos preenchidos e botao “Salvar e Conectar”]

Como configurar em cada plataforma

Hotmart

  1. Acesse app.hotmart.com/tools/webhook
  2. Clique em Registrar Webhook
  3. Cole o link que você copiou do Oráculo
  4. Em “Eventos”, selecione todos os eventos de vendas que faça sentido
  5. Salve
  6. Copie o Hottok (aparece na página de configuração de webhooks da Hotmart)
  7. Cole o Hottok no Oráculo (Passo 3 da janela de conexão)

Kiwify

  1. Acesse app.kiwify.com.br/settings/webhooks
  2. Clique em Criar Webhook
  3. Cole o link que você copiou do Oráculo
  4. Selecione todos os eventos
  5. Salve
  6. A Kiwify vai gerar um Secret — copie esse valor
  7. Cole o Secret no Oráculo (Passo 3 da janela de conexão)

Eduzz

  1. Acesse o MyEduzz
  2. Va em Ferramentas > Webhooks
  3. Clique em Novo Webhook
  4. Cole o link que você copiou do Oráculo
  5. Selecione apenas os eventos de vendas que faz sentido (pago, reembolsado…)
  6. Salve
  7. Copie a Secret Key da Eduzz
  8. Cole a Secret Key no Oráculo (Passo 3 da janela de conexão)

Monetizze

  1. Acesse app.monetizze.com.br/tools/postback
  2. Cole o link que você copiou do Oráculo como URL de callback
  3. Salve
  4. Copie a Chave Unica da Monetizze
  5. Cole a Chave Unica no Oráculo (Passo 3 da janela de conexão)

Guru

  1. Acesse digitalmanager.guru/admin/settings/webhooks
  2. Clique em Novo Webhook
  3. Cole o link que você copiou do Oráculo
  4. Selecione todos os eventos
  5. Salve
  6. Copie o API Token do Guru
  7. Cole o API Token no Oráculo (Passo 3 da janela de conexão)

PerfectPay

  1. Acesse app.perfectpay.com.br/tools/postback
  2. Clique em Novo Webhook
  3. Cole o link que você copiou do Oráculo
  4. Selecione todos os eventos
  5. Salve
  6. Copie o Token da PerfectPay
  7. Cole o Token no Oráculo (Passo 3 da janela de conexão)

Xgrow

  1. Na Xgrow, va em Configurações > Integracoes > Webhooks
  2. Adicione um novo webhook
  3. Cole o link que você copiou do Oráculo
  4. Selecione todos os eventos
  5. Salve
  6. Copie o Webhook Secret da Xgrow
  7. Cole o Webhook Secret no Oráculo (Passo 3 da janela de conexão)

Como saber se está funcionando

Depois de configurar, faca uma venda de teste na plataforma (se possivel). O Oráculo vai mostrar no card da plataforma:

  • Status do ultimo webhook: sucesso ou erro
  • Data do ultimo webhook: quando foi a ultima vez que a plataforma avisou o Oráculo

Se o status mostrar erro, verifique se o link está correto e se a chave de seguranca foi colada certinho.

Screenshot: [Card da plataforma mostrando indicador de status verde com “Ultimo webhook recebido: DD/MM/AAAA HH:MM”]

Problemas comuns

”Vendas não aparecem no Oráculo”

  • Verifique se o webhook está configurado corretamente na plataforma de pagamento
  • Verifique se você selecionou todos os eventos na plataforma
  • Verifique se a chave de seguranca (secret/token) está correta
  • Faca uma venda de teste e veja se o status atualiza

”Erro de assinatura” ou “Signature mismatch”

  • A chave de seguranca colada no Oráculo não confere com a da plataforma
  • Solucao: Copie a chave novamente da plataforma e atualize no Oráculo

”Webhook retorna erro 404”

  • O link pode estar errado ou o expert pode ter sido desativado
  • Solucao: Confira o link na aba Pagamento do expert

Como trocar de plataforma

Se o expert mudou de plataforma (por exemplo, saiu da Hotmart e foi para a Kiwify):

  1. Na aba Pagamento, clique em Remover na plataforma antiga
  2. Clique em Conectar na plataforma nova
  3. Siga os passos normalmente

Proximos passos