Событие «Оплатил или сделал перевод»

Важно! Событие позволяет также реагировать на оплату в Telegram для платежных систем Prodamus и CloudPayments, а также для Telegram.

Универсальное событие позволяет реагировать на любые виды оплат.

Интеграция, приложение и событие позволяют:

• Реагировать на оплату любыми действиями, например отправкой ссылки на скачивание, закрытое сообщество тренинга или сайт.
• Подписывать после оплаты на скрытые группы подписчиков Senler. Например, на группу «Клиенты».
• Частично это позволяет организовать платные подписки. (авто-отписка через определенный период времени будет возможна после внедрения функционала Задержек).
• Автоматически благодарить человека за пожертвования.
• В пару кликов создавать ссылку на оплату (не покидая самого приложения) для последующей отправки внутри ВК в: сообщения, комментарии, рассылки и т. д.
• Автоматически формировать ссылку на оплату после заказа товара в ВК. И за счет всего вышеупомянутого полностью автоматизировать продажи через раздел Товары в ВК. Без сторонних сервисов.
• И много чего еще (зависит от вашей фантазии). 🙃

Рассмотрим его подробнее:

Параметры события:

Параметры достаточно простые, похожие на параметры события «Перешел по ссылке».

• Выбор сообщества (к которому привязана оплата— ссылка с настроек именно этого сообщества должна быть в настроена в интеграции).
• Тип ключевого слова: содержащим / равным /регул. выраж.
  Если нужно реагировать на любую оплату, ставьте «содержащим»!
• Название продукта / страницы оплаты.
  Если нужно реагировать на любую оплату, оставляйте пустым (и + см. предыдущий пункт).
• Тип сравнения суммы: равно / больше / меньше
• Сумма в рублях. Берется со страницы оплаты. После вычета комиссий реальное количество поступивших денег может отличаться. Больше 0 — то же самое что любая сумма.
• Тип оплаты. В выпадающем меню выбираете нужную платежную систему.
  При выборе любого типа оплаты — Автопилот будет реагировать на оплату из любой интегрированной платежной системы.

ВАЖНО!

В списке присутствуют платежные системы, не интегрированные в Автопилот, например, QIWI поэтому Автопилот на на них реагировать не будет.
Нужно также подключить приложение сообщества.

Рекомендуется после добавления события добавлять условие:
числовая переменная %vk_id% больше 0

Для того, чтобы команды запускалась только в случае если есть ID игрока, иначе если игрок оплатит не по ссылке, а, например, на ваш кошелек вам прилетит Ахтунг.

Настройка интеграции с Ю. Мoney.

Чтобы событие заработало нужно подключить Автопилот к вашему Ю. Money. Чтобы последний отправлял уведомления о поступлениях.

Для этого:

• В настройках Автопилота скопируйте Адрес для HTTP-уведомлений;
• Откройте настройки YooMoney (есть прямая ссылка там же), войдите по коду из SMS и вставьте этот адрес в соответствующее поле.
• Скопируйте секретный ключ и вставьте его в Автопилот (п.2)
• Скопируйте номер кошелька и вставьте его в Автопилот (п.1)
• Можете нажать кнопочку «Протестировать». Вам от вашего сообщества должно прийти сообщение о том что все хорошо.
• Обязательно поставьте галочку «Отправлять уведомления» и нажмите на кнопку «Сохранить»!

Аналогично настраивается для других платежных систем.
В Автопилоте открываем «Сообщества» находим нужное сообщество и открываем его «Настройки».

В настройках на первой вкладке Интеграции найдите раздел Prodamus и там:

• вставьте ссылку на аккаунт (1) в первое поле (она автоматически сократится до поддомена).
• и секретный ключ (2) вставьте во второе поле.
• ссылку на вебхук (3) из третьего поля, отправьте в техподдержку продамуса. Подробнее тут.

Важно! Если у вас несколько сообществ, то достаточно прописать в настройках сообществ имя аккаунта, ключи, а в Продамусе вебхук от одного сообщества, а АП далее сам разрулит, иначе будут задвоения, будьте внимательны.

Дальше создайте событие с типом «Оплатил / сделал перевод» (добавьте его в любую команду) и проведите тестовый платеж, чтобы проверить работу интеграции. Рекомендую для начала делать универсальную настройку, как здесь. Подробнее про интеграцию с prodamus читайте в статье.

Приложение сообщества

В настройках каждого сообщества в сервисе Автопилот доступна вкладочка «Приложение сообщества». Все параметры в ней размещены в порядке их отображения на странице.

• Баннер — в это поле вставьте прямую ссылку на картинку. Взять ее можно как из ВК, нажав в загруженной фотографии кнопку «Открыть оригинал». Так и например в Senler, таком же поле в настройках приложения.
• Заголовок формы пожертвования — Большой текст сразу под картинкой. Это очень важный параметр. Просто запомните это. Именно по заголовку сервис определяет из какой страницы была произведена оплата.
• Описание формы пожертвования — Текст обычным шрифтом под заголовком. Похоже как описание в Senler, только с поддержкой Markdown. Переменные тут также доступны.
• Сумма пожертвования по умолчанию (руб) — Сумма, которая, будет прописана в поле ввода суммы перевода (на главной странице приложения).
• Надпись на кнопке — Надпись на желтой кнопке YooMoney
• Инструкции для ручного перевода — Отдельный блок такого же стиля как и блоки платежных систем, только с возможностью прописать произвольный текст. Поддерживаются Markdown и Переменные.
• Ссылка «Вернуться на сайт» — Куда будет вести одноименная кнопка YooMoney после успешного перевода.

