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

Щоб дізнатися про типи токенів і де їх знайти, дивіться: Облікові дані.

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

1. У налаштуваннях інтеграції відкрийте Webhooks / сповіщення розділ (див.: Webhooks).

2. Встановіть URL сповіщень:

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

1. Підпишіться на Платежі події, щоб отримувати сповіщення про створення платежів і оновлення статусу.

2. Збережіть секрет Webhook — його потрібно ввести в налаштуваннях інтеграції.

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

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

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

• Access Token — токен, який ви скопіювали.

• секрет Webhook — секрет, що використовується для перевірки webhook.

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

Функція калькулятора: 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 як платіжну систему. За потреби введіть суму, опис і валюту.

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

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

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

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

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

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

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

Крок 1

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

Це стартовий блок з callback у полі Trigger

Це блок-тригер з callback у полі Trigger

Крок 2

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

Якщо вам потрібно налаштувати відповідь на будь-які платежі в проєкті, залиште частину callback і виберіть тип зіставлення «Збіг за ключовими словами»

Крок 3

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

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

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

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

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

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

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

Реакція на невдалу оплату налаштовується так само, як і на успішну.

Крок 1

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

Крок 2

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

Крок 3

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

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

Змінні	Опис
mercado_pago_callback_data	Інформація про платіж, отримана від платіжної системи.
mercado_pago_payment_completed	«True» — платіж оброблено як успішний.
mercado_pago_payment_id	ID платежу Mercado Pago