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