For the complete documentation index, see llms.txt. This page is also available as Markdown.

Iyzico

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

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

  1. Увійдіть до панелі продавця iyzico.

  2. Перейдіть до Налаштування → Ключі API (Ключі API продавця).

  3. Скопіюйте такі облікові дані:

    • Ключ API

    • Секретний ключ

Ці облікові дані потрібні для підключення iyzico до Mavibot.

Для тестування iyzico надає окремі облікові дані з sandbox- префіксом. Якщо ви введете ці облікові дані, усі платежі автоматично оброблятимуться в режимі Sandbox (тестовому)— додаткове налаштування не потрібне. Щоб приймати реальні платежі, використовуйте свої production-облікові дані (без sandbox- префікса).

Підключення iyzico

На вкладці 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

Останнє оновлення