Mavibot-та iyzico төлем шлюзін пайдалану үшін iyzico сауда шотыңыздан API тіркелгі деректерін алып, оларды интеграция параметрлеріне енгізуіңіз керек.
API тіркелгі деректерін алу
- iyzico сауда панеліне кіріңіз.
- Параметрлер → API кілттері (Сауда API кілттері) бөліміне өтіңіз.
- Келесі тіркелгі деректерін көшіріп алыңыз:
- 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 таңдаңыз. Содан кейін өнім атауын, төлем сомасын және қажет болса, төлем валютасын енгізіңіз.
Төлем кері шақырулары
Тұтынушы төлем сілтемесін ашып, төлемді аяқтағаннан кейін, сәтті төлем кезінде әңгімеге келесі кері шақыру жіберіледі:
SDJ91MTKTT_success 100
Мұнда:
-
SDJ91MTKTT— Құпия кілтіңіздің алғашқы 10 таңбасы. -
100— төлем сомасы.
Егер төлем сәтсіз болса, келесі кері шақыру жіберіледі:
SDJ91MTKTT_fail 100
Сәтті төлемнен кейінгі тұтынушы айнымалылары
| Айнымалы | Мәні |
|---|---|
iyzico_callback_data |
iyzico-дан алынған төлем ақпараты |
iyzico_payment_completed |
Төлем сәтті өңделсе, "True"
|
iyzico_payment_id |
iyzico төлем идентификаторы |