تكامل iyzico

التحصيل بالبطاقة والتقسيط والاشتراكات في تركيا: بنينا مدفوعات Hippotenus على الويب عبر iyzico ونشغّلها بأنفسنا.

نضيف إلى تطبيق الويب الخاص بك الدفع لمرة واحدة والتقسيط والاشتراكات عبر iyzico. هكذا تعمل مدفوعات Hippotenus، ولا تصل بيانات البطاقة إلى خادمنا.

آخر تحديث:

ما بنيناه بهذه التقنية

جميعها منشورة؛ صفحات المتاجر والتفاصيل في صفحة المنتجات.

Hippotenus

منصة للمؤسسات التعليمية

الاشتراكات والباقات المدفوعة مسبقاً عبر iyzico؛ تبقى بيانات البطاقة في نموذج الدفع الخاص بـ iyzico، ويعيد الخادم قراءة النتيجة من iyzico والتحقق منها.

اعرض المنتج

متى يكون iyzico الخيار الصحيح

iyzico مؤسسة دفع تستخدمها الشركات التي تتلقى المدفوعات عبر الإنترنت في تركيا. تتيح تحصيل المدفوعات من البطاقات التركية وتقديم التقسيط وإدارة المدفوعات المتكررة (الاشتراكات) عبر API واحدة، دون توقيع عقد نقطة بيع افتراضية منفصل مع كل بنك. تُدخل بيانات البطاقة في نموذج الدفع الخاص بـ iyzico، فلا يمر رقم البطاقة بخادمك أبداً.

حيث يناسب iyzico

  • تتلقى مدفوعات بالبطاقة عبر الويب من عملاء في تركيا
  • تريد تقديم خيار التقسيط
  • تبيع اشتراكات شهرية أو سنوية وتريد تحصيل التجديدات تلقائياً
  • لا تريد تخزين بيانات البطاقات على خادمك

حيث نقترح طريقاً آخر

  • تبيع محتوى رقمياً أو اشتراكات داخل تطبيق جوال: تشترط Apple وGoogle هنا أنظمة الدفع الخاصة بهما
  • لديك أصلاً عقد نقطة بيع افتراضية مع بنكك بشروط جيدة؛ وقد يكون التكامل المباشر مع البنك أنسب
  • شركتك مسجلة خارج تركيا ومعظم مبيعاتك في الخارج؛ وقد يناسبك أكثر مزوّد يعمل في بلدك

كيف يعمل iyzico في Hippotenus

في Hippotenus نموذجان للدفع، وكلاهما عبر iyzico: الاشتراك والباقات المدفوعة مسبقاً. في الاشتراك نستخدم API الاشتراكات لدى iyzico؛ المنتجات وخطط الأسعار معرّفة في iyzico، وiyzico هو من يحصّل التجديدات، ويمر الإلغاء وترقية الخطة وتحديث البطاقة عبر الواجهة نفسها. وفي الباقات المدفوعة مسبقاً نتلقى عبر نموذج الدفع دفعة واحدة أو أقساطاً، ولا يتجاوز عدد الأقساط المعروض مدة الباقة.

الاشتراكالباقة المدفوعة مسبقاً
من جهة iyzicoAPI الاشتراكات ونموذج دفع الاشتراكنموذج الدفع (Checkout Form)
التحصيليحصّل iyzico من البطاقة المحفوظة عند التجديددفعة واحدة أو أقساط
ما يأتي لاحقاًالإلغاء، ترقية الخطة، تحديث البطاقةاسترداد عبر iyzico ضمن حق الانسحاب
ما يصل إلى الخادمإشعارات التجديد وفشل التحصيل والإلغاءنتيجة الدفع، تُقرأ من iyzico مجدداً برمز (token)

لا نفتح الباقة قبل تأكيد الدفع

العمل الحقيقي في المدفوعات الإلكترونية هو كل ما يقع خارج المسار الذي يسير فيه كل شيء على ما يرام. هكذا يتعامل Hippotenus معه:

  • حين يعود المستخدم إلى الموقع بعد الدفع لا نثق بما يقوله المتصفح: يعيد الخادم قراءة الدفعة من iyzico برمز، وإذا لم يتطابق رقم السلة والمبلغ والعملة مع الطلب تماماً لا تُفتح الباقة.
  • إذا أُغلق التبويب أثناء 3D Secure ولم تصل العودة أبداً، تسأل مهمة مجدولة iyzico عن الطلبات غير المكتملة. فإن كان المبلغ قد حُصّل تُفتح الباقة عبر التحقق نفسه، وتُغلق الطلبات غير المدفوعة بعد مدة.
  • تُسجَّل الإشعارات الواردة من iyzico، وإذا وصل الإشعار نفسه مرتين لا تُعاد معالجته.
  • يُنشأ لكل دفعة إيصال PDF يبيّن تفصيل ضريبة القيمة المضافة، وتُقيَّد المبالغ المستردة في سجلات المعاملات نفسها.
  • القسائم وفترات التجربة ومعاينة فرق السعر قبل تغيير الخطة جزء من طبقة الدفع نفسها.

