RioPay

Приём оплаты банковской картой и по СБП через RioPay (РиоПэй): покупатель платит на странице оплаты RioPay, деньги приходят на баланс вашего аккаунта RioPay. Оплату подтверждает уведомление RioPay, после этого покупатель получает доступ к каналу или группе. Аккаунт и API-токен выдаёт менеджер RioPay.

Кому подходитСкопировать ссылку на раздел

• В Mini App RioPay помечен «Юр. лица». Кого RioPay подключает, на сайте RioPay не сказано: условия уточните у менеджера RioPay.
• Покупатель видит в боте одну кнопку «RioPay (карта, СБП)», а карту или СБП выбирает на странице оплаты RioPay. Сумма к оплате равна цене тарифа в рублях, а с промокодом цене со скидкой.
• Сумма должна укладываться в пределы вашего аккаунта RioPay: Mini App показывает их после подключения в строке «Сумма платежа».
• Автопродления нет: за каждый срок подписки покупатель платит сам.

Сравнить с другими способами: сравнительная таблица платёжных систем.

Что нужно заранееСкопировать ссылку на раздел

Для шагов ниже:

• Проект в Vanderu: как создать проект. Пока проекта нет, на главном экране Mini App нет раздела «Настройки».
• Аккаунт RioPay с приёмом оплаты в рублях и API-токен. Самостоятельной регистрации у RioPay нет: связаться с менеджером можно через сайт RioPay.
• Запущенный @vanderu_bot: в нём приходят сообщения о продажах и о сбоях способа оплаты. Если вы ещё не писали ему, откройте с ним чат и отправьте /start.

Чтобы покупатель увидел способ в боте: канал или группа (канал, группа) и платный тариф проекта (как создать тариф).

Получите API-токен у менеджера RioPayСкопировать ссылку на раздел

1. Попросите менеджера RioPay выдать API-токен для настоящих оплат, не тестовый, и включить приём оплаты в рублях.
2. Спросите, выдаёт ли он отдельный секрет подписи уведомлений. Обычно RioPay подписывает уведомления тем же API-токеном, и отдельного секрета нет.

Подключите RioPay в Mini AppСкопировать ссылку на раздел

1. Откройте Mini App из чата с @vanderu_bot и прокрутите главный экран вниз. В разделе «Настройки» нажмите «Платежные системы». Откроется экран «Выберите платежную систему».

2. Найдите в списке карточку «RioPay» и нажмите её. Откроется экран «Подключение RioPay» с разделами «Что понадобится» и «Как получить ключи».

3. Вставьте токен в поле «API-токен» целиком, без пробелов.

   
   Неверный секрет в следующем поле не даст Vanderu проверить ни одно уведомление RioPay. Оплаты будут проходить, но покупатели получат доступ с задержкой.

4. Поле «Секрет подписи уведомлений (необязательно)» заполните, только если менеджер выдал секрет отдельно. Иначе оставьте его пустым.

5. Внизу экрана нажмите «Сохранить». Vanderu проверит токен у RioPay и найдёт в аккаунте сервис для приёма рублей. Если всё в порядке, Mini App покажет «Ключи проверены, способ оплаты подключён» и откроет экран «Детали RioPay»: в строке «Статус» стоит «Принимает оплату», в строке «Сервис RioPay» название сервиса, в строке «Сумма платежа» пределы суммы, если RioPay их сообщил.

   

6. Сверьте цены тарифов со строкой «Сумма платежа». Цена тарифа, а с промокодом цена со скидкой, должна быть в этих пределах: иначе покупатель увидит кнопку RioPay, но бот ответит ему «Ошибка создания платежа. Попробуйте еще раз». Если строки «Сумма платежа» нет, RioPay пределов не сообщил: уточните их у менеджера RioPay.

Способ сразу появляется у покупателей во всех ваших проектах, в том числе в новых. Чтобы оставить его только в некоторых проектах, на экране «Детали RioPay» нажмите «Проекты».

Как покупатель платитСкопировать ссылку на раздел

1. Покупатель открывает бота проекта, нажимает «Тарифы» и выбирает тариф.
2. Нажимает кнопку «RioPay (карта, СБП)». Бот показывает сумму, канал, тариф и срок и кнопки «Оплатить» и «Отменить платеж».
3. «Оплатить» открывает страницу оплаты RioPay. Там покупатель выбирает карту или СБП и платит.
4. Когда оплата прошла и Vanderu узнал о ней, бот проекта присылает покупателю дату окончания подписки и, если покупателя ещё нет в канале, ссылку на вход. Ссылка одноразовая и действует до конца подписки. Если тариф открывает доступ к нескольким каналам, бот пришлёт по ссылке на каждый канал, где покупателя нет.
5. Оплата появляется в разделе «Продажи», а @vanderu_bot присылает вам сообщение «Новая продажа», в строке «Способ оплаты» стоит «RioPay».

