Как принимать оплату в Telegram-боте и платить партнёрам

Что настроим

Партнёр делится ссылкой на вашего Telegram-бота. Покупатель открывает бота, нажимает кнопку оплаты и платит через ProOnline или PayAnyWay. Бот сам создаёт заказ с кодом партнёра, ждёт оплату и после неё присылает доступ, например ссылку на закрытый канал. Партнёр получает вознаграждение, в том числе за продления, которые покупатель оплачивает позже без его ссылки.

Бот собирается в разделе «Чат-боты», код писать не нужно.

Что нужно заранее

• Тариф «Базовый» или «Оптимальный». На «Базовом» можно подключить 1 бота и вести 100 подписчиков, на «Оптимальном» 3 бота и 1000 подписчиков.

• Доступ владельца магазина. Бота и способ оплаты подключает только владелец.

• Аккаунт в ProOnline (ID школы, API-ключ и секрет подписи вебхука) или подключённый PayAnyWay.

• Закрытый канал или чат в Telegram, куда бот пустит покупателя после оплаты.

Шаг 1. Подключите способ оплаты

Способ оплаты подключается в «Настройки» → «Интеграции». Ниже пример для ProOnline, PayAnyWay подключается там же, в карточке «PayAnyWay».

1. Откройте «Настройки» → «Интеграции» и выберите «ProOnline».

2. Заполните «ID школы», «API-ключ» и «Секрет подписи вебхука».

3. В «Адрес для уведомлений» выберите «Создать новый адрес».

4. Нажмите «Сохранить».

5. Скопируйте «Адрес вебхука для ProOnline» и укажите его в кабинете ProOnline. На этот адрес ProOnline сообщает об оплатах.

Телу уведомления Рефсейлс не доверяет: получив его, он сам запрашивает статус оплаты в ProOnline вашим ключом.

Шаг 2. Подключите бота

1. Откройте @BotFather в Telegram и отправьте команду /newbot.

2. Задайте имя и адрес бота. BotFather пришлёт токен вида 123456789:AA....

3. В Рефсейлс откройте «Настройки» → «Интеграции» и выберите «Telegram-бот».

4. Вставьте токен в поле «Токен бота» и нажмите «Подключить».

В списке появится адрес бота с зелёной точкой. Переписка бота с покупателями будет видна в разделе «Чат».

Зелёная точка у адреса бота значит, что бот получает сообщения.

Шаг 3. Добавьте товар

1. Откройте раздел «Товары/Услуги» и нажмите «Добавить».

2. Заполните «Название» и «Цена», например «Курс «Основы вязания»» и 4 900 ₽.

3. Сохраните товар.

Бот создаёт заказ по цене из каталога. Поменяете цену у товара, и следующие заказы из бота пойдут по новой.

Шаг 4. Создайте партнёрскую программу

1. Откройте раздел «Программы» и нажмите «Создать». Откроется мастер из пяти шагов.

2. На шаге «Основное» в поле «Ссылка на сайт или Telegram-бота *» укажите адрес бота, например https://t.me/MyBot, и нажмите «Далее».

3. На шаге «Вознаграждение» в «Тип вознаграждения *» выберите «Процент» и заполните «Размер вознаграждения *».

4. Если нужна гарантированная сумма, заполните «Не менее за заказ». Партнёр получит большее из двух значений.

5. В «Повторные заказы клиента» выберите «Все заказы», чтобы партнёр получал вознаграждение за каждое продление. Нажмите «Далее».

6. На шаге «Товары и услуги» в блоке «Товары и услуги программы» отметьте товар из шага 3 и нажмите «Далее».

7. На шаге «Правила» отметьте хотя бы один канал привлечения и нажмите «Далее».

8. На последнем шаге нажмите «Создать программу».

Адрес бота вписывается в поле «Ссылка на сайт или Telegram-бота *».

Ставка 20%, но не меньше 500 ₽. С курса за 4 900 ₽ партнёр получит 980 ₽ с каждой оплаты, включая продления.

