فهم التدفق

هذه الصفحة تشرح التدفق الحقيقي للعملية قبل الدخول في تفاصيل WordPress أو Custom.

المكونات في التدفق

1. تطبيق الهاتف على موبايل التاجر (مع شريحة الاتصال).
2. خوادمنا (مزود الخدمة/حل الدفع).
3. موقعك (موقع التاجر/المنصة التي يتعامل معها عميلك).

كيف تبدأ العملية؟

1. تطبيق الهاتف يراقب رسائل SMS.
2. عند اكتشاف رسالة تحويل مرتبطة بـ Vodafone Cash أو e & أو InstaPay (تحويلات إلى Vodafone Cash)، يرسل التطبيق بيانات العملية إلى خوادمنا.
3. خوادمنا تحفظ العملية أولاً كحالة pending.

لماذا pending؟ لأننا في هذه اللحظة لا نعرف هل العملية تخص تكامل موقعك أم عملية شخصية خارج التكامل.

كيف تتحول العملية من pending إلى completed؟

1. عميلك يدخل إلى موقعك.
2. يكتب رقم الهاتف والمبلغ الذي أرسله.
3. موقعك يرسل هذه البيانات مع store_id و user_name إلى: GET /api/payment_link_check
4. خوادمنا تبحث عن عملية pending بنفس الرقم ونفس المبلغ.
5. إذا وُجدت مطابقة، تتحول العملية إلى completed.

ماذا يحدث بعد الإكمال؟

بعد التحويل إلى completed:

• خوادمنا تحسب السعر/العملة حسب إعدادات متجرك.
• خوادمنا ترسل GET إلى الـ endpoint الذي ضبطته في إعدادات المتجر.
• موقعك يجب أن يتعامل مع الطلب ويحدث قاعدة البيانات حسب منطقك (شحن رصيد، إكمال طلب، تفعيل خدمة...).

تطبيق الهاتف: من أين تحمّله؟

يمكنك تنزيل تطبيق الهاتف من داخل لوحة حسابك. مكانه: أسفل يسار الشريط الجانبي (sidebar) داخل حساب التاجر.

الخطوة التالية

بعد فهم التدفق:

• إذا موقعك WordPress → انتقل إلى تكامل WordPress.
• إذا تريد بناء تكامل يدوي/مخصص → انتقل إلى التكامل المخصص.