Адрес для уведомлений Vanderu передаёт RioPay в каждой оплате, вставлять его никуда не нужно. Если уведомление RioPay не пришло или не прошло проверку подписи, Vanderu находит оплату сам, первый раз через 2 минуты после того, как покупатель нажал кнопку RioPay. Покупатель получает доступ после такой проверки, а не сразу после оплаты.

«Отменить платеж» возвращает покупателя к выбору способа оплаты, но страницу оплаты RioPay не закрывает. Если покупатель всё же заплатит на ней, Vanderu засчитает оплату, только когда получит уведомление RioPay и подпись пройдёт проверку: если менеджер выдал отдельный секрет, он вставлен в поле секрета, а если не выдал, поле пустое. Иначе такая оплата останется без доступа.

Текст сообщения со ссылкой меняется в Mini App: на экране проекта нажмите «Сообщения бота», затем «После покупки». Ссылка стоит в тексте там, где написано {link}, а дата окончания подписки — там, где {date}. Если убрать их из текста, покупатель не получит ссылку или дату.

Как проверитьСкопировать ссылку на раздел

Вернитесь на экран «Выберите платежную систему»: у карточки «RioPay» стоит метка «Подключено».

Проверьте без оплаты:

1. Откройте бота своего проекта и нажмите «Тарифы».
2. Если бот попросит «Выбери ресурс», выберите канал. Затем выберите тариф с ценой в пределах строки «Сумма платежа».
3. Нажмите «RioPay (карта, СБП)».
4. Если бот прислал сообщение с кнопкой «Оплатить», API-токен подходит и выдан для настоящих оплат. Секрет подписи этот шаг не проверяет: его проверит первая настоящая оплата. Если её уведомление не пройдёт проверку, @vanderu_bot пришлёт сообщение, что оплату нашли с задержкой.
5. Нажмите «Отменить платеж».

На экране «Детали RioPay» эта оплата появится в списке оплат под кнопками со статусом «Отменено».

Выдачу доступа и уведомления можно проверить только настоящей оплатой: деньги придут на баланс вашего аккаунта RioPay, а в «Продажи» запишется продажа. В списке оплат на экране «Детали RioPay» она будет со статусом «Оплачено».

Изменить, отключить или удалить RioPayСкопировать ссылку на раздел

На главном экране Mini App в разделе «Настройки» нажмите «Платежные системы», затем «RioPay». Откроется экран «Детали RioPay».

• Чтобы заменить токен или секрет, нажмите «Изменить ключи», заполните поля и нажмите «Сохранить». Сохранённые ключи Mini App не показывает: вставьте их заново. Сервис и пределы суммы Vanderu при этом перечитает у RioPay.
• Чтобы оставить RioPay только в некоторых проектах, нажмите «Проекты», выключите лишние проекты и нажмите «Сохранить».
• Чтобы скрыть RioPay от покупателей во всех проектах, нажмите «Отключить» и подтвердите. Оплаты, начатые до отключения, засчитаются, а ключи и выбор проектов сохранятся. Вернуть способ можно кнопкой «Включить»: Vanderu снова проверит токен у RioPay.

Чтобы удалить RioPay, нажмите «Удалить», а затем в течение 5 секунд ещё раз, когда кнопка покажет «Нажмите ещё раз, чтобы удалить». Vanderu сотрёт ключи, продажи в разделе «Продажи» останутся.

Если не получилосьСкопировать ссылку на раздел

Mini App пишет «Неверный API-токен RioPay»Скопировать ссылку на раздел

Скопируйте токен целиком, без пробелов, и вставьте заново. Если не помогло, попросите у менеджера RioPay новый токен.

Mini App пишет «В аккаунте RioPay нет сервиса для приёма рублей»Скопировать ссылку на раздел

Попросите менеджера RioPay включить приём оплаты в рублях, затем снова нажмите «Сохранить».

Покупатель видит «Ошибка создания платежа»Скопировать ссылку на раздел

Проверьте, что цена тарифа в пределах строки «Сумма платежа» на экране «Детали RioPay». Если нет, измените цену тарифа или попросите менеджера RioPay расширить пределы. Затем нажмите «Изменить ключи» и сохраните токен заново: Vanderu перечитает пределы.

