Iyzico
Останнє оновлення
Щоб використовувати iyzico платіжний шлюз у Mavibot, вам потрібно отримати свої API-облікові дані з вашого облікового запису продавця iyzico та ввести їх у налаштуваннях інтеграції.
Увійдіть до панелі продавця iyzico.
Перейдіть до Налаштування → Ключі API (Ключі API продавця).
Скопіюйте такі облікові дані:
Ключ API
Секретний ключ
Ці облікові дані потрібні для підключення iyzico до Mavibot.
Для тестування iyzico надає окремі облікові дані з sandbox- префіксом. Якщо ви введете ці облікові дані, усі платежі автоматично оброблятимуться в режимі Sandbox (тестовому)— додаткове налаштування не потрібне. Щоб приймати реальні платежі, використовуйте свої production-облікові дані (без sandbox- префікса).
На вкладці Acquiring виберіть iyzico.

Потім введіть:
Ключ API — ваш API-ключ.
Секретний ключ — ваш Секретний ключ.

Інтеграцію завершено.
Функція калькулятора:
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 платіжного посилання.

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

Після того як клієнт відкриє платіжне посилання та завершить платіж, до діалогу надсилається такий callback у разі успішної оплати:
SDJ91MTKTT_success 100

Де:
SDJ91MTKTT це перші 10 символів вашого Секретний ключ.
100 це сума платежу.
Якщо платіж не вдається, надсилається такий callback:
SDJ91MTKTT_fail 100

iyzico_callback_data
Інформація про платіж, отримана від iyzico
iyzico_payment_completed
"True" якщо платіж успішно оброблено
iyzico_payment_id
ID платежу iyzico
Останнє оновлення