В конце вкладки есть кнопки для удобства (с понятными из названий назначениями):

• Установить в сообщество.
• Открыть приложение. Откроет главную страницу приложения.
• Открыть настройки в ВК. Откроет путь: Управление → Приложения → Приложение Автопилот.

Формирование ссылки на оплату

Если вы принимаете заказы через раздел Товары, то в действиях команды заказа вы можете использовать переменную %payment_link%. Она автоматически сформирует ссылку со всеми нужными параметрами. Эту итоговую ссылку вы можете копировать и использовать в любом другом месте.

Вы также можете сформировать ссылку вручную. Для этого достаточно на странице пожертвования (или любой другой странице оплаты) изменить название (оно редактируемое там для админов) и цену (ее тоже можно редактировать на любой странице. Достаточно кликнуть).

После того как название и сумма будут прописаны, прокрутите в конец и в блоке «Уголок админа» скопируйте готовую ссылку. Скопированную ссылку можно использовать в сообщениях, рассылке или любом другом месте в ВК.

Естественно, «Уголок админа» показывается только администраторам или редакторам сообщества!

Данные платежа (на примере Ю.Money)

Полезные данные по платежу (для использования в действиях) вы можете получить из следующих переменных:

• %content% — название страницы оплаты;
• %id_1% — сумма в рублях, указанная на странице оплаты;
• %yandex_amount% — сколько получено денег (вычтены комиссии)
• %yandex_sender% — номер кошелька отправителя, если платил со своего кошелька в YooMoney, а не через карту.
• %yandex_notification_type% — метод оплаты. В зависимости от метода будет подставлено одно из значений: Банковская карта или Ю.Money

Данные платежа (на примере Prodamus)

Полезные данные по платежу (для использования в действиях) вы можете получить из следующих переменных:

• %phone% — телефон;
• %date%— дата и время платежа (в Продамусе);
• %order_id% — ID заказа в Продамусе;
• %order_num% — (подписчик, страница, сообщество, счет);
• %domain% — домен аккаунта;
• %sum% — сумма перевода;
• %amount%— сумма перевода с вычетом комиссии;

• %commission%— комиссия магазина (%);
• %customer_phone% — телефон покупателя;
• %customer_email% — Email покупателя;
• %customer_extra% — название товара (комментарий);
• %payment_type% — платежная система (чем оплачено);
• %discount_value% руб. — сумма скидки;
• %param_test% — тестовый доп параметр;
• %ref% — идентификатор партнера;

Другие переменные доступные в команде

Данные счета в Автопилоте
№ счета в Автопилоте: %bill_num% 
Название счета в Автопилоте: %bill_title%
VK ID покупателя: %bill_sid%
VK ID менеджера: %bill_manager%
Статус счета числом:  %bill_status%
Полная стоимость в счете: %bill_price%
Уже получено на счет: %bill_amount% руб.
Осталось доплатить по счету: %bill_left% руб.
Комиссия платежной системы: %commission% %
________
Номер страницы: %page_id%
Список автопилота: %autopilot_id%
Группа Senler: %senler_group_id%
ID метки диалогов в ВК: %tag_id%
Ссылочка на курс: %course_url%
Сообщение поcле оплаты: %product_message%

Статус счета

Статус счета числом передается числом %bill_status%
0 - новый
1 - завершен
2 - отменен
3 - частично оплачен
4 - в работе

Тип платежной системы

Тип платежной системы передается числом в переменной %body_2%

0 - любой метод
1 - VK Pay
2 - Prodamus
3 - Fondy
4 - Telegram
5 - UnitPay
6 - InterKassa
7 - Ю.Money
8 - Ю.Касса
9 - Автопилот
10 - School Master
11 - CloudPayments

Параметры приложения

При необходимости вы можете самостоятельно сформировать ссылку на страницу в приложении. Для этого используйте параметры приложения. Выглядят они как обычные GET-параметры (тут можно почитать что это с примерами), только начинаются с #, а не с ?.

Название параметров Автопилота состоят обычно из одной или нескольких букв, например: t, s, i, exp. Но для удобства я напишу их сразу с разделителем (&amp;) и символом равно (=).

