# Wallet pay
## Подключение платёжной системы ### Подключение со стороны Telegram **Шаг 1.** Войдите в свой аккаунт партнёра {% hint style="info" %} [Для этого перейдите по ссылке](https://pay.wallet.tg/) {% endhint %} На открывшейся странице нажмите "Log in via Telegram", затем введите свой номер телефона во всплывающем окне "Appears oauth.telegram.org" и нажмите "Apply". Необходимо подключить платёжную систему и через веб-браузер, и через приложение: * Вы получите сообщение Telegram с запросом на авторизацию — нажмите **"Apply".** * Также нужно нажать "Apply" во всплывающем окне **"oauth.telegram.org" в веб-браузере.** {% hint style="success" %} Рекомендуется использовать аккаунт, к которому имеет доступ ответственный за финансы. Для юридических лиц — уполномоченный представитель. {% endhint %} **Шаг 2.** Пройти небольшой опрос

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

Если вы входите впервые или вам нужна дополнительная информация, WalletPay предлагает ответить на несколько вопросов, чтобы получить более подробные сведения. Здесь два этапа: #### 1. Анкета #### 2. Проверки KYB (Know Your Business) или KYC (Know Your Customer) После завершения ваша заявка будет вскоре рассмотрена, и вы получите уведомление с результатами. В случае успеха вы увидите комиссию, взимаемую сервисом, и получите доступ к своему аккаунту, где сможете начать интеграцию. {% hint style="warning" %} Для юридических лиц форму может заполнить только доверенное лицо: директор или сотрудник по доверенности. {% endhint %} **Шаг 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" убедитесь, что кнопка оплаты соответствует следующим рекомендациям: 1. Назван одним из двух способов: * :purse: Wallet Pay * :purse: Оплатить через Wallet 2. Расположена выше остальных кнопок (если они есть). > Примечание. :purse: — это смайлик (см. ). > > См. пример в \[[Demo Store Bot](https://t.me/PineAppleDemoWPStoreBot)]. ## Подключение к Mavibot Войдите в проект и нажмите кнопку **«Connect»** для Wallet Pay в разделе «Платёжные системы».

Рис. 2. Раздел "Acquiring" для подключения сервиса к Mavibot

В открывшемся окне введите API key, сгенерированный для вашего магазина WalletPay.

Рис. 3. Форма с полем ввода API key

* [x] Готово! Теперь клиенты могут оплачивать покупки в вашем магазине в криптовалютах (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 секунд. |

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

Когда блок срабатывает в чате с ботом, клиент получит ссылку на оплату, а **wallet\_pay\_payment\_completed** у клиентской переменной будет создано значение **False.** {% hint style="warning" %} Эту ссылку можно открыть только в чате с ботом, подключённым к биллинговому аккаунту WalletPay. {% endhint %} ### Проверка оплаты После успешной оплаты у клиента **wallet\_pay\_payment\_completed** переменная будет установлена в **True,** а продавец получит callback в виде **4690FE98\_success**, который состоит из: * “4690FE98” — это первые 8 символов API key Wallet Pay. * слова об успешно **!** если произойдёт ошибка оплаты, вы получите **callback** с суффиксом “**\_fail**”. Адрес для уведомлений (callback): - вставляется в настройки платёжной системы Callback можно встроить в условие блока, чтобы отправить клиенту сообщение об успешной оплате (или об ошибке оплаты):

Рис. 5. Пример реакции на callback в блоке "Начальное условие"

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

{% hint style="info" %} Если вы не хотите выбивать клиента из основной схемы чат-бота, используйте блок "Нестационарное условие". Переходить в этот блок нельзя, поэтому клиент не будет выброшен из основной воронки после оплаты и получит уведомление об успешной оплате.\ омление об успешной оплате. А если вам нужно продолжить воронку с реакцией на успешную оплату, тогда используйте блок "Стартовое условие", после чего клиент перейдёт из блока оплаты в блок "Стартовое условие", из которого вы сможете продолжить воронку. {% endhint %} {% hint style="info" %} Подробнее об условных блоках рассказано в одноимённой статье. ссылка[блоках с условием рассказали](broken://pages/23d3fbba7c2a527c43fae9f4fcaa2648341c0c57) {% endhint %} ### Полезные ссылки \[[Поддержка бизнеса Wallet Pay](https://t.me/WalletPay_supportbot)] \[[Demo Store Bot](https://t.me/PineAppleDemoWPStoreBot)] \[[Сообщество продавцов](https://t.me/+6TReWBEyZxI5Njli)] --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.mavibot.ai/doc/ru/oplata/wallet-pay.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.