Kiwify: postback com {sck}
Levar o click_id ao checkout da Kiwify pelo parâmetro sck, configurar o webhook com o template pronto e tratar os eventos de compra, boleto e reembolso.
A Kiwify propaga o parâmetro sck do link do checkout até o webhook, e é por ele que o click_id chega.
1. Oferta
- URL de destino: o link do checkout Kiwify (
https://pay.kiwify.com.br/XXXXXXX) ou a sua página de vendas. - Parâmetro do click_id:
sck.
Com o checkout como destino, o visitante pousa em https://pay.kiwify.com.br/XXXXXXX?sck=034U7a… e a Kiwify guarda o valor na compra. Com uma página de vendas no meio, a tag precisa repassar o click_id para os botões de compra como ?sck= — veja a nota em Hotmart, o mecanismo é o mesmo.
2. Webhook
Kiwify › Apps › Webhooks › criar. URL: o template de Rastreio de conversão › Templates por plataforma › Kiwify:
https://app.affilitrack.com.br/pb?token=SEU_TOKEN&click_id={sck}&tipo=venda&payout={order_value}&txid={order_id}Eventos: Compra aprovada, Reembolso, Chargeback; opcionalmente Boleto gerado e Pix gerado (pendentes).
| Macro Kiwify | Vira |
|---|---|
{sck} | click_id |
{order_value} | payout — valor do pedido. Para a comissão de afiliado, use a macro de comissão que a sua conta expõe |
{order_id} | txid |
A Kiwify também manda o corpo em JSON com order_status (paid, refunded, chargedback, waiting_payment…). Se você usar o webhook JSON em vez de macros na URL, um Merchant genérico com regras traduz order_status=paid → SALE, order_status=refunded → refunded, e o parâmetro do valor passa a ser order_value — veja Merchants.
3. Status
Na URL acima não há status; todo evento chega como approved. Por isso marque só os eventos de compra aprovada — ou acrescente &status=… com a macro de status e trate reembolsos por merchant.
4. Testar
A Kiwify tem Enviar teste no webhook. O sck de teste vem vazio ou fictício, então a resposta é invalid ou orphan — o que confirma URL e token. O teste completo é uma compra a partir do link de rastreio, com created em Logs › Postbacks S2S.
5. Order bump e upsell
Chegam como pedidos separados (outro order_id, mesmo sck). Com o tipo venda em modo new, só o primeiro conta. Para contar todos, crie um tipo em modo repeated (upsell) e um webhook próprio para esses eventos com tipo=upsell.