Partna
Как устроена партнёрская программа
Три части, у каждой своя работа. Ядро считает, мост принимает факты, кабинет показывает партнёру его цифры. Деньги остаются у владельца программы.
Схема
сайт и бэкенд владельца
│ факты: привязка, заказ, возврат, участник
▼
мост ──────────────► расчётное ядро
(домен владельца) (закрытый сервис)
│ чтение по токену
▼
кабинет партнёра
(наш домен или свой)
Мост не обязателен, если у владельца есть свой бэкенд: факты можно отправлять в ядро напрямую. Кабинет тоже не обязателен: партнёр может смотреть цифры внутри продукта владельца.
Что открыто, а что нет
- partna-bridge — мост: ставится на сервере владельца, прячет ключ, держит привязку в cookie и принимает вебхуки. MIT.
- partna-partner — кабинет партнёра: одна страница, читает данные по личной ссылке. MIT.
- ядро — закрытый сервис: планы, сеть, начисления, журнал обязательств, кабинет владельца.
Порядок подключения
- Владелец получает тенант и ключ в кабинете.
- Ставит мост по инструкции или вызывает ядро напрямую.
- Выдаёт партнёру ссылку: наша
/p/<токен>или своя сборка кабинета. - Дальше факты идут сами: клиент зарегистрировался — привязка, оплатил — заказ, вернули деньги — возврат.
Дальше
- Мост — установка, переменные, уровни интеграции.
- Кабинет партнёра — что видит партнёр и как поставить у себя.
- Контракты — факты и чтение: где первоисточник.
- Глоссарий — владелец, партнёр, клиент, хост.