Skip to content

ما هي هذه الخدمة؟

نحن خدمة تكامل مدفوعات تساعد موقعك على استقبال وتحويلات الدفع (Vodafone Cash / e & / InstaPay إلى Vodafone Cash) ثم ربطها تلقائيًا بمنطق عملك داخل موقعك.

بمعنى أبسط:

  • عميلك يحوّل مبلغ.
  • نظامنا يلتقط العملية من تطبيق الهاتف.
  • موقعك يطلب التحقق.
  • عند المطابقة، يتم تأكيد الدفع وتستلم موقعك إشعار الإكمال.

لمن هذه الخدمة؟

هذه الخدمة مناسبة إذا لديك:

  • متجر إلكتروني
  • منصة شحن رصيد / محافظ
  • موقع خدمات مدفوعة

وتريد ربط تحويلات الدفع بحسابات العملاء أو الطلبات داخل نظامك.

مخطط مبسط للتدفق (Pseudo Diagram)

text
[Customer sends transfer]
          |
          v
[Mobile App on tenant phone reads SMS]
          |
          v
[Our Server stores transaction as PENDING]
          |
          v
[Customer opens your website and submits phone + amount]
          |
          v
[Your website calls /api/payment_link_check]
          |
          v
   [Match found?]
        |
   _ _ _ _ _  _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
  |                                         |
  Yes                                      No
  |                                         |
  v                                         v
[PENDING -> COMPLETED]   [Return failure to your website]
  |
  v
[Our Server sends GET callback to your configured endpoint]
  |
  v
[Your website updates DB (balance/order/service)]

شرح المخطط خطوة بخطوة

  1. تطبيق الهاتف (على موبايل التاجر) يراقب رسائل SMS.
  2. عند اكتشاف تحويل مناسب، يرسل البيانات إلى خوادمنا.
  3. خوادمنا تحفظ العملية كـ pending (قبل أي تأكيد).
  4. العميل يدخل موقعك ويرسل رقم الهاتف + المبلغ.
  5. موقعك يستدعي payment_link_check.
  6. إذا وُجدت عملية pending مطابقة (نفس الرقم + المبلغ) تتحول إلى completed.
  7. بعدها نرسل طلب GET إلى endpoint موقعك (المضبوط في إعدادات المتجر).
  8. موقعك ينفذ الإجراء المطلوب في قاعدة البيانات.

المصطلحات الأساسية (Very Quick Glossary)

  • Store: ملف إعدادات التكامل الخاص بك.
  • store_id: رقم المتجر داخل نظامنا.
  • API Token: مفتاح الأمان لمكالمات API.
  • payment_link_check: endpoint التحقق والمطابقة.
  • callback endpoint: الرابط في موقعك الذي يستقبل طلب الإكمال منا.

كيف أبدأ من الصفر؟

رتّب القراءة بهذا الترتيب:

  1. إعداد المتجر
  2. فهم التدفق
  3. اختر طريقة التكامل:
    • تكامل WordPress
    • التكامل المخصص