# Fondy

* [How to connect ](#how-to-connect)
* [How to Create a Link](#how-to-create-a-link)&#x20;
* [How to process the result ](#how-to-process-the-result)
* [How to Make Test Payments](#how-to-make-test-payments)

## How to connect&#x20;

To connect the Fondy payment system you will need a merchant ID and a secret key. After receiving them, we go to the settings in Salebot&#x20;

In salebot we open the section of payment systems, select fondy. You need to enter the received data.

&#x20;                                       ![](/files/4815tZqdDv0k3236vDOg)

![](/files/rvo12F6qd84VnL3N0tkB)

To generate a link to a payment, you need to set the value of the payment\_sum variable (such as 150 or 100.55 (via a dot!)), immediately after that the fondy\_pay\_url variable appears. This variable can be displayed with a link or placed on the button with the text "Pay".&#x20;

The link has the form:&#x20;

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

Also, before setting the payment\_sum value, you can specify the following optional variables to configure the payment.

{% hint style="warning" %}
The default setting is UAH, if you need another currency you need to set the value of the currency variable
{% endhint %}

**currency** - Order currency.&#x20;

**Valid values:**&#x20;

UAH - Ukrainian hryvna&#x20;

RUB - Russian ruble&#x20;

USD - USD&#x20;

EUR - euro&#x20;

GBP - Pound Sterling mandatory&#x20;

CZK - Czech Crown

**payment\_description** - order description&#x20;

**session\_timeout** - order lifespan in seconds.&#x20;

default (36000 seconds = 10 hours).&#x20;

**language** - Payment page language:&#x20;

ru - Russian&#x20;

uk - Ukrainian&#x20;

en - English&#x20;

lv - Latvian&#x20;

fr - French&#x20;

cs - Czech&#x20;

ro - Romanian&#x20;

it  - Italian&#x20;

sk - Slovak&#x20;

pl - Polish&#x20;

es - Spanish&#x20;

hu - Hungarian&#x20;

de - German

## How to Create a Link&#x20;

Create a link to the payment of 122hrn (default hryvnia)

![](/files/UqG0Fd1JHFIvlWfXIDZV)

{% hint style="info" %}
Please note:

* First specify optional **payment\_description** parameters, etc.
* And last, assign the value of the **payment\_sum** variable
  {% endhint %}

Note, first we set additional variables for the settings, then **payment\_sum**. You can define variables earlier in a chain, not in a single block, this is an example.&#x20;

Next, at the right place, print the **fondy\_pay\_url** variable, which contains the link.

&#x20;                                          ![](/files/A2gCozjP1bc3Ki6Av7RM)

## How to process the result&#x20;

After successful payment in the bot will come kolbeks, on which you can understand that there was a successful payment. These kolbeks in the system you see as messages from the user, so that they can not be sent by the user, they consist of the first 5 characters of the secret key and the account success, for example: h4fd56\_success

{% hint style="info" %}
If the password is less than 5 characters, then the password will be used completely, for example for test payments the password is test, then the callback will come test\_success
{% endhint %}

{% hint style="success" %}
These callbacks ARE NOT SEEN to the user, they are displayed only to the operator
{% endhint %}

{% hint style="warning" %}
The type of comparison should be "Full match"
{% endhint %}

Also, after successful payment, the fondy\_payment\_completed variable is set to True.&#x20;

For example, you can make a successful payment processing block with a condition and print the corresponding message to the user:

![](/files/6cjtRFz5m7ahCHMGmhuV)

After the payment is completed, the fondy\_callback\_data variable will be added to the client, containing the payment system response data for the completed transaction. You can extract the necessary data from the dictionary using the get method.

{% hint style="warning" %}
To make a repeat payment, you must reset the payment\_sum, the previously generated link, and after you reset the payment\_sum variable to get a new link. You can specify a previous value.
{% endhint %}

## How To Make Test Payments&#x20;

Test data at the time of publication of documentation:&#x20;

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

**Password**: test&#x20;

**Test card numbers**&#x20;

44445566661111 - Successful&#x20;

4444111166665555 - Refusal&#x20;

Validity period and CVV2 any&#x20;

If something does not work compare the data with the data on the official site: <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/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.
