# Allpay

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

Щоб працювати з платіжною системою allpay, перейдіть до проєкту на mavibot.pro і в розділі "Acquiring" ви знайдете платіжну систему Allpay.

<figure><img src="/files/26a0f735902710e1dc4b37ee4797b3d213e3a49b" alt=""><figcaption><p>Рис. 1. Розділ "Acquiring" для підключення платіжного сервісу до Mavibot</p></figcaption></figure>

Після натискання кнопки підключення відкривається форма для підключення платіжної системи.

<figure><img src="/files/dcccaed3b83a997fd7b6b7b8bccd65860298b2f6" alt=""><figcaption><p>Рис. 2. Введення імені користувача та пароля від сервісу</p></figcaption></figure>

У цій формі введіть **Ім'я користувача** та **пароль** для роботи з API платіжної системи.

Після цього натисніть **Зберегти налаштування**, після чого ми побачимо, що кнопка підключення платіжної системи Allpay відображається як "Підключено":

{% hint style="success" %}
Це означає, що платіжну систему підключено, і ви можете почати з нею працювати.
{% endhint %}

<figure><img src="/files/e0eb36296385778ccbcf1cbddf1fdc70a9c450e3" alt=""><figcaption><p>Рис. 3. Відображення кнопки підключеної платіжної системи</p></figcaption></figure>

### Налаштування роботи з платіжною системою Allpay

Потрібно надіслати до Allpay адресу електронної пошти клієнта. Ви можете вказати її у **allpay\_email** змінній у блоці

Існує 2 способи створення платіжного посилання:

1. Щоб згенерувати платіжне посилання, потрібно встановити **payment\_sum** значення змінної *(наприклад, 150 або 100.55 <mark style="color:red;">**(через крапку!))**</mark>,* та **allpay\_pay\_url** змінна з'явиться одразу після цього.

Цю змінну можна відобразити як посилання або розмістити на кнопці з текстом "Pay". Для цього способу є додаткові параметри, але їх потрібно оголошувати у змінних до **payment\_sum.** Поле **allpay\_currency** змінна може використовуватися для вказання валюти, значення за замовчуванням — **'RUB'.** Поле **allpay\_lang** змінна для вказання мови платіжної сторінки, за замовчуванням — **‘ENG'.**

2. Також ви можете створити посилання за допомогою **allpay\_generate\_payment\_url** функці&#x457;**(amount, email, currency, long).**

| Параметри (для другого способу):                                                               |
| ---------------------------------------------------------------------------------------------- |
| amount - містить суму платежу                                                                  |
| email - містить адресу електронної пошти клієнта                                               |
| currency - необов'язковий параметр для вказання валюти (за замовчуванням — ‘RUB’),             |
| lang -  необов'язковий параметр, що вказує мову платіжної сторінки (за замовчуванням — ‘ENG’). |

Посиланням буде відповідь на виконання функції, помістіть його у змінну

### ПРИКЛАДИ:

Для першого способу:

<figure><img src="/files/e825fe40d0b1aee68ccb28c8660d487cb6a69934" alt=""><figcaption></figcaption></figure>

> allpay\_email = '\*\*\*\*\*\*<1@mail.ru>'
>
> payment\_sum = 100

У результаті в блоці за посиланням можна передати таку змінну:

<figure><img src="/files/34789054fc3e492b3c63e690199d3b4484eb0179" alt=""><figcaption></figcaption></figure>

**Приклад** для другого способу:

<figure><img src="/files/51a0fe74a56eff5e5d0cef40468bdbd4bf04d409" alt=""><figcaption></figcaption></figure>

> payment\_url = allpay\_generate\_payment\_url(100, '\*\*\*\*\*\*\*\*<1@mail.ru>')

У результаті будуть створені змінні:

<figure><img src="/files/61f90ca105572eb043c8f945c8c7bbe816dd7b5b" alt="" width="266"><figcaption></figcaption></figure>

{% hint style="success" %}
Після успішної оплати **allpay\_payment\_completed** змінна буде встановлена в True, а також ви отримаєте callback про успішну оплату.
{% endhint %}

{% hint style="info" %}
Перші 8 символів пароля використовуються на початку тексту для роботи з API.
{% endhint %}


---

# 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/allpay.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.