• t= — Название страницы (перед первым параметром разделитель не нужен).
• &amp;s= — Сумма перевода (в рублях) для форм оплаты. Натуральное число
• &amp;i= — Ссылка на изображение баннера. При заказе автоматически подставляется фотография товара.
• &amp;r= — Адрес для перенаправления. То есть это возможность использовать приложение как страницу редиректа, со всеми вытекающими. В этом случае баннер блокируется и не показывается (чтобы редирект был максимально быстрым).
• &exp= — Дата истечения срока действия страницы. Метка времени в секундах (Unix timestamp) после которой, страница вместо формы оплаты и блока «ручные методы оплаты» будет показывать то, что прописано в параметре Текст страницы «Время вышло» в настройках сообщества. Также не произойдет редирект, если указан параметр r.
• &exps= — Цена после истечения срока действия заказа. Если указан этот параметр, то вместо текста «Время вышло» будет показана полноценная форма, но с ценой взятой из этого параметра. Сработает только с параметром &amp;exp= или внутри динамической переменной {payment_link}.

• &amp;e= — Часть параметров (например t, s, i) могут быть зашифрованы в параметр e (во время копирования адреса страницы в приложении), чтобы подписчик не смог вручную их подредактировать. То есть их можно не прописывать вручную. Если прописать дополнительно какой-то из параметров в ссылку, то он перезапишет зашифрованный.
• &amp;n= — Назначение платежа. Если не задано, будет ссылка на пользователя и номер страницы оплаты (внутренний системный). Вы можете сменить это на что угодно, заполнив этот параметр. Будьте осторожны! Кириллические заголовки могут ломать страницу оплаты. Обязательно во время тестов оплатите сами с карты!
• &amp;d= — Выключить описание страницы. Может принимать значен
  ия: 0 — выключить описание для текущей страницы. 1 — будет показано описание, которое написано в настройках сервиса.
• &l=000 — Показать рейтинг списка с номером 000. По сути этого достаточно, но если добавить t=, то можно поменять название страницы рейтинга (по умолчанию берется название списка). Также если добавить &d=1, то описание будет не стандартное (%first_name%, ваша позиция в рейтинге: № %rating_position%), а взятое из настроек приложения (это в «Настройках» сообщества на сайте Автопилота).
• &custom= — Вы можете сами придумывать названия параметров и передавать их приложению. Например чтобы использовать в описании как переменную (например, %custom%). Название может быть практически любым (в рамках синтаксиса): parameter, tag, bobr, pig и т.д. Подробнее о формировании собственных переменных.

Пример готовой ссылки:
https://vk.com/app6177183_-41103148#t=Autopilot&s=1500&i=http://skyjoom.com/images/headers/raindrops.jpg&exp=1603107847&custom=text.

Эти же параметры можно дописывать к переменным. Например, так можно сделать чтобы человек по полученной ссылке мог платить только 3 дня:

%payment_link%&exp={date}%s|-3 day{/date}

Хотя для конкретно этой задачи есть вариант получше, либо используйте страницы приложения с типом: «товары»

Для тех, кому не хватило «четкости»

Или подробнее о GET-параметрах в Автопилоте

• Список GET-параметров для приложений Автопилота или Senler начинается с # (в отличии от сайтов, где используется ?).
• ? не используйте, он ломает ссылку и приводит к ошибке 404.
• Параметры передаются обязательно с их значениями! Между параметром и значением должен стоять знак равно =.
• первый параметр X и его значение пишем после знака # так:
  #X=XValue
• второй и последущие параметры Y, Z... и их значения пишем после знака &amp; так (другими словами — это разделитель параметр
  ов):&Y=YValue&amp;Z=ZValue
• Таким образом (#X=XValue&Y=YValue&Z=ZValue) мы передаём параметры: Х,Y,Z и их значения: XValue,YValue,ZValue соотвественно.
• Если надо передать пробел, можете написать %20 (Однако я не рекомендую использовать пробелы в принципе). Лучше — .

Теперь можете еще раз пересмотреть пример готовой ссылки:
https://vk.com/app6177183_-41103148#t=Autopilot&s=1500&i=http://skyjoom.com/images/headers/raindrops.jpg&exp=1603107847&custom=text.

А ещё вам может помочь, если вы попытаетесь прочитать список параметров на английском языке :)

Что делать если все равно не работает (на примере Интеграции с Ю.Money)

1. Самая частая ошибка - невнимательность во время настройки. В итоге получается один из вариантов:
   - не тот адрес сервера в YooMoney(от левого сервиса, а не Автопилота)!
   - не стоит галочка «Отправлять уведомления»!
   Помогает обычный тест (кнопка «Тестировать» в YooMoney) должно прийти сообщение вам от вашего сообществе, что все ОК. P. S. Оно не придет, если вы не разрешали вашему сообществу вам писать.
2. Проверьте работают ли другие команды. Проблема может быть совсем не в интеграции с YooMoney. :-)
3. Какая-то фигня в ключе. Обычно это + или /. Зачастую даже тест при этом проходит. Также иногда ключ может быть просто странным (для программы). В обоих случаях помогает пересоздание ключа (можно несколько раз).
4. Неправильный тест (или его отсутствие). Попробуйте для начала создать команду которая будет реагировать простым сообщением на любую оплату. Для этого в событии поставьте параметры: страница с названием «содержащим» пустую строку (никаких слов не пишите) и с ценой «больше» 0; И переведите себе в своем сообществе 2 руб. Если все получится, продолжайте настройку.