Garanti BBVA
Чтобы использовать Garanti BBVA (виртуальный POS) платёжную систему в Mavibot, вам необходимо получить виртуальный POS-терминал учётные данные от банка и ввести их в настройки интеграции. Платёж обрабатывается на защищённой странице банка с 3D Secure подтверждением.
Получение учётных данных
Заключите соглашение с Garanti BBVA для виртуальный POS (сервис виртуального POS). При активации сервиса попросите банк включить Ortak Ödeme (общая платёжная страница) для вашего терминала. Без этой функции платежи через платёжную страницу банка работать не будут.
Банк предоставит вам следующее:
Merchant ID (Üye İşyeri No) — ваш идентификатор продавца;
Идентификатор терминала — ваш идентификатор терминала;
Идентификатор пользователя Provision — имя пользователя provision (обычно PROVAUT или PROVOOS);
Пароль Provision — пароль пользователя provision.
Ключ Store Key (ключ 3D Secure) создаётся вами в виртуальный POS панели управления (Yönetim → 3D Secure). Обязательно сохраните его, так как он также нужен для интеграции.
Как подключить Garanti BBVA к Mavibot?
В разделе Acquiring разделе Mavibot, выберите Garanti BBVA и введите следующие данные:
Идентификатор продавца — ваш идентификатор продавца.
Идентификатор терминала — ваш идентификатор терминала.
Идентификатор пользователя Provision — имя пользователя provision. Если оставить пустым, PROVAUT будет использовано.
Пароль Provision — пароль пользователя provision.
Ключ магазина — ваш ключ 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 символов вашего Ключ магазина.100— это сумма платежа.
Если платёж не пройдёт, будет отправлено следующее уведомление:
Как отправить ответ на успешный или неуспешный платёж
Шаг 1. Создайте Триггер блок.
Шаг 2. В поле условия введите текст уведомления SDJ91MTKTT_success — без суммы платежа — если вы хотите реагировать на каждый платёж.
В этом случае Тип совпадения должен быть установлен в По ключевым словам.
Альтернативно введите весь текст callback в поле Trigger, если вы хотите реагировать на конкретный платёж. В этом случае тип совпадения должен быть установлен в Exact Match.
Если вы хотите продолжить сценарий после успешного платежа, вы можете создать Start блок вместо Триггер блока и продолжить построение сценария бота оттуда.
Переменные клиента после успешного платежа
garanti_callback_data
Информация о платеже, полученная от платёжной системы.
garanti_payment_completed
"True" если платёж был успешно обработан.
garanti_auth_code
Авторизационный код банковской операции.
Последнее обновление