Каждый партнёр получит в кабинете, в разделе «Программа», личную ссылку с кодом:

https://t.me/MyBot?start=AB12CD34

Код после start= бот запоминает за покупателем и передаёт в заказ.

Шаг 5. Соберите сценарий

1. Откройте раздел «Чат-боты» и нажмите «Создать сценарий».

2. В окне «Новый сценарий» введите название, например «Оплата клуба», и нажмите «Создать». Если ботов несколько, выберите нужного в поле «Бот».

Откроется холст с двумя блоками: «Точка входа /start» и приветствие. Блоки добавляются из панели слева: перетащите блок на холст или кликните по холсту правой кнопкой. Выход справа у блока соединяется со входом следующего.

1. Кликните «Точка входа /start» и оставьте поле «Метка» пустым. Так блок сработает и на обычный /start, и на ссылки партнёров с кодом.

2. Кликните приветствие и напишите текст, например «Здравствуйте! Это клуб вязания. Уроки выходят в закрытом канале».

3. В «Кнопки» добавьте кнопку «Вступить в клуб».

4. Добавьте на холст блок «Оплата» и соедините с ним выход кнопки «Вступить в клуб».

Готовый сценарий: вход по /start и по слову «продлить», блок «Оплата» и два ответа после него.

Настройте блок «Оплата»

1. В «Товар» выберите товар из шага 3.

2. В «Способ оплаты» оставьте «Подключённый способ», если подключён один способ. Если подключены и ProOnline, и PayAnyWay, выберите нужный.

3. В «Текст» напишите, за что покупатель платит, например «Доступ к урокам на месяц стоит 4 900 ₽. Нажмите кнопку, чтобы оплатить».

4. В «Кнопка» укажите подпись кнопки, например «Оплатить».

5. В «Ждать оплату, мин» укажите, сколько бот ждёт оплату. Подойдёт от 1 минуты до 7 дней, например 1440 минут, то есть сутки.

Настройки блока «Оплата» открываются справа по клику на блок.

Когда покупатель доходит до этого блока, бот создаёт заказ с кодом партнёра из ссылки и присылает сообщение с кнопкой оплаты. У блока два выхода: «Оплачено» и «Не оплачено». По второму бот идёт, если оплата не пришла за заданное время.

Выдайте доступ после оплаты

1. Добавьте блок «Сообщение» и соедините его с выходом «Оплачено».

2. Напишите текст, например «Оплата получена. Добро пожаловать в клуб».

3. В «Кнопки» добавьте кнопку со ссылкой на закрытый канал.

4. Добавьте ещё одно «Сообщение» на выход «Не оплачено». Напишите в нём, что оплата не пришла и новую ссылку бот пришлёт на слово «оплатить».

Ссылка на канал одна для всех покупателей, её можно переслать. Новых участников канала стоит сверять со списком заказов.

Включите сценарий

Сценарий сохраняется сам, пока вы его правите. Когда блоки соединены, включите переключатель в верхней панели: подпись сменится на «Включён». Если какой-то блок не настроен, в верхней панели появится текст ошибки.

Шаг 6. Закрывайте заказ после оплаты

Рефсейлс начисляет вознаграждение, когда заказ переходит в статус «Выполнен». Оплата меняет только статус оплаты, поэтому настройте автоматизацию:

1. Откройте раздел «Автоматизации» и нажмите «Создать».

2. В окне «Новая автоматизация» выберите триггер «Смена статуса оплаты».

3. В поле «В статус оплаты (необязательно)» выберите оплаченный статус.

4. Добавьте действие «Сменить статус заказа» и в «Целевой статус» выберите «Выполнен».

5. Сохраните автоматизацию и включите её переключателем в списке.

Шаг 7. Добавьте продление

Бот не списывает деньги сам каждый месяц. Покупатель продлевает подписку, когда пишет боту слово, по которому бот снова присылает оплату.

1. Добавьте на холст блок «Ключевые слова».

