Щоб використовувати платіжну систему Garanti BBVA (Sanal POS) у Mavibot, необхідно отримати облікові дані віртуального POS-терміналу від банку та ввести їх у налаштуваннях інтеграції. Платіж обробляється на безпечній сторінці банку з підтвердженням 3D Secure.

Отримання облікових даних

Укладіть договір з Garanti BBVA на послугу Sanal POS (віртуальний POS). Під час активації послуги попросіть банк увімкнути Ortak Ödeme (спільну платіжну сторінку) для вашого терміналу. Без цієї функції платежі через платіжну сторінку банку не працюватимуть.

Банк надасть вам:

  • Merchant ID (Üye İşyeri No) — ваш ідентифікатор продавця;
  • Terminal ID — ваш ідентифікатор терміналу;
  • Provision User ID — ім'я користувача для забезпечення (зазвичай PROVAUT або PROVOOS);
  • Provision Password — пароль користувача для забезпечення.

Store Key (ключ 3D Secure) створюється вами в панелі керування Sanal POS (Yönetim → 3D Secure). Обов'язково збережіть його, оскільки він також потрібен для інтеграції.

Як підключити Garanti BBVA до Mavibot?

У розділі Acquiring в Mavibot виберіть Garanti BBVA та введіть такі дані:

  • Merchant ID — ваш ідентифікатор продавця.
  • Terminal ID — ваш ідентифікатор терміналу.
  • Provision User ID — ім'я користувача для забезпечення. Якщо залишити порожнім, буде використано PROVAUT.
  • Provision Password — пароль користувача для забезпечення.
  • Store Key — ваш ключ 3D Secure.
  • Store Name — назва, яка відображатиметься клієнтам на платіжній сторінці банку. Якщо залишити порожнім, буде показано "Online store".
  • Test Mode — увімкніть цю опцію для тестування інтеграції з використанням тестових облікових даних банку. Для обробки реальних платежів цю опцію потрібно вимкнути.

Інтеграцію завершено.

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

Функція калькулятора:

get_garanti_payment_url(amount, description, currency, customer_email, language)

Параметри:

Параметр Опис Обов'язковий Значення за замовчуванням / Дозволені значення
amount Сума платежу. ✅ —
description Опис платежу. Ні —
currency Валюта платежу. Ні TRY (за замовчуванням). Підтримувані значення: TRY, USD, EUR, GBP, JPY
customer_email Електронна адреса клієнта. Ні —
language Мова платіжної сторінки. Ні tr (за замовчуванням). Підтримувані значення: tr, en

Функція повертає URL-адресу платежу.

Платіжне посилання в кнопці

Щоб надіслати кнопку з платіжним посиланням, виберіть тип кнопки Payment та оберіть Garanti BBVA як платіжного провайдера. Потім введіть назву товару, суму платежу та, за потреби, валюту платежу.

Приклад 1: Налаштування робочого процесу

Крок 1. Створіть блок Start.

Блок Start зазвичай використовується для відображення першого вітального повідомлення в робочому процесі, а також будь-якої вступної інформації, необхідної користувачеві.

Крок 2. Створіть блок, показаний нижче.

Крок 3. Перейдіть до налаштувань Connection.

Вам знадобиться наступний регулярний вираз, щоб перевірити, чи клієнт ввів дійсну електронну адресу:

^[-\w.]+@([A-z0-9][-A-z0-9]+.)+[A-z]{2,4}$

Також увімкніть опцію User enters data та введіть customer_email.

Крок 4. Введіть повідомлення в другому блоці.

Крок 5. Створіть третій блок і відкрийте налаштування Connection між другим і третім блоками.

Увімкніть таймер для автоматичного переходу до наступного блоку.

Крок 6. У третьому блоці введіть функцію в Calculator.

Приклад для копіювання:

amount = 1000
description = "Product1 is a product of great reliability!"
link = get_garanti_payment_url(amount, description, none, customer_email, none)

Якщо ви хочете приймати платежі у валюті, відмінній від турецької ліри (TRY), вкажіть валюту, як показано нижче.

Приклад для копіювання:

amount = 1000
description = "Product1 is a product of great reliability!"
currency = "USD"
link = get_garanti_payment_url(amount, description, currency, customer_email, none)

Приклад 2. Кнопка виставлення рахунку

Цей приклад майже ідентичний Прикладу 1.

Однак замість створення третього блоку з функцією для генерації платіжного посилання ви можете створити кнопку в другому блоці.

У вікні, що відкриється:

  • Введіть текст кнопки.
  • Виберіть функцію Billing.
  • Виберіть Garanti BBVA як платіжного провайдера.

Потім введіть наступне:

  • Product Name.
  • Payment Amount.
  • Currency (необов'язково).
  • Client Full Name (необов'язково). Ви можете налаштувати це так само, як налаштували введення електронної адреси клієнта.
  • Customer Email — введіть змінну #{customer_email}.

Потім натисніть Add.

Сповіщення після оплати

Після того, як клієнт перейде за платіжним посиланням і завершить оплату, до розмови буде надіслано сповіщення (зворотний виклик).

Для успішної оплати:

SDJ91MTKTT_success 100

Де:

  • SDJ91MTKTT — перші 10 символів вашого Store Key.
  • 100 — сума платежу.

Якщо платіж не вдався, буде надіслано наступне сповіщення:

SDJ91MTKTT_fail 100

Як надіслати відповідь на успішний або невдалий платіж

Крок 1. Створіть блок Trigger.

Крок 2. У полі умови введіть текст сповіщення SDJ91MTKTT_success — без суми платежу — якщо ви хочете реагувати на кожен платіж.

У цьому випадку Match Type має бути встановлено на By Keywords.

Або введіть весь текст зворотного виклику в поле Trigger, якщо ви хочете реагувати на конкретний платіж. У цьому випадку Match Type має бути встановлено на Exact Match.

Якщо ви хочете продовжити робочий процес після успішної оплати, ви можете створити блок Start замість блоку Trigger і продовжити створення потоку вашого бота звідти.

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