Если цена в пределах, возможно, токен выдан для тестового терминала или у аккаунта RioPay нет активного магазина. Проверку ключей такой токен проходит, поэтому на экране «Детали RioPay» стоит «Принимает оплату», а @vanderu_bot вам не пишет. Попросите менеджера RioPay включить магазин и выдать токен для настоящих оплат, затем нажмите «Изменить ключи» и вставьте его.

На экране «Детали RioPay» появился блок «Способ не работает»Скопировать ссылку на раздел

Если в блоке написано «Причина: ключи магазина больше не подходят», RioPay больше не принимает этот токен, например потому, что его отозвали. Первый отказ покупатель видит как «Ошибка создания платежа», а после повторного отказа, не раньше чем через 5 минут, бот пишет покупателям «Оплата этим способом сейчас не работает» или не показывает кнопку RioPay, и @vanderu_bot присылает вам сообщение. Попросите у менеджера RioPay новый токен для настоящих оплат, затем нажмите «Изменить ключи» и вставьте его.

Покупатель оплатил, а доступ пришёл с задержкойСкопировать ссылку на раздел

Уведомление RioPay не пришло или не прошло проверку подписи, и Vanderu нашёл оплату сам. Если поле «Секрет подписи уведомлений (необязательно)» заполнено, спросите менеджера RioPay, выдаёт ли он отдельный секрет. Если не выдаёт, нажмите «Изменить ключи», вставьте токен заново, поле секрета оставьте пустым и нажмите «Сохранить». Если оплату нашла проверка Vanderu, а уведомления не было, @vanderu_bot один раз пришлёт об этом сообщение.

Покупатель оплатил после «Отменить платеж», а доступа нетСкопировать ссылку на раздел

Такую оплату Vanderu засчитывает только по уведомлению RioPay, а оно не прошло проверку подписи. Сначала исправьте секрет, как в предыдущем разделе. RioPay повторяет непринятое уведомление в течение нескольких часов, поэтому после исправления Vanderu может засчитать оплату сам: посмотрите, нет ли её в разделе «Продажи». Если её там нет, а деньги пришли, выдайте этому покупателю доступ вручную: на экране проекта нажмите «Добавить подписчика», выберите тариф и нажмите «Добавить подписку». Mini App покажет ссылку, перешлите её покупателю. Если уведомление по этой оплате всё же пройдёт после ручной выдачи, Vanderu засчитает оплату, и покупатель получит ещё один срок подписки.

Покупатель пишет, что при создании ссылки произошла ошибкаСкопировать ссылку на раздел

Оплата прошла, подписка записана, но @vanderu_bot не смог создать ссылку на вход, например потому, что у него нет прав администратора в канале. Верните ему права, чтобы это не повторилось: для канала, для группы. Этому покупателю бот ссылку повторно не пришлёт: напишите в поддержку @vanderusupport_bot и назовите проект, дату и сумму оплаты из списка оплат на экране «Детали RioPay».

В боте нет кнопки RioPayСкопировать ссылку на раздел

Проверьте по порядку:

• на экране «Детали RioPay» в строке «Статус» стоит «Отключён»: нажмите «Включить»;
• проект выключен в «Проекты»: на экране «Детали RioPay» нажмите «Проекты», включите проект и нажмите «Сохранить»;
• на экране «Детали RioPay» в строке «Статус» стоит «Ошибка» или есть блок «Способ не работает»: там же написано, что случилось и что сделать. Сломанный способ бот показывает, только если у проекта нет другого рабочего способа оплаты.

Если не помоглоСкопировать ссылку на раздел

Напишите в поддержку: @vanderusupport_bot.

ОграниченияСкопировать ссылку на раздел

• Оплата только в рублях. Цена тарифа, а с промокодом цена со скидкой, должна быть в пределах строки «Сумма платежа»: иначе покупатель увидит кнопку RioPay, но бот ответит ему «Ошибка создания платежа. Попробуйте еще раз».
• Если тариф проекта бесплатный, способов оплаты у него нет: покупатель получает доступ кнопкой «Получить». Пробный тариф проекта (от 3 до 30 дней по цене ниже тарифа продления, затем автопродление) оплачивается только через ЮKassa с автопродлением, RioPay у него не показывается.
• Возвраты Vanderu не делает. Если вы вернёте деньги покупателю через RioPay, доступ к каналу у него останется. Если банк покупателя оспорит оплату, @vanderu_bot пришлёт сообщение, доступ тоже останется.
• Комиссию, пределы суммы и вывод денег определяет RioPay: публичной страницы с комиссиями у RioPay нет, условия уточните у менеджера RioPay до подключения.
• Сколько вы платите Vanderu: тарифы Vanderu.