2. Впишите слова, например «продлить» и «оплатить».

3. Соедините его выход с тем же блоком «Оплата».

Каждый заход в блок «Оплата» создаёт новый заказ. Код партнёра при продлении не нужен: бот привязывает заказы к карточке клиента по Telegram ID, а клиент закреплён за партнёром с первого заказа по его ссылке. При выбранном «Все заказы» в программе продление засчитается этому партнёру.

Как проверить, что работает

1. Откройте ссылку тестового партнёра из его кабинета и нажмите «Запустить» в боте.

2. Нажмите «Вступить в клуб». Бот пришлёт сообщение с кнопкой «Оплатить».

3. Откройте раздел «Заказы». Там появится заказ на товар из шага 3, у него указан партнёр.

4. Оплатите заказ. Бот пришлёт сообщение с выхода «Оплачено».

5. Проверьте заказ: он оплачен и после автоматизации из шага 6 перешёл в «Выполнен». У партнёра появилось начисление.

6. Напишите боту «продлить». Придёт новая ссылка, в «Заказах» появится второй заказ того же клиента с тем же партнёром.

Если оплата прошла, а бот молчит, откройте «Настройки» → «Интеграции» → «ProOnline»: в блоке «Последние уведомления» видно, что прислал ProOnline.

Если не работает

• Бот не отвечает на /start. Сценарий выключен или в нём не выбран бот. Откройте сценарий и проверьте верхнюю панель. Если на странице «Telegram-бот» горит «Бот не получает сообщения», проверьте бота в @BotFather и подключите его заново.

• После кнопки бот замолчал, заказа нет. Не удалось создать заказ или ссылку на оплату. Проверьте, что товар в блоке «Оплата» не удалён и у него есть цена, а способ оплаты подключён. Если подключены оба способа, выберите в блоке один из них вместо «Подключённый способ».

• Заказ создан без партнёра. Покупатель открыл бота не по ссылке партнёра, или в коде после start= опечатка. Ещё одна причина: у точки входа /start заполнена «Метка». Такой блок ловит только ссылку со своей меткой, а ссылки партнёров уходят мимо.

• Оплата прошла, а заказ не оплачен. ProOnline не прислал уведомление на адрес из шага 1. Проверьте блок «Последние уведомления» на странице ProOnline и адрес в кабинете ProOnline.

• Заказ оплачен, но партнёру ничего не начислено. Заказ не перешёл в «Выполнен». Проверьте, что автоматизация из шага 6 включена.

• Продление не засчиталось партнёру. В программе в «Повторные заказы клиента» выбрано не «Все заказы».

• Бот перестал вести покупателя. Менеджер ответил ему в разделе «Чат», и бот встал на паузу. Нажмите в чате «Вернуть боту».

• Новые люди не получают ответа бота. Над списком сценариев горит «Лимит подписчиков исчерпан». Сообщения сверх лимита приходят в «Чат». Смените тариф или отвечайте вручную.

Частые вопросы

Нужен ли разработчик?

Нет. Сценарий собирается в разделе «Чат-боты» из блоков. Если бот у вас уже написан, его можно связать с Рефсейлс через API, описание в разделе для разработчиков.

Что будет, если покупатель придёт по ссылке другого партнёра?

Заказ с кодом засчитается партнёру из этого кода. Покупатель останется закреплён за партнёром, который привёл его первым, и следующие заказы без кода уйдут первому.

Когда вознаграждение можно выплатить?

После срока из поля «Срок заморозки вознаграждения» в программе. Отсчёт идёт от момента, когда заказ стал выполненным.

Можно ли принимать оплату и через ProOnline, и через PayAnyWay?

Да. Подключите оба способа и в каждом блоке «Оплата» выберите нужный в поле «Способ оплаты».

Видно ли переписку бота с покупателем?

Да, в разделе «Чат». Если менеджер ответит покупателю сам, бот встанет на паузу. Вернуть покупателя боту можно кнопкой «Вернуть боту».