Интеграция Wallet Pay

Подключение платежной системы

Настройка Wallet Pay

Шаг 1. Войдите в партнерский кабинет

Перейдите на страницу:

https://pay.wallet.tg/

Нажмите «Войти через Telegram», затем:

  1. Введите номер телефона во всплывающем окне oauth.telegram.org.
  2. Нажмите «Применить».
  3. Подтвердите авторизацию в Telegram.
  4. Подтвердите авторизацию в браузере.

Рекомендуется использовать Telegram-аккаунт, к которому имеет доступ сотрудник, отвечающий за финансы. Для юридических лиц — директор или уполномоченный представитель.

Шаг 2. Заполните анкету

При первом входе Wallet Pay предложит пройти регистрацию.

Она состоит из двух этапов:

  1. Анкета
  2. Проверка KYB (для компаний) или KYC (для физических лиц)

После отправки данных заявка будет рассмотрена. В случае успешной проверки вы получите доступ к личному кабинету и сможете продолжить настройку.

Для юридических лиц анкету может заполнить только директор или представитель по доверенности.

Шаг 3. Создайте магазин

После успешного прохождения проверки создайте первый магазин (Store).

Шаг 4. Создайте API-ключ

Откройте настройки магазина:

  • сгенерируйте API-ключ;
  • сохраните его — он понадобится для подключения Wallet Pay в Salebot.

Шаг 5. Создайте тестовый заказ

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

Если ссылка используется в кнопке Telegram, рекомендуется использовать Inline Button.

Открыть страницу оплаты сможет только пользователь, чей Telegram ID указан в параметре customerTelegramUserId.

Шаг 6. Выведите средства

После успешной оплаты средства поступают на баланс Wallet Pay.

По умолчанию вывод становится доступен через 48 часов после оплаты.

Далее средства можно вывести на Wallet-аккаунт, который использовался для входа в Wallet Pay.

Шаг 7. Возврат средств

На текущий момент возврат выполняется через Wallet-аккаунт, использованный для входа в Wallet Pay.

В будущем управление возвратами будет доступно непосредственно в Merchant-кабинете.

Требования к кнопке оплаты

При интеграции Telegram-бота с Wallet Pay кнопка оплаты должна соответствовать рекомендациям сервиса.

Название кнопки

Используйте один из вариантов:

  • 👜 Wallet Pay
  • 👜 Pay via Wallet

Расположение

Кнопка Wallet Pay должна находиться выше остальных кнопок, если они присутствуют.

Подробнее можно посмотреть в примере:

https://t.me/PineAppleDemoWPStoreBot

Подключение Wallet Pay в Salebot

Перейдите в раздел Платежные системы и нажмите «Подключить» напротив Wallet Pay.

Введите API-ключ, который был создан в личном кабинете Wallet Pay.

После сохранения настроек интеграция будет готова к работе.

Клиенты смогут оплачивать покупки через Wallet Pay в следующих валютах:

  • TON
  • USDT
  • BTC

Генерация ссылки на оплату

Создайте блок конструктора и в Калькуляторе вызовите функцию:

wallet_pay_generate_payment_url(amount, currency_code, description, timeout_seconds)

Параметры функции

Параметр Описание
amount сумма платежа в криптовалюте или поддерживаемой фиатной валюте
currency_code валюта платежа. По умолчанию RUB. Доступные значения: TON, BTC, USDT, EUR, USD, RUB
description описание заказа длиной от 5 до 100 символов
timeout_seconds время жизни ссылки в секундах. По умолчанию — 3600

После выполнения функции:

  • клиент получит ссылку на оплату;
  • будет создана переменная
wallet_pay_payment_completed = False

Ссылку можно открыть только в чате Telegram-бота, подключенного к Wallet Pay.

Проверка оплаты

После успешной оплаты:

wallet_pay_payment_completed = True

Также в бот придет callback.

Пример:

4690FE98_success

Структура callback:

  • 4690FE98 — первые 8 символов API-ключа Wallet Pay;
  • _success — успешная оплата.

При ошибке оплаты придет callback:

4690FE98_fail

URL для callback

В настройках Wallet Pay необходимо указать адрес:

https://chatter.salebot.pro/wallet_pay/payment_callback

Обработка callback

Полученный callback можно использовать в условиях переходов между блоками.

Например:

Если не требуется переводить клиента в другую часть сценария после оплаты, используйте блок «Не состояние с условием». В этом случае клиент останется в текущей ветке, но получит сообщение об успешной оплате.

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

Подробнее о работе блоков с условиями:

/broken/pages/VktePfPMzzJlbjBSqE93

Полезные ссылки