EBANX
Щоб використовувати платіжну платформу EBANX у Mavibot, вам потрібно отримати свій Integration Key у вашому обліковому записі EBANX і ввести його в налаштуваннях оплати.
EBANX — це агрегатор локальних платіжних методів по всій Латинській Америці. Платежі обробляються на захищеній сторінці оформлення замовлення, розміщеній EBANX, де клієнтам показуються способи оплати, доступні в їхній країні (наприклад, PIX і boleto в Бразилії, OXXO і SPEI в Мексиці, PSE в Колумбії, кредитні/дебетові картки та інші).
Отримання Integration Key
Підпишіть угоду з EBANX і отримайте доступ до EBANX Business Portal (вашої панелі продавця).
Під час процесу підключення виберіть країни, в яких ви хочете приймати платежі. Клієнти зможуть оплачувати лише з країн, увімкнених у вашому обліковому записі EBANX.
У налаштуваннях інтеграції скопіюйте свій Integration Key. Він знадобиться вам для підключення EBANX до Mavibot.
Для тестування EBANX надає окремий sandbox-акаунт із власним Integration Key. Див. нижче Test Mode.
Підключення EBANX
У налаштуваннях платіжних систем виберіть EBANX і введіть таке:
Integration Key — скопійований вами Integration Key EBANX.
Країна — країна платежу за замовчуванням (двобуквений код країни в нижньому регістрі:
brдля Бразилії,mxдля Мексики,coдля Колумбії,clдля Чилі,peдля Перу,arдля Аргентини тощо). Це визначає, які способи оплати клієнти бачитимуть на сторінці оформлення замовлення. Вибрана країна має бути увімкнена у вашому обліковому записі EBANX.Test Mode — увімкніть цю опцію, щоб протестувати інтеграцію, використовуючи sandbox-середовище EBANX. Коли Test Mode увімкнено, використовуйте Integration Key із вашого sandbox-акаунта. Щоб приймати реальні платежі, вимкніть Test Mode та використовуйте ваш живий Integration Key.
Налаштування завершено.
Створення платіжного посилання
Функція калькулятора:
get_ebanx_payment_url(amount, description, currency, customer_email, full_name, country)
Параметри
amount — сума платежу. Обов’язково.
customer_email — адреса електронної пошти клієнта. Обов’язково. Без неї EBANX не може створити платіж. На цю адресу електронної пошти клієнт також отримає підтвердження платежу.
full_name — повне ім’я клієнта. Обов’язково.
description — опис платежу. Необов’язково.
currency — валюта платежу. Ви можете використовувати або:
локальну валюту країни платежу (таку як
BRL,MXN,COP,CLP,PEN,ARS, тощо), абовалюту вашого облікового запису EBANX (зазвичай
USD), у такому разі EBANX конвертує суму за своїм обмінним курсом.
Необов’язково. Значення за замовчуванням:
USD.country — країна платежу (двобуквений код країни в нижньому регістрі). Необов’язково. Якщо не вказано, буде використано країну за замовчуванням, зазначену в налаштуваннях оплати.
Функція повертає URL для оплати.
Примітка: Вибрана валюта має бути сумісною з країною платежу. Це має бути або місцева валюта країни, або валюта вашого облікового запису EBANX. Наприклад, для br (Бразилія), BRL та USD є дійсними, тоді як MXN не є.
Кнопка платіжного посилання
Щоб надіслати кнопку оплати, виберіть тип Payment Button і виберіть EBANX як платіжну систему.
Введіть:
назву продукту;
суму платежу;
валюту;
змінні, що містять повне ім’я та адресу електронної пошти клієнта.
За потреби вкажіть країну платежу.
Приклад 1: Налаштування робочого процесу
Крок 1. Створіть Початок блок.
Блок «Початок» зазвичай використовується для показу першого вітального повідомлення в робочому процесі разом із будь-якою вступною інформацією, яка потрібна користувачеві.
Крок 2. Створіть блок, показаний нижче.
Крок 3. Перейдіть до Підключення налаштувань.
Вам знадобиться таке регулярне вираження, щоб перевірити, що клієнт увів дійсну адресу електронної пошти:
^[-\w.]+@([A-z0-9][-A-z0-9]+.)+[A-z]{2,4}$
Також увімкніть Користувач вводить дані опцію та введіть customer_email.
Крок 4. Введіть повідомлення в другому блоці.
Крок 5. Створіть третій блок і відкрийте Підключення налаштування між другим і третім блоками.
Увімкніть таймер, щоб автоматично перейти до наступного блока.
Крок 6. У третьому блоці введіть функцію в Калькуляторі.
Приклад для копіювання:
Якщо ви хочете приймати платежі в іншій валюті, ніж USD, вкажіть валюту, як показано нижче.
Приклад 2. Кнопка виставлення рахунку
Цей приклад майже ідентичний Прикладу 1.
Однак замість створення третього блока з функцією для генерації платіжного посилання ви можете створити кнопку в другому блоці.
У вікні, що відкриється:
Введіть текст кнопки.
Виберіть виставлення рахунку .
Виберіть EBANX як платіжного провайдера.
Потім введіть таке:
Назва продукту.
Сума платежу.
Валюта (необов’язково).
Повне ім’я клієнта (необов’язково). Ви можете налаштувати це так само, як налаштували введення електронної пошти клієнта.
Електронна пошта клієнта — введіть змінну
#{customer_email}.
Потім натисніть Додати.
Сповіщення після оплати
Після того як клієнт відкриє платіжне посилання й завершить оплату, у разі успішної оплати в розмову надсилається такий callback:
Де:
SDJ91MTKTT— це перші 10 символів вашого Integration Key.100— це сума платежу.
Якщо платіж скасовано, надсилається такий callback:
Для офлайн-методів оплати (таких як boleto, OXXO тощо) підтвердження платежу не є миттєвим. EBANX надсилає callback лише після отримання коштів, що може тривати 1–3 робочі дні. Callback буде доставлено автоматично, щойно платіж буде підтверджено.
Як надіслати відповідь на успішний або невдалий платіж
Крок 1. Створіть Тригер блок.
Крок 2. У полі умови введіть текст сповіщення SDJ91MTKTT_success — без суми платежу — якщо ви хочете реагувати на кожен платіж.
У цьому випадку Тип збігу має бути встановлений на За ключовими словами.
Або ж введіть увесь текст callback у полі Trigger, якщо ви хочете реагувати на конкретний платіж. У цьому випадку Тип збігу має бути встановлений на Точний збіг.
Якщо ви хочете продовжити робочий процес після успішної оплати, ви можете створити Початок блок замість Тригер блока і продовжити побудову потоку вашого бота звідти.
Змінні клієнта після успішної оплати
Змінна
Значення
ebanx_callback_data
Інформація про платіж, отримана від платіжної системи
ebanx_payment_completed
"True" — платіж оброблено як успішний
ebanx_payment_hash
Ідентифікатор платежу в EBANX (хеш)
Останнє оновлення