Hotmart: postback com {SCK}
Levar o click_id até o checkout da Hotmart pelo parâmetro sck, configurar o postback com o template pronto, mapear os status de compra e testar.
A Hotmart propaga até o postback o parâmetro sck recebido no link do checkout. É por ele que o click_id viaja.
1. Oferta: o click_id no sck
Na oferta, a URL de destino deve ser a página de vendas ou o checkout, e o Parâmetro do click_id deve ser sck:
- Destino direto no checkout:
https://pay.hotmart.com/XXXXXXXXcom Parâmetro do click_idsck→ o visitante pousa emhttps://pay.hotmart.com/XXXXXXXX?sck=034U7a…. - Destino na página de vendas (sua): Parâmetro do click_id
clickid(ou o que preferir) e a tag instalada; os botões de compra da página precisam repassar o valor para o checkout como?sck=. Com a tag,window.af.clickIdfornece o valor para montar o link de compra. Alternativa sem código: colocar?sck={click_id}diretamente nos links de checkout da página, se a página for gerada por template que aceite macros.
O caminho mais simples e robusto é o destino direto no checkout com sck.
2. Postback
Hotmart › Ferramentas › Postback (ou Webhook, dependendo da versão) › nova configuração. Cole o template de Rastreio de conversão › Templates por plataforma › Hotmart:
https://app.affilitrack.com.br/pb?token=SEU_TOKEN&click_id={SCK}&tipo=venda&status={STATUS}&payout={COMMISSION_VALUE}&txid={TRANSACTION}Eventos a marcar: compra aprovada, compra completa, reembolso, chargeback — e, se quiser acompanhar boletos, boleto impresso (chega como pendente).
Macros da Hotmart usadas:
| Macro | Vira |
|---|---|
{SCK} | click_id |
{STATUS} | status — a Hotmart manda approved, completed, canceled, refunded, chargeback, billet_printed, entre outros |
{COMMISSION_VALUE} | payout — a sua comissão (para produtor, troque por {PRICE} ou {FULL_PRICE}) |
{TRANSACTION} | txid — o código HP da transação |
3. Status da Hotmart
O Affilitrack entende approved e refunded diretamente. Os demais podem ser traduzidos por um Merchant genérico com regras:
| Status Hotmart | Regra |
|---|---|
completed | status=completed → SALE (approved) |
billet_printed | status=billet_printed → SALE com status pending (ou ignore o evento na Hotmart) |
canceled, expired | → declined |
chargeback | → refunded |
Sem merchant, valores não reconhecidos são tratados como approved — então não marque eventos de cancelamento/boleto no postback se não tiver merchant configurado, ou eles entrariam como venda.
4. Testar
A Hotmart tem Testar postback na configuração; ele manda valores de exemplo. O {SCK} de teste não corresponde a um clique real, então a resposta será orphan — isso confirma token e URL. Para o teste completo, faça uma compra de teste (a Hotmart oferece cupom de 100% ou modo sandbox para produtores) partindo do link de rastreio, e confira created em Logs › Postbacks S2S.
5. Sub-afiliados e upsell
- Se você é produtor com afiliados, o
scké seu — o afiliado da Hotmart vem em{AFFILIATE}; passe-o em&sub1={AFFILIATE}se quiser vê-lo no clique da conversão (fica no log do postback). - Upsell e order bump chegam com o mesmo
scke{TRANSACTION}diferente. Para contá-los, crie um tipoupsellem modorepeatede um segundo postback na Hotmart comtipo=upsellpara os eventos de upsell.