> 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/ru/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/0d83467301255d1e589e7fea2b255182a288a2c3" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Информацию о типах токенов и о том, где их найти, см. здесь: [Credentials.](https://www.mercadopago.com.br/developers/en/docs/your-integrations/credentials)
{% endhint %}

## Вебхуки (уведомления о платежах)

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

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

3. Подпишитесь на **Payments** события, чтобы получать уведомления о создании платежа и обновлении его статуса.
4. Сохраните **Webhook secret** — его необходимо ввести в настройках интеграции.

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

## Подключение к Mavibot

В разделе Acquiring выберите **Mercado Pago**.

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

Затем введите:

* **Access Token** — скопированный вами токен.
* **Webhook secret** — секрет, используемый для проверки вебхуков.

<div data-with-frame="true"><figure><img src="/files/d2bb7fd8d6ee089d4369bad95f505a83b69fcecb" 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/85189776ce4ff7a3d736b02b4df980194400a261" alt=""><figcaption><p>В этом примере показано, как передать параметры в функцию и отправить ссылку на оплату в сообщении.</p></figcaption></figure></div>

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

Чтобы отправить кнопку оплаты через Mercado Pago, выберите в конструкторе кнопок тип кнопки с поддержкой оплаты и выберите **Mercado Pago** в качестве платежной системы. При необходимости укажите сумму, описание и валюту.

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

## Колбэки в диалоге после оплаты

### **Успешная оплата**

После того как клиент перейдет по ссылке и успешно завершит оплату, в диалог может быть отправлен колбэк в следующем формате:

`<first_10_characters_of_Webhook_secret>_success <amount>`

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

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

### Как добавить реакцию на успешную оплату

Чтобы отправить клиенту сообщение после успешной оплаты (например, «Оплата успешно завершена» или любое другое сообщение), необходимо настроить реакцию с помощью блока с триггером и колбэком.

#### Шаг 1

Создайте блок с условием (Start block или Trigger block).

<div data-with-frame="true"><figure><img src="/files/5adff3574d7681d2ae31c4ea229d9892e6466e6f" alt=""><figcaption><p>Это Start block с колбэком в поле Trigger</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/45956a5b3881f23679d622d2c5c7d7ff6f9010df" alt=""><figcaption><p>Это Trigger block с колбэком в поле Trigger</p></figcaption></figure></div>

#### Шаг 2

Укажите часть колбэка (если нужно реагировать на все платежи, например, когда у вас несколько разных продуктов) или полный колбэк (если нужно настроить реакцию только на продажу конкретного продукта).

<div data-with-frame="true"><figure><img src="/files/3dcd866ddb471c0524c03c0926e2cc9cf0504888" alt=""><figcaption><p>Если нужно настроить ответ на любые платежи в проекте, <br>оставьте часть колбэка и выберите тип сопоставления «Keywords match»</p></figcaption></figure></div>

#### Шаг 3

Пропишите сообщение-реакцию на успешную оплату и сохраните блок.

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

### Неудачная оплата

Если оплата не прошла успешно (отклонена, отменена и т. д. — в зависимости от статуса в API), в диалог может быть отправлен колбэк в следующем формате:

`<first_10_characters_of_Webhook_secret>_fail <amount>`

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

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

#### Как добавить реакцию на неудачную оплату

Чтобы отправить клиенту сообщение после неудачной оплаты (например, «Оплата не прошла» или любое другое сообщение), необходимо настроить реакцию с помощью блока с триггером и колбэком.

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

#### Шаг 1

Создайте блок с условием (Start block или Trigger block).

#### Шаг 2

Укажите часть колбэка (если нужно реагировать на все платежи, например, когда у вас несколько разных продуктов) или полный колбэк (если нужно настроить реакцию только на продажу конкретного продукта).

#### Шаг 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, and the optional `goal` query parameter:

```
GET https://docs.mavibot.ai/doc/ru/integrations/payment/mercado-pago.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.