ما نستخدمه في تكامل iyzico

NestJS

واجهة Hippotenus البرمجية. كود الدفع في وحدة فوترة مستقلة، وiyzico يقف خلف واجهة لمزوّد الدفع.

iyzipay

مكتبة iyzico لـ Node.js. تمر عبرها استدعاءات نموذج الدفع والاشتراكات ومعلومات التقسيط والاسترداد.

Prisma وPostgreSQL

تُحفظ الطلبات والمعاملات وأحداث الاشتراك وإشعارات iyzico في جداول منفصلة، فيمكن تتبّع تاريخ أي دفعة لاحقاً.

المهام المجدولة

عبر NestJS Schedule: فحص المدفوعات غير المكتملة، وتذكيرات تجديد الباقات، وتطبيق تغييرات الخطط في موعدها.

لوحة الويب بـ React

يُفتح نموذج الدفع الخاص بـ iyzico مضمّناً داخل لوحة الويب المبنية بـ React.

شاشة اختبار الدفع

في لوحة الإدارة شاشة اختبار تحاكي إشعارات iyzico وتقدّم الوقت لتجربة التجديدات دون انتظار.

كيف يسير مشروع تكامل iyzico

  1. 01

    مكالمة تعريفية مجانية

    30 دقيقة

    نتحدث عمّا تبيعه (دفعة واحدة، تقسيط، اشتراك)، ولمن تبيع، وحالة حسابك لدى iyzico.

  2. 02

    نطاق مكتوب وعرض سعر

    نكتب نموذج الدفع وقواعد الاسترداد والإلغاء واحتياجاتك من الإيصالات والمحاسبة.

  3. 03

    إصدارات أسبوعية

    كل أسبوع تصلك نسخة تجربها في بيئة الاختبار لدى iyzico (sandbox)، وترى بنفسك ببطاقات الاختبار الدفعات الناجحة والمرفوضة والمتروكة.

  4. 04

    الاختبار والانتقال إلى التشغيل

    يختبر مهندس ضمان جودة أول سيناريوهات الدفع قبل الإطلاق، وبعدها فقط ننتقل إلى المفاتيح الحقيقية. وفي Hippotenus إذا استُخدم مفتاح اختبار مع العنوان الحقيقي (أو العكس) يسجّل الخادم ذلك كخطأ عند بدء التشغيل.

  5. 05

    الثلاثون يوماً بعد الإطلاق

    30 يوماً

    نصلح مجاناً الأخطاء التي تظهر في هذه الفترة، وبعدها يمكنك المتابعة بصيانة شهرية.

المدد ونطاقات الميزانية منشورة في صفحتي تطوير تطبيقات الويب والأسعار. حساب iyzico وعقده ملك لشركتك، وأنت من يتفق مع iyzico على العمولة وشروط التسوية.

أسئلة شائعة عن تكامل iyzico

هل تمر بيانات البطاقة عبر خادمكم؟

لا. يُدخل رقم البطاقة في نموذج الدفع الخاص بـ iyzico، ولا يرى خادم Hippotenus إلا نتيجة الدفع والمراجع التي يعيدها iyzico. وبذلك يبقى عبء تخزين بيانات البطاقات وحمايتها على iyzico.

ماذا يحدث إذا فشل تجديد الاشتراك؟

يرسل iyzico إلى الخادم إشعارات التجديد وفشل التحصيل والإلغاء، ويحدّث النظام حالة الاشتراك بناءً عليها. ويستطيع المستخدم تغيير بطاقته عبر نموذج تحديث البطاقة لدى iyzico.

هل يمكنني استخدام iyzico في تطبيق جوال أيضاً؟

في المحتوى الرقمي والاشتراكات المباعة داخل التطبيق تشترط Apple وGoogle أنظمة الدفع الخاصة بهما، وهناك نعمل مع RevenueCat. أما إذا كنت تبيع منتجات مادية أو خدمة تُقدَّم خارج التطبيق فيمكن استخدام iyzico على الجوال أيضاً.

هل يمكنني الانتقال إلى مزوّد دفع آخر لاحقاً؟

نربط كود الدفع بواجهة لمزوّد الدفع لا بـ iyzico مباشرة. وإضافة مزوّد آخر تعني كتابة تنفيذ جديد لهذه الواجهة دون المساس بمنطق الطلبات والإيصالات والاشتراكات. والمزوّد المستخدم في مشاريعنا المنشورة هو iyzico.

خدمات ذات صلة

تطوير تطبيقات الويبتطوير برمجيات مخصصةتكامل ERP وCRMتطوير MVP
تواصل معنا

لنتحدث عن تلقي المدفوعات عبر iyzico

في مكالمة تعريفية مجانية مدتها 30 دقيقة نحدد معاً نموذج الدفع وقواعد الاسترداد واحتياجات الاشتراك لديك.