Affiliate Postback URL: Зачем Нужен Креаторам

Креаторша-аффилиат из Анкары хотела, чтобы её Discord-канал получал уведомление мгновенно при каждой новой комиссии во время живой коучинг-сессии. Решение пришло с postback URL в Phase 3.

Как это работает

В панели аффилиата откройте Settings → Postback URL. Вставьте свой эндпоинт, включите toggle и нажмите Generate Signing Secret. Секрет — 32-символьная hex-строка, показывается один раз; затем хранится только как хеш в БД.

При каждом событии — created, refunded или released — воркер делает POST с заголовком X-thMenu-Signature: sha256=<hmac>. Вы пересчитываете HMAC на своей стороне и сравниваете в constant-time.

Реальные сценарии

Самый мощный паттерн — Discord webhook для вовлечения сообщества. Креаторша из Анкары в прямом эфире транслировала 320 участникам: "Кто-то только что использовал мой код — 47 USD комиссии". Вовлечённость утроилась за час.

Другие назначения: Slack-боты, личные CRM HubSpot или Notion, потоки Zapier/Make в Google Sheets, Telegram-каналы и email-дайджесты. Каждый тип события можно обрабатывать по-разному.

Надёжность

Если ваш эндпоинт не вернёт 2xx за 5 секунд, воркер запишет неудачу в affiliate_postback_log. Ежечасный retry-cron повторяет до 5 попыток с экспоненциальным backoff (1м, 5м, 30м, 2ч, 6ч). После пятой неудачи событие помечается мёртвым.

Поэтому эндпоинт должен быть идемпотентным. UPSERT по event_id; при дубликате верните 200 без повторной нотификации. Отклоняйте также запросы с timestamp старше 5 минут для защиты от replay-атак.

FAQ

Это платно? Нет, бесплатно для всех активных аффилиатов.

Есть тест-режим? Да, кнопка "Send Test Event" в панели.

Если потерял секрет? Сгенерируйте заново; старый аннулируется мгновенно.

Было полезно? Поделитесь.