For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

Останнє оновлення