Wallet pay
В данной статье объясним, как подключить и начать работу с платежной системой Wallet pay от Telegram.
Подключение платежной системы
Подключение на стороне Telegram
Шаг 1. Войдите в партнёрскую учетную запись
Для этого перейдите по ссылке https://pay.wallet.tg.
В открывшейся странице нажмите «Войти через Telegram», после чего введите свой номер телефона во всплывающем окне «Появляется oauth.telegram.org» и нажмите «Применить».
Необходимо подключить платежную систему и через веб-браузер, и через приложение:
Вам придет сообщение в Telegram с запросом на авторизацию - нажмите «Применить».
Также необходимо нажать «Применить» во всплывающем окне «oauth.telegram.org» в веб-браузере.
Мы рекомендуем использовать учетную запись, к которой имеет доступ лицо, занимающееся финансами. Для юридических лиц – уполномоченный представитель.
Шаг 2. Пройдите небольшой опрос
Если вы входите в систему впервые или требуется какая-то дополнительная информация, 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» убедитесь, что кнопка оплаты соответствует следующим рекомендациям:
Названа одним из двух вариантов:
:purse: Wallet Pay
:purse: Pay via Wallet
Расположена над остальными кнопками (если они у вас есть).
Примечание. :purse: — это смайлик (см. https://emojipedia.org/purse/).
См. пример в [Demo Store Bot].
Подключение в Salebot
Войдите в проект и в разделе “Платежные системы” нажмите кнопку “Подключить” для Wallet Pay.
В открывшемся окне введите API ключ сгенерированный для вашего магазина Wallet Pay.
Как сгенерировать ссылку для оплаты
Создайте блок конструктора воронок и в калькуляторе вызовите функцию “wallet_pay_generate_payment_url”, передав в неё необходимые параметры:
| Параметр | Описание параметра |
|---|---|
amount | сумма платежа в криптовалюте или другой фиатной валюте доступной для конвертации в “TON”. |
сurrency_code | валюта платежа, по умолчанию - “RUB”. Список доступных валют: "TON" "BTC" "USDT" "EUR" "USD" "RUB" |
description | краткое описание заказа от 5 до 100 символов. |
timeout_seconds | срок действия ссылки в секундах, по умолчанию - 3600 секунд. |
При срабатывании блока в чате с ботом клиент получит ссылку для оплаты, а также будет создана переменная клиента wallet_pay_payment_completed со значением False.
Данную ссылку возможно открыть только в чате с ботом подключенным к платёжному аккаунту Wallet Pay.
Пример блока с вызовом функции:
Проверка оплаты
После успешной оплаты переменная клиента wallet_pay_payment_completed примет значение True, а продавцу придёт callback в виде 4690FE98_success, которое состоит из:
“4690FE98” - это первые 8 символов ключа Wallet Pay API.
слова об успешно
! При ошибке оплаты придёт callback c суффиксом “_fail”.
Адрес для уведомлений (коллбеков): https://chatter.salebot.pro/wallet_pay/payment_callback - вставляется в настройку платежной системы
Полезные ссылки
Last updated
