Wallet pay

В данной статье объясним, как подключить и начать работу с платежной системой Wallet pay от Telegram.

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

Подключение на стороне Telegram

Шаг 1. Войдите в партнёрскую учетную запись

В открывшейся странице нажмите «Войти через Telegram», после чего введите свой номер телефона во всплывающем окне «Появляется oauth.telegram.org» и нажмите «Применить».

Необходимо подключить платежную систему и через веб-браузер, и через приложение:

  • Вам придет сообщение в Telegram с запросом на авторизацию - нажмите «Применить».

  • Также необходимо нажать «Применить» во всплывающем окне «oauth.telegram.org» в веб-браузере.

Шаг 2. Пройдите небольшой опрос

Рис. 1. Заполнение информации о мерчанте

Если вы входите в систему впервые или требуется какая-то дополнительная информация, Wallet Pay предлагает вам ответить на несколько вопросов для получения более подробных данных. Есть два шага:

1. Анкета

2. Проверки KYB (Знай свой бизнес) или KYC (Знай своего клиента)

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

Шаг 3. Создайте первый «Магазин».

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

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

После названия первого магазина вам будет предложено его настроить:

  • Сгенерируйте ключ API.

  • Скопируйте свой ключ API и начните интеграцию с Salebot.

Шаг 5. Создайте заказ и получите ссылку на оплату

Если вы хотите поместить ссылку в кнопку используйте Inline Button.

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

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

После того, как клиент подтвердит оплату, средства зачисляются на ваши активы и по умолчанию удерживаются в течение 48 часов. По истечении этого времени вы сможете вывести средства на баланс вашего Кошелька, который вы использовали для входа в сервис Wallet Pay.

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

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

Как должна выглядеть кнопка оплаты

При интеграции вашего «Telegram Bot» с «Wallet Pay API» убедитесь, что кнопка оплаты соответствует следующим рекомендациям:

  1. Названа одним из двух вариантов:

  • :purse: Wallet Pay

  • :purse: Pay via Wallet

  1. Расположена над остальными кнопками (если они у вас есть).

Примечание. :purse: — это смайлик (см. https://emojipedia.org/purse/).

См. пример в [Demo Store Bot].

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

Войдите в проект и в разделе “Платежные системы” нажмите кнопку “Подключить” для Wallet Pay.

Рис. 2. Раздел "Эквайринг" для подключения сервиса к Сейлботу

В открывшемся окне введите API ключ сгенерированный для вашего магазина Wallet Pay.

Рис. 3. Форма с полем для ввода API-ключа

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

Создайте блок конструктора воронок и в калькуляторе вызовите функцию “wallet_pay_generate_payment_url”, передав в неё необходимые параметры:

Параметр
Описание параметра

amount

сумма платежа в криптовалюте или другой фиатной валюте доступной для конвертации в “TON”.

сurrency_code

валюта платежа, по умолчанию - “RUB”. Список доступных валют: "TON" "BTC" "USDT" "EUR" "USD" "RUB"

description

краткое описание заказа от 5 до 100 символов.

timeout_seconds

срок действия ссылки в секундах, по умолчанию - 3600 секунд.

Рис. 4. Пример передачи параметров

При срабатывании блока в чате с ботом клиент получит ссылку для оплаты, а также будет создана переменная клиента wallet_pay_payment_completed со значением False.

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

После успешной оплаты переменная клиента wallet_pay_payment_completed примет значение True, а продавцу придёт callback в виде 4690FE98_success, которое состоит из:

  • “4690FE98” - это первые 8 символов ключа Wallet Pay API.

  • слова об успешно

! При ошибке оплаты придёт callback c суффиксом “_fail”.

Адрес для уведомлений (коллбеков): https://chatter.salebot.pro/wallet_pay/payment_callback - вставляется в настройку платежной системы

Колбек можно вложить в условие блока, чтобы направить клиенту сообщение об успешной оплате (или ошибке платежа):

Рис. 5. Пример реакции на колбек в блоке "Стартовое условие"
Рис. 6. Пример реакции на колбек в блоке "Не состояние с условием"

Если вы не хотите выбивать клиента из основной схемы чат-бота, воспользуйтесь блоком "Не состояние с условием" — в этот блок нельзя перейти, поэтому клиента после оплаты не выбьет из основной воронки и при этом он получит уведомление об успешной оплате.

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

Подробнее о блоках с условием рассказали в одноименной статье.

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

[Wallet Pay Business Support]

[Demo Store Bot]

[Merchant Community]

Last updated

Was this helpful?