Чтобы использовать платежную систему Mercado Pago, выполните настройки ниже в панели разработчика Mercado Pago, а затем введите данные в настройках интеграции.
Приложение и токен доступа
- Войдите в Mercado Pago и откройте раздел для разработчиков (Developers / Suas integrações).
- Создайте приложение (Your integrations → Create application), если у вас его еще нет.
- Скопируйте Production Access Token или Test Access Token — этот токен будет использоваться как основной API-токен.
Информацию о типах токенов и о том, где их найти, см.: Credentials.
Webhooks (уведомления о платежах)
- В настройках интеграции откройте раздел Webhooks / уведомления (см.: Webhooks).
- Установите URL-адрес уведомления:
https://chatter.mavibot.ai/mercado_pago_callback/result
- Подпишитесь на события Payments, чтобы получать уведомления о создании платежа и обновлении статуса.
- Сохраните секрет вебхука — его необходимо ввести в настройках интеграции.
Подключение к Mavibot
В разделе Acquiring выберите Mercado Pago.
Затем введите:
- Access Token — скопированный токен.
- Webhook secret — секрет, используемый для проверки вебхуков.
Генерация платежной ссылки
Функция калькулятора:
get_mercado_pago_payment_url(amount, description, currency, customer_email, product_name)
Функция возвращает платежную ссылку.
Оплата через кнопку
Чтобы отправить кнопку оплаты через Mercado Pago, выберите тип кнопки с поддержкой оплаты в конструкторе кнопок и выберите Mercado Pago в качестве платежной системы. При необходимости укажите сумму, описание и валюту.
Callback в диалоге после оплаты
Успешная оплата
После того как клиент перейдет по ссылке и успешно оплатит, в диалог может быть отправлен callback в следующем формате:
<первые_10_символов_секрета_вебхука>_success <сумма>
Пример:
gltubgnDle_success 100 — где префикс — это первые 10 символов вашего секрета вебхука, а 100 — сумма платежа.
Как добавить реакцию на успешную оплату
Чтобы отправить клиенту сообщение после успешной оплаты (например, «Оплата прошла успешно» или любое другое сообщение), необходимо настроить реакцию с помощью блока с триггером и callback.
Шаг 1
Создайте блок с условием (Start block или Trigger block).
Шаг 2
Укажите часть callback (если нужно реагировать на все платежи, например, когда у вас несколько разных товаров) или полный callback (если хотите настроить реакцию только на продажу конкретного товара).
Шаг 3
Пропишите сообщение-реакцию на успешную оплату и сохраните блок.
Неудачная оплата
Если платеж не прошел успешно (отклонен, отменен и т.д., в зависимости от статуса в API), может быть отправлен callback в следующем формате:
<первые_10_символов_секрета_вебхука>_fail <сумма>
Пример:
gltubgnDle_fail 100 — где префикс — это первые 10 символов вашего секрета вебхука, а 100 — сумма.
Как добавить реакцию на неудачную оплату
Чтобы отправить клиенту сообщение после неудачной оплаты (например, «Оплата не прошла» или любое другое сообщение), необходимо настроить реакцию с помощью блока с триггером и callback.
Реакция на неудачную оплату настраивается так же, как и на успешную.
Шаг 1
Создайте блок с условием (Start block или Trigger block).
Шаг 2
Укажите часть callback (если нужно реагировать на все платежи, например, когда у вас несколько разных товаров) или полный callback (если хотите настроить реакцию только на продажу конкретного товара).
Шаг 3
Пропишите сообщение-реакцию на неудачную оплату и сохраните блок.
Переменные клиента после успешной оплаты
| Переменные | Описание |
|---|---|
| mercado_pago_callback_data | Информация о платеже, полученная от платежной системы. |
| mercado_pago_payment_completed | «True» — платеж обработан как успешный. |
| mercado_pago_payment_id | ID платежа в Mercado Pago |