Wallet pay
Подключение платёжной системы
Подключение со стороны Telegram
Шаг 1. Войдите в свой аккаунт партнёра
На открывшейся странице нажмите "Log in via Telegram", затем введите свой номер телефона во всплывающем окне "Appears oauth.telegram.org" и нажмите "Apply".
Необходимо подключить платёжную систему и через веб-браузер, и через приложение:
Вы получите сообщение Telegram с запросом на авторизацию — нажмите "Apply".
Также нужно нажать "Apply" во всплывающем окне "oauth.telegram.org" в веб-браузере.
Рекомендуется использовать аккаунт, к которому имеет доступ ответственный за финансы. Для юридических лиц — уполномоченный представитель.
Шаг 2. Пройти небольшой опрос
Если вы входите впервые или вам нужна дополнительная информация, WalletPay предлагает ответить на несколько вопросов, чтобы получить более подробные сведения. Здесь два этапа:
1. Анкета
2. Проверки KYB (Know Your Business) или KYC (Know Your Customer)
После завершения ваша заявка будет вскоре рассмотрена, и вы получите уведомление с результатами. В случае успеха вы увидите комиссию, взимаемую сервисом, и получите доступ к своему аккаунту, где сможете начать интеграцию.
Для юридических лиц форму может заполнить только доверенное лицо: директор или сотрудник по доверенности.
Шаг 3. Создайте первый "Store".
После успешного прохождения "Survey" вам будет предложено создать свой первый магазин.
Шаг 4. Создайте "API key"
После названия первого магазина вам будет предложено его настроить:
Сгенерируйте API key.
Скопируйте свой API key и начните интеграцию с Mavibot.
Шаг 5. Создайте заказ и получите ссылку на оплату
Если хотите разместить ссылку в кнопке, используйте Inline Button.
Обратите внимание, что страницу оплаты может открыть только указанный "customerTelegramUserId".
Шаг 6. Вывод средств
После подтверждения оплаты клиентом средства зачисляются на ваши активы и по умолчанию удерживаются 48 часов. По истечении этого времени вы сможете вывести средства на баланс своего Wallet, который использовали для входа в сервис Paypal Wallet.
Шаг 7. Возврат средств
В настоящее время вывод средств доступен с вашего аккаунта Wallet, который вы используете для входа в WalletPay. Но вскоре он будет доступен и в вашем Merchant-аккаунте.
Как выглядит кнопка оплаты?
При интеграции вашего Telegram-бота с "Wallet Pay API" убедитесь, что кнопка оплаты соответствует следующим рекомендациям:
Назван одним из двух способов:
:purse: Wallet Pay
:purse: Оплатить через Wallet
Расположена выше остальных кнопок (если они есть).
Примечание. :purse: — это смайлик (см. https://emojipedia.org/purse/).
См. пример в [Demo Store Bot].
Подключение к Mavibot
Войдите в проект и нажмите кнопку «Connect» для Wallet Pay в разделе «Платёжные системы».
В открывшемся окне введите API key, сгенерированный для вашего магазина WalletPay.
Как сформировать ссылку на оплату
Создайте блок конструктора воронок и вызовите “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.
Эту ссылку можно открыть только в чате с ботом, подключённым к биллинговому аккаунту WalletPay.
Проверка оплаты
После успешной оплаты у клиента wallet_pay_payment_completed переменная будет установлена в True, а продавец получит callback в виде 4690FE98_success, который состоит из:
“4690FE98” — это первые 8 символов API key Wallet Pay.
слова об успешно
! если произойдёт ошибка оплаты, вы получите callback с суффиксом “_fail”.
Адрес для уведомлений (callback): https://chatter.salebot.pro/wallet_pay/payment_callback - вставляется в настройки платёжной системы
Callback можно встроить в условие блока, чтобы отправить клиенту сообщение об успешной оплате (или об ошибке оплаты):
Если вы не хотите выбивать клиента из основной схемы чат-бота, используйте блок "Нестационарное условие". Переходить в этот блок нельзя, поэтому клиент не будет выброшен из основной воронки после оплаты и получит уведомление об успешной оплате. омление об успешной оплате.
А если вам нужно продолжить воронку с реакцией на успешную оплату, тогда используйте блок "Стартовое условие", после чего клиент перейдёт из блока оплаты в блок "Стартовое условие", из которого вы сможете продолжить воронку.
Подробнее об условных блоках рассказано в одноимённой статье. ссылкаблоках с условием рассказали
Полезные ссылки
Последнее обновление