# Wallet pay

<figure><img src="/files/0b723c37c14f48b96164001754fc54f78483f3af" alt="" width="319"><figcaption></figcaption></figure>

## Підключення платіжної системи

### Підключення зі сторони Telegram

**Крок 1.** Увійдіть у свій партнерський акаунт

{% hint style="info" %}
[Для цього перейдіть за посиланням](https://pay.wallet.tg/)
{% endhint %}

На сторінці, що відкриється, натисніть «Log in via Telegram», потім введіть свій номер телефону у спливаючому вікні «oauth.telegram.org» і натисніть «Apply».

Потрібно підключити платіжну систему і через веббраузер, і через застосунок:

* Ви отримаєте повідомлення в Telegram із запитом на авторизацію — натисніть **«Apply».**
* Також потрібно натиснути «Apply» у спливаючому вікні **«oauth.telegram.org» у веббраузері.**

{% hint style="success" %}
Рекомендується використовувати акаунт, до якого має доступ відповідальний за фінанси. Для юридичних осіб — уповноважений представник.
{% endhint %}

**Крок 2.** Пройдіть коротке опитування

<figure><img src="/files/032ec3600ca767abb6acd23c5b6af02503ecb857" alt=""><figcaption><p>Рис. 1. Заповнення інформації про продавця</p></figcaption></figure>

Якщо ви входите вперше або вам потрібна додаткова інформація, WalletPay пропонує відповісти на кілька запитань, щоб отримати детальніші відомості. Є два етапи:

#### 1. Анкета

#### 2. Перевірки KYB (Know Your Business) або KYC (Know Your Customer)

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

{% hint style="warning" %}
Для юридичних осіб форму може заповнити лише довірена особа: директор або співробітник за довіреністю.
{% endhint %}

**Крок 3.** *Створіть перший «Магазин».*

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

**Крок 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: Pay via Wallet

2. Розташована над іншими кнопками (якщо вони є).

> Примітка. :purse: — це смайлик (див. <https://emojipedia.org/purse/>).
>
> Дивіться приклад у \[[Demo Store Bot](https://t.me/PineAppleDemoWPStoreBot)].

## Підключення до Mavibot

Увійдіть у проєкт і натисніть кнопку **«Connect»** для Wallet Pay у розділі «Платіжні системи».

<figure><img src="/files/415ad2d649ae4ac808ad26efb36e06d65e7ed838" alt=""><figcaption><p>Рис. 2. Розділ «Еквайринг» для підключення сервісу до Mavibot</p></figcaption></figure>

У вікні, що відкриється, введіть API key, згенерований для вашого магазину WalletPay.

<figure><img src="/files/4e54984311409d66282ca6800ae9549b3ad65fed" alt=""><figcaption><p>Рис. 3. Форма з полем введення API key</p></figcaption></figure>

* [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 секунд.                                      |

<figure><img src="/files/0a7e7fb312f1a5b071a6d5b3966fa294af213456" alt=""><figcaption><p>Рис. 4. Приклад передачі параметрів</p></figcaption></figure>

Коли блок спрацьовує у чаті з ботом, клієнт отримає платіжне посилання, а **wallet\_pay\_payment\_completed** у клієнта буде створено змінну зі значенням <mark style="color:red;">**False.**</mark>

{% hint style="warning" %}
Це посилання можна відкрити лише в чаті з ботом, підключеним до білінгового акаунта WalletPay.
{% endhint %}

### Перевірка платежу

Після успішної оплати значення змінної клієнта **wallet\_pay\_payment\_completed** буде встановлено в <mark style="color:green;">**True,**</mark> а продавець отримає callback у вигляді **4690FE98\_success**, який складається з:

* «4690FE98» — це перші 8 символів API key Wallet Pay.
* слова про успішно

<mark style="color:red;">**!**</mark> якщо сталася помилка платежу, ви отримаєте **callback** із суфіксом «<mark style="color:red;">**\_fail**</mark>».

Адреса для сповіщень (callbacks): <https://chatter.salebot.pro/wallet_pay/payment_callback> - вставляється в налаштуваннях платіжної системи

Callback можна вбудувати в умову блоку, щоб надіслати клієнту повідомлення про успішний платіж (або помилку платежу):

<figure><img src="/files/6e0c927538e7936785621753ce1d6d3739981281" alt=""><figcaption><p>Рис. 5. Приклад реакції на callback у блоці «Початкова умова»</p></figcaption></figure>

<figure><img src="/files/eed5aa54280ff8b3568c4783c1741f9d72eb9b8f" alt=""><figcaption><p>Рис. 6. Приклад відповіді на callback у блоці «Умова без стану»</p></figcaption></figure>

{% hint style="info" %}
Якщо ви не хочете вибивати клієнта з основної схеми чат-бота, використовуйте блок «Умова без стану». До цього блоку не можна перейти, тож клієнт не буде вибитий з основної воронки після оплати й отримає сповіщення про успішну оплату.

А якщо вам потрібно продовжити воронку з реакцією на успішну оплату, тоді використовуйте блок «Початкова умова», після чого клієнт перейде з блоку оплати до блоку «Початкова умова», з якого ви зможете продовжити воронку.
{% endhint %}

{% hint style="info" %}
Докладніше про умовні блоки йдеться в однойменній статті. посилання[у блоках з умовою розповіли](broken://pages/ef6045e9c695451c2362686c7e0d9065d63b1634)&#x20;
{% 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/uk/oplata/wallet-pay.md?ask=<question>
```

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.