Iyzico

Чтобы использовать iyzico платёжный шлюз в Mavibot, вам нужно получить свои API-учётные данные из вашей учётной записи продавца iyzico и ввести их в настройках интеграции.

Получение API-учётных данных

1. Войдите в свою панель продавца iyzico.

2. Перейдите в Настройки → API-ключи (API-ключи продавца).

3. Скопируйте следующие учётные данные:

   • API-ключ

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

Эти учётные данные необходимы для подключения iyzico к Mavibot.

Для тестирования iyzico предоставляет отдельные учётные данные с префиксом sandbox- Если вы введёте эти учётные данные, все платежи будут автоматически обрабатываться в режиме Sandbox (тестовом режиме)— дополнительная настройка не требуется. Чтобы принимать реальные платежи, используйте производственные учётные данные (без префиксом 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