Щоб використовувати платіжну систему 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, щоб отримувати сповіщення про створення платежу та оновлення статусу.
- Збережіть Webhook secret — його потрібно ввести в налаштуваннях інтеграції.
Підключення до Mavibot
У розділі Acquiring виберіть Mercado Pago.
Потім введіть:
- Access Token — скопійований токен.
- Webhook secret — секрет, який використовується для перевірки вебхуків.
Генерація платіжного посилання
Функція калькулятора:
get_mercado_pago_payment_url(amount, description, currency, 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).
Крок 2
Вкажіть частину зворотного виклику (якщо потрібно реагувати на всі платежі, наприклад, коли у вас є кілька різних продуктів), або повний зворотний виклик (якщо ви хочете налаштувати реакцію лише на продаж конкретного продукту).
Крок 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 | Ідентифікатор платежу Mercado Pago |