# Fondy

* [Як підключити ](#how-to-connect)
* [Як створити посилання](#how-to-create-a-link)&#x20;
* [Як обробити результат ](#how-to-process-the-result)
* [Як робити тестові платежі](#how-to-make-test-payments)

## Як підключити&#x20;

Щоб підключити платіжну систему Fondy, вам знадобляться merchant ID і секретний ключ. Після їх отримання переходимо до налаштувань у Salebot&#x20;

У Salebot ми відкриваємо розділ платіжних систем, обираємо Fondy. Потрібно ввести отримані дані.

&#x20;                                       ![](/files/864d374ea91564bc25fd298c5651b36a9859d362)

![](/files/686f980cee4c8d97d8268341da8d01ba0bfe36a4)

Щоб згенерувати посилання на оплату, потрібно задати значення змінної payment\_sum (наприклад, 150 або 100.55 (через крапку!)), одразу після цього з’являється змінна fondy\_pay\_url. Цю змінну можна вивести як посилання або розмістити на кнопці з текстом "Pay".&#x20;

Посилання має такий вигляд:&#x20;

<https://payfondy.eu/merchants/4879cf99f26d58b22b04c037d111d14a/default/index.html?n=fe044b299ce98accfcd5f0c559d8c8f28802c3>

Також перед встановленням значення payment\_sum ви можете вказати такі необов’язкові змінні для налаштування платежу.

{% hint style="warning" %}
За замовчуванням встановлено UAH, якщо вам потрібна інша валюта, потрібно задати значення змінної currency
{% endhint %}

**currency** - валюта замовлення.&#x20;

**Допустимі значення:**&#x20;

UAH - українська гривня&#x20;

RUB - російський рубль&#x20;

USD - долар США&#x20;

EUR - євро&#x20;

GBP - фунт стерлінгів обов’язково&#x20;

CZK - чеська крона

**payment\_description** - опис замовлення&#x20;

**session\_timeout** - час життя замовлення в секундах.&#x20;

за замовчуванням (36000 секунд = 10 годин).&#x20;

**language** - мова платіжної сторінки:&#x20;

ru - російська&#x20;

uk - українська&#x20;

en - англійська&#x20;

lv - латвійська&#x20;

fr - французька&#x20;

cs - чеська&#x20;

ro - румунська&#x20;

it  - італійська&#x20;

sk - словацька&#x20;

pl - польська&#x20;

es - іспанська&#x20;

hu - угорська&#x20;

de - німецька

## Як створити посилання&#x20;

Створити посилання на оплату 122 грн (гривня за замовчуванням)

![](/files/efb0627079eba6799e5362ae965d5f1e545c3994)

{% hint style="info" %}
Зверніть увагу:

* Спочатку вкажіть необов’язкові **payment\_description** параметри тощо.
* А наприкінці задайте значення **payment\_sum** variable
  {% endhint %}

Зверніть увагу: спочатку ми задаємо додаткові змінні для налаштувань, потім **payment\_sum**. Ви можете визначати змінні раніше в ланцюжку, а не в одному блоці, це приклад.&#x20;

Далі, у потрібному місці, виведіть **fondy\_pay\_url** змінну, яка містить посилання.

&#x20;                                          ![](/files/076532b7521c96e0e5544a21008af0f912fa46e4)

## Як обробити результат&#x20;

Після успішної оплати в бот прийде колбек, за яким можна зрозуміти, що оплата пройшла успішно. Ці колбеки в системі ви бачите як повідомлення від користувача, тому щоб їх не міг надіслати користувач, вони складаються з перших 5 символів секретного ключа та слова success, наприклад: h4fd56\_success

{% hint style="info" %}
Якщо пароль менше ніж 5 символів, тоді він використовується повністю, наприклад для тестових платежів пароль test, тоді callback прийде test\_success
{% endhint %}

{% hint style="success" %}
Ці колбеки НЕ ВИДНО користувачу, вони відображаються лише оператору
{% endhint %}

{% hint style="warning" %}
Тип порівняння має бути "Full match"
{% endhint %}

Також після успішної оплати для змінної fondy\_payment\_completed встановлюється значення True.&#x20;

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

![](/files/eed9e7edb7526f96757df581691da2970d5f4501)

Після завершення оплати до клієнта буде додано змінну fondy\_callback\_data, яка містить дані відповіді платіжної системи щодо виконаної транзакції. Ви можете витягнути необхідні дані зі словника за допомогою методу get.

{% hint style="warning" %}
Щоб здійснити повторну оплату, потрібно скинути payment\_sum, раніше згенероване посилання, а після скидання змінної payment\_sum отримати нове посилання. Ви можете вказати попереднє значення.
{% endhint %}

## Як робити тестові платежі&#x20;

Тестові дані на момент публікації документації:&#x20;

**Merchant ID**: 1396424&#x20;

**Пароль**: test&#x20;

**Тестові номери карток**&#x20;

44445566661111 - Успішний&#x20;

4444111166665555 - Відмова&#x20;

Термін дії та CVV2 будь-які&#x20;

Якщо щось не працює, порівняйте дані з даними на офіційному сайті: <https://docs.fondy.eu/ru/docs/page/2/2>


---

# 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/integrations/payment/fondy.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.
