Voltar para documentação
Integrações

Integração ClickBank

Conecte sua conta ClickBank ao Synchro Hub para receber vendas em tempo real — como produtor ou afiliado — num único dashboard.

Visão geral

Ao integrar o ClickBank, o Synchro Hub passa a:

  • Receber suas vendas em tempo real por um dos dois mecanismos, conforme o seu papel:
    • Produtor (vendor): via INS (Instant Notification Service) — cobre vendas, rebills, reembolsos e chargebacks.
    • Afiliado: via Postback/Pixels — dispara em compras e upsells das ofertas que você promove.
  • Separar automaticamente a taxa do ClickBank das comissões (produtor, afiliado, JV).
  • Identificar o seu papel na venda (produtor ou afiliado) e atribuir o valor correto.

Um único secret para os dois. Ao ativar, o Synchro Hub gera um secret de 16 caracteres. Esse mesmo valor serve como Secret Key do INS (produtor) e como token do Postback (afiliado) — você cola o mesmo secret onde o seu caso exigir.

Tempo estimado: 10 minutos. O que você vai precisar:

  • Conta ClickBank — com INS liberado (Advanced Tools) se você é produtor, ou acesso a Integrations › Postback/Pixels se você é afiliado.
  • O nickname (apelido) da sua conta ClickBank — 5 a 10 caracteres.
  • Workspace já criado no Synchro Hub.

Importante: a integração é forward-only — vendas anteriores à conexão não são importadas. Só valem as notificações recebidas a partir da ativação.

Pré-requisitos

  • Estar logado no Synchro Hub com um workspace selecionado.
  • Ter acesso ao painel do ClickBank em accounts.clickbank.com.

Passo 1 — Conectar a plataforma no Synchro Hub

  1. No Beacon, acesse Configurações → Integrações → Fontes de Venda.
  2. Clique em + Adicionar Plataforma.
  3. Selecione ClickBank e clique em Confirmar.
  4. O card do ClickBank aparece com Ativa e Webhook não configurado.

Passo 2 — Informar o nickname da conta

  1. No card do ClickBank, clique em Atualizar credenciais.
  2. Confira o Nickname da conta ClickBank — é o apelido da sua conta (5 a 10 caracteres alfanuméricos), o mesmo que aparece nas suas HopLinks e no painel. Ao reabrir para atualizar, o campo já vem preenchido com o nickname atual; edite-o só se precisar corrigir.
  3. Informe a API Key do ClickBank (começa com API-) — gere em Settings → API Management no painel ClickBank. Ela permite ao Synchro Hub conferir reembolsos e chargebacks (importante para afiliados, ver Limitações). Por segurança, a API Key não é reexibida ao reabrir o modal.
  4. Clique em Salvar.

Por que o nickname? O ClickBank identifica as partes da venda por nickname (não por e-mail). O Synchro Hub usa o seu nickname para saber quando você é o produtor ou o afiliado da venda e atribuir o valor correto. Por que a API Key? O Postback (afiliado) só avisa de compras — não de reembolsos/chargebacks. Com a API Key, o Synchro Hub consulta periodicamente a Orders API do ClickBank e atualiza o status dessas vendas. Produtores (INS) já recebem essas atualizações pelo webhook, mas a chave não atrapalha.

Passo 3 — Ativar o webhook no Synchro Hub (gera o secret)

O ClickBank não permite que o Synchro Hub cadastre a URL automaticamente — a configuração no painel é manual. Primeiro, gere o secret no Synchro Hub:

  1. No card do ClickBank no Beacon, clique em Configurar Webhook.
  2. Copie a URL do Webhook. O formato é: 
    https://api.synchrohub.com.br/v1/webhooks/ecommerce/clickbank/{seu-integration-id}
  3. Clique em Ativar Webhook. O Synchro Hub gera um secret de 16 caracteres (dígitos + MAIÚSCULAS) e o exibe no modal.
  4. Copie o secret — você vai colá-lo no ClickBank no Passo 4.

O card da integração passa a exibir Webhook ativo.

Passo 4 — Configurar no painel ClickBank (conforme o seu papel)

Use o mesmo secret gerado no Passo 3 no lugar que corresponde ao seu caso. Se você atua nos dois papéis na mesma conta, configure os dois.

Se você é PRODUTOR (vendor) → INS

  1. No ClickBank, vá em Accounts → (seu nickname) → Vendor Settings → My Site.
  2. Na seção Advanced Tools, clique em Edit.
  3. Cole a URL do Webhook (Passo 3) no campo Instant Notification URL (portas 80 ou 443).
  4. No campo Secret Key, cole o secret gerado pelo Synchro Hub.
  5. Salve. Use Test URL para validar.

A Secret Key é o que criptografa e autentica as notificações do INS (AES-256-CBC). Ela precisa ser idêntica à do Synchro Hub.

