В статье описан один из вариантов, как может быть интегрирована партнерская программа в бизнес процессы компании.
Предположим, имеется CRM система (например битрикс 24), в которую попадает информация о всех платежах, а также находятся клиенты, партнеры и попадают лиды с форм регистрации на сайте и лэндингах
- Регистрация партнера. Партнер регистрируется на лэндинге, где размещено предложение принять участие в партнерской программе, и попадает в CRM.
- В этот момент по интеграции идет запрос к API WinWinLand на создание партнера. (POST /lead/)
В запросе есть поле с партнерским кодом. Его нужно пустым, чтобы партнерский код создался автоматически, либо указать (например 12345)
Вот это поле:
make_partner => 1 или 0 — не обязательно, по умолчанию 0. Сделать партнером. Если лид уже зарегистрирован, как партнер, то ничего не происходит. Если лид уже существует в базе, то он будет сделан партнером.
make_partner_code => — не обязательно, партнерский код для вновь созданного партнера. Работает только при make_partner=1,если не задано или 0 — то создается автоматически числовой, при создании партнера.
Например, указывается make_partner_code=12345
- Партнерский код участвует в ссылке на подписной лэндинг с формой регистрации для обычных, с параметром bc
например https://ваш_сайт/?bc=12345. Партнер дает кому то эту ссылку, регистрация с сайта попадает в CRM - От CRM делается такой же запрос к API, но на создание лида:
make_partner => 0
и
bc => (int) партнерский код — присваивается 12345. Код нужно выделить из адресной строки браузера, передать в CRM вместе с формой регистрации, а затем использовать в запросе к API WinWinLand.
Таким образом API WinWinLand определяет, что лида надо закрепить за конкретным партнером.
(второй способ — это использовать партнерский промокод, который применяется при оплате, здесь не рассматриваем)
- В обоих запросах на создание лида или партнера возвращается параметр UID — ID записи в WinWinLand. Его желательно сохранить в CRM за этим лидом.
- Далее клиент оплачивает. Оплата попадает в CRM.
Отправляется запрос на добавление оплаты POST /pay/, с контактами клиента (телефон и или емэйл или (правильнее) UID клиента в WinWinLand. - WinWinLand по UID, телефону, или емэйлу идентифицирует лида у себя, определяет партнера, за которым он закреплен, и начисляет вознаграждение согласно настройкам.
- Вознаграждения и все взаиморасчеты с партнером можно видеть в отчетах в WinWinLand, его видит партнер в ЛК, по этому событию можно настроить получение вебхука с полными данными о партнере, либо сделать запрос GET /lead/ и также получить полные данные о партнере, начислениях и выплатах (этот запрос можно использовать при создании кастомного партнерского кабинета).