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