Se você é AFILIADO → Postback/Pixels

  1. No ClickBank, vá em Accounts → (seu nickname) → Integrations → Postback/Pixels.
  2. Em Custom Postback/Pixel, crie um novo postback.
  3. No campo de URL, cole a URL do Webhook (Passo 3) acrescentando o secret ao final como parâmetro token: 
    https://api.synchrohub.com.br/v1/webhooks/ecommerce/clickbank/{seu-integration-id}?token={secret-gerado}
  4. Deixe os macros disponibilizados pelo ClickBank (ex.: {receipt_id}, {event_type}, {affiliate_earnings}) — o Synchro Hub os lê automaticamente.
  5. Salve.

O token na URL é o que autentica o Postback — é o mesmo secret do INS. O Postback dispara em compras e upsells; reembolsos/chargebacks de afiliado são reconciliados por outra via.

Verificação

  1. Gere uma venda de teste no ClickBank (ou uma compra real de baixo valor).
  2. Abra Vendas no menu lateral do Synchro Hub.
  3. A venda deve aparecer em até 1 minuto após a confirmação.

Você verá no dashboard:

  • Valor da venda convertido corretamente (o ClickBank envia em dólares decimais — 29.90 → US$ 29,90).
  • Se você é produtor: o valor bruto, a taxa do ClickBank separada e as comissões dos afiliados.
  • Se você é afiliado: a sua comissão (o valor que você recebeu).

Limitações conhecidas

  • Webhook não-automático: o ClickBank não expõe API para registrar a URL — por isso o Passo 3 é manual.
  • Cliente do afiliado é anônimo: por privacidade, o ClickBank não envia o e-mail/nome do comprador ao afiliado — apenas ao produtor. Nas suas vendas como afiliado, o “cliente” aparece como desconhecido no Synchro Hub (a sua comissão é registrada normalmente).
  • Somente a partir de agora: vendas anteriores à integração não são importadas (forward-only).
  • Multi-moeda: o ClickBank opera em várias moedas. Se você vende fora de USD, confira o valor no dashboard e abra ticket se notar divergência.
  • Recorrência (rebill): rebills chegam como novas vendas. Se notar duplicidade ou valor estranho em assinaturas, abra ticket no suporte do Synchro Hub.
  • Reembolso/chargeback de afiliado: o Postback dispara em compras e upsells, mas o ClickBank não envia reembolso/chargeback por essa via. O Synchro Hub reconcilia essas transições consultando a Orders API periodicamente (requer a API Key — Passo 2). Sem a API Key, uma venda de afiliado reembolsada pode continuar aparecendo como aprovada; com ela, o status atualiza em até ~1 dia.

Solução de problemas

SintomaO que fazer
”Nickname da conta ClickBank inválido”Use o apelido da sua conta (5 a 10 caracteres alfanuméricos), o mesmo do painel/HopLinks.
Nenhuma venda chega após horasConfira no ClickBank se a URL está sem espaços, com /clickbank/ e com o seu integration ID no final; e se o INS está liberado.
Nada chega como afiliadoConfira se você colou a URL no Postback/Pixels (não no INS) com ?token={secret} ao final, e se o secret é exatamente o gerado pelo Synchro Hub.
Notificações do produtor não chegamA Secret Key do INS precisa ser idêntica ao secret gerado pelo Synchro Hub. Reabra o modal, copie o secret e cole novamente no ClickBank.
Vendas de afiliado sem nome do clienteEsperado — o ClickBank não envia dados do comprador ao afiliado (privacidade). A sua comissão é registrada normalmente.
Valor aparece diferente do esperadoO ClickBank envia em dólares decimais (29.90). Se o valor destoar (ex.: moeda diferente de USD), abra ticket.

Perguntas frequentes

Sou afiliado, não produtor. Funciona? Sim — é o caso de uso principal do ClickBank no Synchro Hub. Como afiliado, você usa o Postback/Pixels (Passo 4), não o INS (que é exclusivo do produtor). O Synchro Hub identifica a sua comissão pelo seu nickname.

Preciso configurar para cada produto? Não. Tanto o INS (produtor) quanto o Postback (afiliado) são por conta — uma configuração cobre todas as vendas da sua conta ClickBank.

O secret é o mesmo no INS e no Postback? Sim. O Synchro Hub gera um secret; você usa o mesmo valor como Secret Key do INS (produtor) e como token do Postback (afiliado).

Posso reprocessar vendas antigas? Não automaticamente. A integração é forward-only.

Como desconecto a integração? No card do ClickBank, clique em Remover. Remova também, no painel do ClickBank, a Instant Notification URL (produtor) e/ou o Custom Postback/Pixel (afiliado) para evitar tentativas de entrega sem destino.