لاستخدام بوابة الدفع iyzico في Mavibot، يجب عليك الحصول على بيانات اعتماد API من حساب التاجر الخاص بك في iyzico وإدخالها في إعدادات التكامل.
الحصول على بيانات اعتماد API
- سجّل الدخول إلى لوحة تحكم التاجر في iyzico.
- انتقل إلى الإعدادات ← مفاتيح API (مفاتيح API للتاجر).
- انسخ بيانات الاعتماد التالية:
- مفتاح API
- المفتاح السري
هذه البيانات مطلوبة لتوصيل iyzico بـ Mavibot.
للاختبار، توفر iyzico بيانات اعتماد منفصلة ببادئة sandbox-. إذا قمت بإدخال هذه البيانات، فسيتم معالجة جميع المدفوعات تلقائيًا في وضع الاختبار (Sandbox) — دون الحاجة إلى أي إعدادات إضافية. لقبول المدفوعات الحقيقية، استخدم بيانات اعتماد الإنتاج الخاصة بك (بدون بادئة sandbox-).
توصيل iyzico
في علامة التبويب "الاستحواذ"، اختر 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
|
ترجع الدالة رابط دفع.
زر رابط الدفع
لإرسال زر مع رابط دفع، اختر نوع زر الدفع واختر iyzico كبوابة دفع. ثم أدخل اسم المنتج ومبلغ الدفع، وإذا لزم الأمر، عملة الدفع.
استدعاءات الدفع
بعد أن يفتح العميل رابط الدفع ويكمل الدفع، يتم إرسال الاستدعاء التالي إلى المحادثة عند نجاح الدفع:
SDJ91MTKTT_success 100
حيث:
-
SDJ91MTKTTهي أول 10 أحرف من المفتاح السري الخاص بك. -
100هو مبلغ الدفع.
إذا فشل الدفع، يتم إرسال الاستدعاء التالي:
SDJ91MTKTT_fail 100
متغيرات العميل بعد الدفع الناجح
| المتغير | القيمة |
|---|---|
iyzico_callback_data |
معلومات الدفع المستلمة من iyzico |
iyzico_payment_completed |
"True" إذا تمت معالجة الدفع بنجاح |
iyzico_payment_id |
معرف الدفع من iyzico |