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-токен.

Информацию о типах токенов и о том, где их найти, см. здесь: Credentials.

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

1. В настройках интеграции откройте раздел Вебхуки / уведомления (см.: Webhooks).

2. Укажите URL для уведомлений:

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

1. Подпишитесь на Payments события, чтобы получать уведомления о создании платежа и обновлении его статуса.

2. Сохраните Webhook secret — его необходимо ввести в настройках интеграции.

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

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

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

• Access Token — скопированный вами токен.

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

Генерация платежной ссылки

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

Параметры	Описание
! amount	Сумма платежа. Это обязательный параметр.
description	Описание платежа. Это необязательный параметр.
currency	Код валюты ISO (например, BRL, ARS, MXN, USD, EUR, CLP, COP, PEN, UYU) — необязательно; по умолчанию используется BRL.
customer_email	Электронная почта клиента — необязательно.
product_name	Альтернативное название продукта — необязательно; если не указано, вместо него используется описание.

Функция возвращает ссылку на оплату.

В этом примере показано, как передать параметры в функцию и отправить ссылку на оплату в сообщении.

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

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

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

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

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

<first_10_characters_of_Webhook_secret>_success <amount>

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

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

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

Шаг 1

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

Это Start block с колбэком в поле Trigger

Это Trigger block с колбэком в поле Trigger

Шаг 2

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

Если нужно настроить ответ на любые платежи в проекте, оставьте часть колбэка и выберите тип сопоставления «Keywords match»

Шаг 3

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

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

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

<first_10_characters_of_Webhook_secret>_fail <amount>

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

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

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

Реакция на неудачную оплату настраивается так же, как и на успешную.

Шаг 1

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

Шаг 2

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

Шаг 3

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

Переменные клиента после успешной оплаты

Переменные	Описание
mercado_pago_callback_data	Информация о платеже, полученная от платежной системы.
mercado_pago_payment_completed	«True» — платеж обработан как успешный.
mercado_pago_payment_id	ID платежа Mercado Pago