URL de Postback de Afiliados: Utilidad para Creadores

Una creadora afiliada de Ankara quería que su canal de Discord recibiera una notificación al instante cada vez que entrara una nueva comisión durante su sesión de coaching en vivo. La solución llegó con la URL de postback de la Phase 3.

Cómo funciona

En tu panel de afiliado abre Settings → Postback URL. Pega tu endpoint, activa el toggle y pulsa Generate Signing Secret. El secret es un string hex de 32 caracteres mostrado una sola vez; después vive hasheado en base de datos.

Cada vez que ocurre un evento — created, refunded o released — el worker hace POST a tu URL con la cabecera X-thMenu-Signature: sha256=<hmac>. Recalculas el HMAC en tu lado y validas la firma.

Casos reales

El patrón más potente para creadores es el webhook de Discord. La creadora de Ankara mostró en directo a sus 320 miembros: "Alguien acaba de usar mi código — 47 USD de comisión". El engagement se triplicó en una hora.

Otros destinos típicos: bots de Slack, CRM personal HubSpot o Notion, flujos Zapier/Make hacia Google Sheets, canales de Telegram y resúmenes por email. Cada tipo de evento puede manejarse diferente.

Fiabilidad

Si tu endpoint no responde 2xx en 5 segundos, el worker registra el fallo en affiliate_postback_log. Cada hora un cron de reintentos lo prueba hasta 5 veces con backoff exponencial (1m, 5m, 30m, 2h, 6h). Al quinto fallo se marca muerto.

Por eso tu endpoint debe ser idempotente. UPSERT por event_id; ante duplicado responde 200 sin volver a notificar. Rechaza también peticiones con timestamp de más de 5 minutos para evitar replays.

FAQ

¿Cuesta dinero? No, gratuito para todos los afiliados activos.

¿Modo de prueba? Sí, botón "Send Test Event" en el panel.

¿Si pierdo el secret? Regenera; el viejo queda revocado al instante.

¿Te resultó útil? Compártelo.