Garanti BBVA
Щоб використовувати Garanti BBVA (Sanal POS) платіжної системи в Mavibot, вам потрібно отримати віртуальний POS-термінал облікові дані від банку та ввести їх у налаштування інтеграції. Оплата обробляється на захищеній сторінці банку з 3D Secure підтвердженням.
Отримання облікових даних
Укладіть договір з Garanti BBVA для Sanal POS сервісу (віртуальний POS). Під час активації сервісу попросіть банк увімкнути Ortak Ödeme (спільна платіжна сторінка) для вашого термінала. Без цієї функції платежі через платіжну сторінку банку не працюватимуть.
Банк надасть вам:
Ідентифікатор продавця (Üye İşyeri No) — ваш Merchant ID;
Ідентифікатор термінала — ваш Terminal ID;
Provision User ID — ім’я користувача для provision (зазвичай PROVAUT або PROVOOS);
Provision Password — пароль користувача для provision.
Цей Store Key (ключ 3D Secure) створюється вами в Sanal POS панелі керування (Yönetim → 3D Secure). Обов’язково збережіть його, оскільки він також потрібен для інтеграції.
Як підключити Garanti BBVA до Mavibot?
У Еквайринг розділі Mavibot, виберіть Garanti BBVA і введіть такі дані:
Ідентифікатор продавця — ваш ідентифікатор продавця.
Ідентифікатор термінала — ваш ідентифікатор термінала.
Provision User ID — ім’я користувача для provision. Якщо залишити порожнім, PROVAUT буде використано.
Provision Password — пароль користувача для provision.
Ключ Store — ваш ключ 3D Secure.
Назва магазину — назва, що відображається клієнтам на платіжній сторінці банку. Якщо залишити порожнім, "Інтернет-магазин" буде відображено.
Тестовий режим — увімкніть цю опцію, щоб протестувати інтеграцію, використовуючи тестові облікові дані банку. Для обробки реальних платежів цю опцію потрібно вимкнути.
Інтеграцію завершено.
Генерування платіжного посилання
Функція калькулятора:
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 платежу.
Платіжне посилання в кнопці
Щоб надіслати кнопку з платіжним посиланням, виберіть Платіж тип кнопки та виберіть Garanti BBVA як платіжного провайдера. Потім введіть назву товару, суму платежу та, за потреби, валюту платежу.
Приклад 1: Налаштування робочого процесу
Крок 1. Створіть Start блок.
Блок Start зазвичай використовується для відображення першого вітального повідомлення в робочому процесі разом із будь-якою вступною інформацією, яка потрібна користувачу.
Крок 2. Створіть блок, показаний нижче.
Крок 3. Перейдіть до Підключення налаштувань.
Для перевірки того, що клієнт увів дійсну адресу електронної пошти, вам знадобиться такий регулярний вираз:
^[-\\w.]+@([A-z0-9][-A-z0-9]+.)+[A-z]{2,4}$
Також увімкніть Користувач вводить дані опцію та введіть customer_email.
Крок 4. Введіть повідомлення в другому блоці.
Крок 5. Створіть третій блок і відкрийте Підключення налаштування між другим і третім блоками.
Увімкніть таймер, щоб автоматично перейти до наступного блоку.
Крок 6. У третьому блоці введіть функцію в Калькулятор.
Приклад для копіювання:
Якщо ви хочете приймати платежі у валюті, відмінній від турецької ліри (TRY), вкажіть валюту, як показано нижче.
Приклад для копіювання:
Приклад 2. Кнопка білінгу
Цей приклад майже ідентичний Приклад 1.
Однак замість створення третього блоку з функцією для генерації платіжного посилання ви можете створити кнопку в другому блоці.
У вікні, що відкриється:
Введіть текст кнопки.
Виберіть Білінг функцію.
Виберіть Garanti BBVA як платіжного провайдера.
Потім введіть таке:
Назва товару.
Сума платежу.
Валюта (необов’язково).
Повне ім’я клієнта (необов’язково). Ви можете налаштувати це так само, як налаштували введення електронної пошти клієнта.
Електронна пошта клієнта — введіть змінну
#{customer_email}.
Потім натисніть Додати.
Сповіщення після оплати
Після того як клієнт перейде за платіжним посиланням і завершить оплату, у розмову буде надіслано сповіщення (callback).
Для успішного платежу:
Де:
SDJ91MTKTT— це перші 10 символів вашого Ключ Store.100— це сума платежу.
Якщо платіж не вдасться, буде надіслано таке сповіщення:
Як надіслати відповідь на успішний або невдалий платіж
Крок 1. Створіть Тригер блок.
Крок 2. У полі умови введіть текст сповіщення SDJ91MTKTT_success — без суми платежу — якщо ви хочете реагувати на кожен платіж.
У цьому випадку Тип зіставлення має бути встановлено на За ключовими словами.
Або введіть повний текст callback у полі Trigger, якщо ви хочете реагувати на конкретний платіж. У цьому випадку тип зіставлення має бути встановлено на Точний збіг.
Якщо ви хочете продовжити робочий процес після успішного платежу, ви можете створити Start блок замість Тригер блоку й продовжити побудову потоку вашого бота звідти.
Змінні клієнта після успішного платежу
garanti_callback_data
Інформація про платіж, отримана від платіжної системи.
garanti_payment_completed
"True" якщо платіж було успішно оброблено.
garanti_auth_code
Код авторизації транзакції банку.
Останнє оновлення