PayPalych

Покупатель выбирает тариф в боте проекта и платит по СБП или картой на странице оплаты PayPalych (Pal24, Палыч), а деньги приходят на баланс вашего магазина в PayPalych. Оплату подтверждает уведомление PayPalych, после него бот проекта отправляет покупателю ссылку на вход в канал или группу.

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

• В Mini App PayPalych помечен «Физ. / Юр. лица». Нужен свой магазин в PayPalych, прошедший модерацию.
• На экране подключения Mini App предупреждает: «Vanderu не проверяет PayPalych: условия и риски приёма оплат — по договору между вами и PayPalych».
• Покупатель платит в рублях, по СБП или картой.
• Автопродления нет: за каждый срок подписки покупатель платит сам.

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

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

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

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

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

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

1. В кабинете PayPalych откройте «API интеграция». Там лежит API-токен.
2. Найдите ID магазина в списке магазинов. Он состоит из латинских букв и цифр, например LXZv3R7Q8B.

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

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

2. Нажмите «PayPalych». Откроется экран «Подключение PayPalych» с полями «API-токен», «ID магазина» и «Токен подписи (необязательно)». Кнопка «Кабинет PayPalych» на этом экране открывает кабинет.

3. Если в кабинете PayPalych для API включён белый список IP-адресов, добавьте в него адрес сервера Vanderu. Адрес написан в шагах на экране «Подключение PayPalych».

4. Скопируйте API-токен в кабинете PayPalych и вставьте его в поле «API-токен» целиком, без пробелов.

5. Скопируйте ID магазина и вставьте его в поле «ID магазина».

6. Если в кабинете PayPalych нет отдельного ключа подписи, оставьте поле «Токен подписи (необязательно)» пустым. Если ключ есть и вы его вставите, он должен совпадать с кабинетом: Vanderu будет проверять им уведомления, и с чужим ключом доступ покупатели будут получать с задержкой.

   

7. Нажмите «Сохранить» внизу экрана. Vanderu проверит токен и магазин у PayPalych. Mini App покажет «Ключи проверены, способ оплаты подключён» и откроет экран «Детали PayPalych» со статусом «Принимает оплату».

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

Укажите адрес для уведомленийСкопировать ссылку на раздел

Пока адрес не вставлен, PayPalych не сообщает Vanderu об оплате, и Vanderu проверяет её сам: первые 30 минут после того, как покупатель выбрал метод в боте, раз в 2 минуты, до 3 часов раз в 15 минут, затем раз в час. После «Отменить платеж» Vanderu оплату не проверяет: такую оплату засчитает только уведомление.

1. На экране «Детали PayPalych», в блоке «Уведомления об оплате», нажмите на адрес под вторым шагом. Mini App покажет «Ссылка скопирована». Открывать адрес не нужно.

   

2. В кабинете PayPalych откройте настройки магазина.

3. Вставьте адрес в поле «Result URL» и сохраните.

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

На экране «Детали PayPalych», в блоке «Кнопки оплаты в боте», выберите режим и нажмите «Сохранить». Mini App покажет «Кнопки оплаты сохранены».

• «Все»: кнопки «СБП» и «Карта».
• «Выбранные»: кнопки только для методов, которые вы отметите.
• «Одна кнопка»: в боте одна кнопка «PayPalych (СБП, карта)», метод покупатель выбирает на странице оплаты PayPalych. В подсказке под режимом Mini App пишет «карта, СБП», в боте порядок обратный.

PayPalych не сообщает Vanderu, какие методы включены в магазине, поэтому в режиме «Все» бот показывает обе кнопки. Если PayPalych откажет в оплате одним из методов, Vanderu уберёт его кнопку, а @vanderu_bot напишет вам. Когда включите этот метод в кабинете PayPalych, нажмите «Обновить список способов».

На кнопках методов нет названия PayPalych. Если у вас подключён ещё один способ оплаты с кнопками «Карта» и «СБП», покупатель увидит эти кнопки дважды. Чтобы этого не было, у одного из способов выберите «Одна кнопка».

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

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

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

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

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

Проверочного платежа у PayPalych в Vanderu нет. Пока PayPalych не прислал ни одного уведомления, у карточки «PayPalych» на экране «Выберите платежную систему» стоит метка «Нужно внимание».

Проверьте со стороны покупателя, не платя:

1. Откройте бота своего проекта и нажмите «Тарифы». Если бот попросит «Выбери ресурс», выберите канал. Затем выберите тариф.
2. Нажмите «СБП», «Карта» или «PayPalych (СБП, карта)». Если бот прислал сообщение с кнопкой «Оплатить», API-токен и ID магазина подходят. «Токен подписи» проверит только первое уведомление об оплате.
3. Нажмите «Отменить платеж».

