Щоб використовувати платіжний шлюз iyzico у Mavibot, потрібно отримати облікові дані API з вашого мерчант-акаунта iyzico та ввести їх у налаштуваннях інтеграції.

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

  1. Увійдіть у свою Merchant Panel iyzico.
  2. Перейдіть до Settings → API Keys (Merchant API Keys).
  3. Скопіюйте наступні облікові дані:
    • 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 Ідентифікатор платежу iyzico