> For the complete documentation index, see [llms.txt](https://docs.mavibot.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mavibot.ai/doc/uk/integrations/payment/mercado-pago.md).

# Mercado Pago

Щоб використовувати платіжну систему Mercado Pago, завершіть налаштування нижче у вашій панелі Mercado Pago Developers, а потім введіть дані в налаштуваннях інтеграції.

## Застосунок і Access Token

1. Увійдіть до Mercado Pago та відкрийте розділ Developers (**Developers / Suas integrações**).
2. Створіть застосунок (**Ваші інтеграції → Створити застосунок**) якщо у вас ще немає такого.
3. Скопіюйте ваш **Production Access Token** або **Test Access Token**  — цей токен буде використовуватися як основний API-токен.

<div data-with-frame="true"><figure><img src="/files/d2316dbc5fe7e9e34bd7d077a234ada4b7b16450" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Щоб дізнатися про типи токенів і де їх знайти, дивіться: [Облікові дані.](https://www.mercadopago.com.br/developers/en/docs/your-integrations/credentials)
{% endhint %}

## Webhooks (сповіщення про платежі)

1. У налаштуваннях інтеграції відкрийте **Webhooks / сповіщення** розділ (див.: [**Webhooks**](https://www.mercadopago.com.br/developers/en/docs/your-integrations/notifications/webhooks)).
2. Встановіть URL сповіщень:

`https://chatter.mavibot.ai/mercado_pago_callback/result`

3. Підпишіться на **Платежі** події, щоб отримувати сповіщення про створення платежів і оновлення статусу.
4. Збережіть **секрет Webhook**  — його потрібно ввести в налаштуваннях інтеграції.

<div data-with-frame="true"><figure><img src="/files/680ba44b136ae881fa2bbd5bc6b9036306ef9e55" alt=""><figcaption></figcaption></figure></div>

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

У розділі Acquiring виберіть **Mercado Pago**.

<div data-with-frame="true"><figure><img src="/files/235bb57c95ce11f29c56507a40a0f258382a9aa7" alt=""><figcaption></figcaption></figure></div>

Потім введіть:

* **Access Token**  — токен, який ви скопіювали.
* **секрет Webhook**  — секрет, що використовується для перевірки webhook.

<div data-with-frame="true"><figure><img src="/files/6307db605eb17e256e28babf8c26ea78039e22c7" alt=""><figcaption></figcaption></figure></div>

## Генерація платіжного посилання

Функція калькулятора:\
`get_mercado_pago_payment_url(amount, description, currency, customer_email, product_name)`

<table data-header-hidden><thead><tr><th width="241.3828125"></th><th></th></tr></thead><tbody><tr><td>Параметри</td><td>Опис</td></tr><tr><td><mark style="color:$danger;"><strong>!</strong></mark><strong> amount</strong></td><td><p><strong>Сума платежу.</strong></p><p>Це обов'язковий параметр.</p></td></tr><tr><td><strong>description</strong></td><td><p><strong>Опис платежу.</strong> </p><p>Це необов'язковий параметр.</p></td></tr><tr><td><strong>currency</strong></td><td><strong>Код валюти ISO</strong> (наприклад, BRL, ARS, MXN, USD, EUR, CLP, COP, PEN, UYU) — необов'язково; за замовчуванням BRL.</td></tr><tr><td><strong>customer_email</strong></td><td><strong>Електронна пошта клієнта</strong> — необов'язково.</td></tr><tr><td><strong>product_name</strong></td><td><p><strong>Альтернативна назва продукту</strong> — необов'язково; </p><p>якщо не вказано, замість неї використовується опис.</p></td></tr></tbody></table>

Функція повертає платіжне посилання.

<div data-with-frame="true"><figure><img src="/files/83840a4ddec04759575dbdb17f1408c56e0a4c97" alt=""><figcaption><p>Цей приклад показує, як передавати параметри у функцію та надсилати платіжне посилання в повідомленні.</p></figcaption></figure></div>

## Оплата через кнопку

Щоб надіслати кнопку оплати через Mercado Pago, виберіть у конструкторі кнопок тип кнопки з підтримкою оплати та виберіть **Mercado Pago** як платіжну систему. За потреби введіть суму, опис і валюту.

<div data-with-frame="true"><figure><img src="/files/4e502afe1bf590489195a93e72ff23cdb2ff2fa1" alt=""><figcaption></figcaption></figure></div>

## Callback-и в діалозі після оплати

### **Успішна оплата**

Після того як клієнт перейде за посиланням і успішно завершить оплату, у діалог може бути надіслано callback у такому форматі:

`<перші_10_символів_Webhook_secret>_success <amount>`

<div data-with-frame="true"><figure><img src="/files/e983be6e27e5cb4fb76d63f422fb22176e60e56f" alt="" width="524"><figcaption></figcaption></figure></div>

**Приклад:**\
`gltubgnDle_success 100` — де префікс — це перші 10 символів вашого Webhook secret, а `100` — це сума платежу.

### Як додати реакцію на успішну оплату

Щоб надіслати повідомлення клієнту після успішної оплати (наприклад, «Оплату успішно завершено» або будь-яке інше повідомлення), потрібно налаштувати реакцію за допомогою блоку з тригером і callback.

#### Крок 1

Створіть блок з умовою (стартовий блок або блок-тригер).

<div data-with-frame="true"><figure><img src="/files/434e15ad88cca06bce4435a64ca4ae181576e00b" alt=""><figcaption><p>Це стартовий блок з callback у полі Trigger</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/e0c9db52d13f9630c2bb622f9ca7707f93f0d2e7" alt=""><figcaption><p>Це блок-тригер з callback у полі Trigger</p></figcaption></figure></div>

#### Крок 2

Вкажіть частину callback (якщо потрібно реагувати на всі платежі, наприклад, коли у вас кілька різних продуктів), або повний callback (якщо ви хочете налаштувати реакцію лише для продажу конкретного продукту).

<div data-with-frame="true"><figure><img src="/files/5e75b33aeca50c5d95be1e750077d8aee3e8f87b" alt=""><figcaption><p>Якщо вам потрібно налаштувати відповідь на будь-які платежі в проєкті, <br>залиште частину callback і виберіть тип зіставлення «Збіг за ключовими словами»</p></figcaption></figure></div>

#### Крок 3

Напишіть повідомлення-відповідь на успішну оплату та збережіть блок. Крок 3. Напишіть повідомлення-реакцію на успішну оплату та збережіть блок.

<div data-with-frame="true"><figure><img src="/files/2104f46f1628a82e6330d4922e384ce4f62c010a" alt=""><figcaption></figcaption></figure></div>

### Невдала оплата

Якщо оплата не пройшла успішно (відхилено, скасовано тощо, залежно від статусу в API), у діалог може бути надіслано callback у такому форматі:

`<перші_10_символів_Webhook_secret>_fail <amount>`

<div data-with-frame="true"><figure><img src="/files/69241a546478ac892cf7f99feeef7ce69b6f4ce8" alt="" width="563"><figcaption></figcaption></figure></div>

**Приклад:**\
`gltubgnDle_fail 100` — де префікс — це перші 10 символів вашого Webhook secret, а `100` — це сума.

#### Як додати реакцію на невдалу оплату

Щоб надіслати повідомлення клієнту після невдалої оплати (наприклад, «Оплату не вдалося завершити» або будь-яке інше повідомлення), потрібно налаштувати реакцію за допомогою блоку з тригером і callback.

{% hint style="info" %}
[Реакція на невдалу оплату налаштовується так само, як і на успішну.](#how-to-add-a-reaction-to-a-successful-payment)
{% endhint %}

#### Крок 1

Створіть блок з умовою (стартовий блок або блок-тригер).

#### Крок 2

Вкажіть частину callback (якщо потрібно реагувати на всі платежі, наприклад, коли у вас кілька різних продуктів), або повний callback (якщо ви хочете налаштувати реакцію лише для продажу конкретного продукту).

#### Крок 3

Напишіть повідомлення-відповідь на невдалу оплату та збережіть блок.

### Змінні клієнта після успішної оплати

| Змінні                            | Опис                                                   |
| --------------------------------- | ------------------------------------------------------ |
| mercado\_pago\_callback\_data     | Інформація про платіж, отримана від платіжної системи. |
| mercado\_pago\_payment\_completed | «True» — платіж оброблено як успішний.                 |
| mercado\_pago\_payment\_id        | ID платежу Mercado Pago                                |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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/mercado-pago.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.