Чтобы подтвердить уведомления, оплатите тариф из своего бота: деньги поступят в ваш магазин PayPalych, продажа появится в разделе «Продажи», бот пришлёт дату окончания подписки. Затем на экране «Детали PayPalych» нажмите «Обновить статус»: в блоке «Уведомления об оплате» появится «Уведомления подтверждены» с датой, а метка карточки сменится на «Подключено». Уведомления подтвердит и любая другая оплата в этом магазине, даже не из Vanderu. Если вы создали этот канал, ссылку на вход бот не пришлёт: для Vanderu вы уже в канале.

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

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

Чтобы оставить PayPalych только в некоторых проектах, нажмите «Проекты», выключите лишние проекты и нажмите «Сохранить».

Чтобы заменить ключи, нажмите «Изменить ключи». Откроется форма «Новые ключи PayPalych». Сохранённые ключи Mini App не показывает: вставьте API-токен и ID магазина заново, а «Токен подписи (необязательно)» — если он у вас есть, и нажмите «Сохранить». Если это другой магазин, уведомления нужно подтвердить заново, а кнопки оплаты вернутся к режиму «Все». Если PayPalych отключён, новые ключи его не включат: нажмите «Включить».

Чтобы скрыть PayPalych от покупателей во всех проектах, нажмите «Отключить» и подтвердите. Оплаты, начатые до отключения, засчитаются, а ключи и настройки сохранятся. Вернуть способ можно кнопкой «Включить»: Vanderu снова проверит ключи у PayPalych.

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

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

Mini App пишет «PayPalych не пускает запросы с сервера Vanderu»Скопировать ссылку на раздел

В кабинете PayPalych для API включён белый список IP-адресов. Добавьте в него адрес из сообщения или выключите список, затем нажмите «Сохранить» ещё раз.

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

Токен скопирован не целиком или больше не действует. Скопируйте его заново на странице «API интеграция» в кабинете PayPalych.

Mini App пишет «Магазин с таким ID не найден»Скопировать ссылку на раздел

ID магазина не принадлежит аккаунту этого API-токена. Проверьте ID в списке магазинов в кабинете PayPalych.

Mini App пишет «PayPalych ограничил доступ этому аккаунту»Скопировать ссылку на раздел

Ограничение поставил PayPalych. Напишите в поддержку PayPalych.

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

Уведомление не дошло или не прошло проверку подписи, и оплату нашёл сам Vanderu. Пока уведомления ни разу не подтверждались, @vanderu_bot один раз присылает об этом сообщение: оплата покупателя прошла, но уведомление от PayPalych не пришло. Проверьте, что в поле «Result URL» стоит адрес из Mini App целиком.

Доступ приходит с задержкой, а «Токен подписи» заполненСкопировать ссылку на раздел

Ключ подписи в Mini App не совпадает с кабинетом PayPalych, и Vanderu не принимает уведомления. Нажмите «Изменить ключи» и вставьте ключ подписи из кабинета или оставьте поле «Токен подписи (необязательно)» пустым.

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

Такую оплату Vanderu засчитывает только по уведомлению PayPalych, а уведомление не пришло или не прошло проверку подписи: в поле «Result URL» нет адреса из Mini App, или ключ подписи в Mini App не совпадает с кабинетом PayPalych.

1. Исправьте причину: вставьте адрес в поле «Result URL» или исправьте ключ подписи, как в разделе «Доступ приходит с задержкой, а «Токен подписи» заполнен».
2. Найдите оплату в кабинете PayPalych.
3. Проверьте, не появилась ли оплата в разделе «Продажи». PayPalych повторяет непринятое уведомление 5 раз в течение суток с лишним, и после исправления повтор может засчитать оплату.
4. Если продажи нет, а оплата в кабинете прошла, выдайте доступ вручную: на экране проекта нажмите «Добавить подписчика», выберите тариф и нажмите «Добавить подписку». Mini App покажет ссылку, перешлите её покупателю. Если уведомление по этой оплате потом всё же пройдёт, покупатель получит ещё один срок подписки, а вам придёт «Новая продажа».

@vanderu_bot пишет, что в магазине выключены способы оплатыСкопировать ссылку на раздел

PayPalych отказал в оплате одним из методов, и Vanderu убрал его кнопку. Включите метод в кабинете PayPalych и нажмите «Обновить список способов».

@vanderu_bot пишет, что ключи больше не подходятСкопировать ссылку на раздел

Сообщение говорит, что ключи PayPalych больше не подходят, или что перестал работать способ оплаты «PayPalych» с причиной «ключи магазина больше не подходят». PayPalych больше не принимает сохранённый токен. Пока ключи не обновлены, оплатить через PayPalych нельзя: бот его не показывает или на нажатие отвечает, что оплата этим способом сейчас не работает. Скопируйте токен в кабинете PayPalych, нажмите «Изменить ключи» и введите токен и ID магазина заново.

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

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

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

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

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

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