URL de Postback de Afiliados: Utilidade para Criadores

Uma criadora afiliada de Ankara queria que seu canal do Discord recebesse uma notificação instantânea sempre que entrasse uma nova comissão durante sua sessão de coaching ao vivo. A solução chegou com a URL de postback da Phase 3.

Como funciona

No painel de afiliado abra Settings → Postback URL. Cole seu endpoint, ative o toggle e clique em Generate Signing Secret. O secret é uma string hex de 32 caracteres mostrada apenas uma vez; depois vive somente como hash no banco.

A cada evento — created, refunded ou released — o worker faz POST com header X-thMenu-Signature: sha256=<hmac>. Você recalcula o HMAC e valida a assinatura em tempo constante.

Cenários reais

O padrão mais poderoso para criadores é o webhook do Discord. A criadora de Ankara transmitiu ao vivo para seus 320 membros: "Alguém acabou de usar meu código — 47 USD de comissão". O engajamento triplicou em uma hora.

Outros destinos: bots Slack, CRMs pessoais HubSpot ou Notion, fluxos Zapier/Make para Google Sheets, canais Telegram e digests por email. Cada tipo de evento pode ser tratado diferente.

Confiabilidade

Se seu endpoint não responder 2xx em 5 segundos, o worker registra a falha em affiliate_postback_log. A cada hora um cron retenta até 5 vezes com backoff exponencial (1m, 5m, 30m, 2h, 6h). Após a quinta falha o evento é marcado morto.

Por isso seu endpoint deve ser idempotente. UPSERT por event_id; em caso de duplicata responda 200 sem renotificar. Rejeite também requisições com timestamp maior que 5 minutos para mitigar replay.

FAQ

É pago? Não, gratuito para todos os afiliados ativos.

Modo de teste? Sim, botão "Send Test Event" no painel.

Perdi o secret? Regenere; o antigo é revogado instantaneamente.

Achou útil? Compartilhe.