Чтобы использовать платежный шлюз iyzico в Mavibot, необходимо получить учетные данные API из вашего мерчант-аккаунта iyzico и ввести их в настройках интеграции.
Получение учетных данных API
- Войдите в панель мерчанта iyzico.
- Перейдите в Настройки → Ключи API (Merchant API Keys).
- Скопируйте следующие учетные данные:
- API Key
- Secret Key
Эти учетные данные необходимы для подключения iyzico к Mavibot.
Для тестирования iyzico предоставляет отдельные учетные данные с префиксом sandbox-. Если вы введете эти учетные данные, все платежи будут автоматически обрабатываться в режиме Sandbox (тестовом) — дополнительная настройка не требуется. Для приема реальных платежей используйте свои рабочие учетные данные (без префикса sandbox-).
Подключение iyzico
На вкладке Acquiring выберите iyzico.
Затем введите:
- API Key — ваш API-ключ.
- Secret Key — ваш секретный ключ.
Интеграция завершена.
Генерация платежной ссылки
Функция калькулятора:
get_iyzico_payment_url(amount, description, currency, customer_email, customer_phone, full_name, identity_number, city, country, address, product_name, language)
Параметры
| Параметр | Описание | Обязательный | Значение по умолчанию / Допустимые значения |
|---|---|---|---|
amount |
Сумма платежа. | ✅ | — |
description |
Описание платежа. | Нет | — |
currency |
Валюта платежа. | Нет |
По умолчанию: TRYПоддерживаемые: TRY, USD, EUR, GBP, CHF, NOK
|
customer_email |
Адрес электронной почты клиента. | Нет | — |
customer_phone |
Номер телефона клиента в международном формате (например, +905XXXXXXXXX). |
Нет | — |
full_name |
Полное имя клиента. | Нет | — |
identity_number |
Идентификационный номер клиента (для клиентов из Турции это TCKN). | Нет | — |
city |
Город клиента. | Нет | — |
country |
Страна клиента. | Нет | — |
address |
Адрес клиента. | Нет | — |
product_name |
Название товара, отображаемое на странице оплаты. Если не указано, используется description. |
Нет | Используется description
|
language |
Язык страницы оплаты. | Нет |
По умолчанию: enПоддерживаемые: en, tr
|
Функция возвращает URL платежа.
Кнопка с платежной ссылкой
Чтобы отправить кнопку с платежной ссылкой, выберите тип Payment Button и укажите iyzico в качестве платежного шлюза. Затем введите название товара, сумму платежа и, при необходимости, валюту платежа.
Обратные вызовы платежа
После того как клиент откроет платежную ссылку и завершит оплату, при успешном платеже в диалог отправляется следующий обратный вызов:
SDJ91MTKTT_success 100
Где:
-
SDJ91MTKTT— первые 10 символов вашего Secret Key. -
100— сумма платежа.
Если платеж не удался, отправляется следующий обратный вызов:
SDJ91MTKTT_fail 100
Переменные клиента после успешного платежа
| Переменная | Значение |
|---|---|
iyzico_callback_data |
Информация о платеже, полученная от iyzico |
iyzico_payment_completed |
"True", если платеж был успешно обработан |
iyzico_payment_id |
ID платежа iyzico |