تكامل WordPress

قبل البدء

أكمل أولاً:

1. إعداد المتجر
2. فهم التدفق

هذا المسار مناسب إذا كان موقعك يعمل على WordPress وتريد التكامل بأقل تطوير ممكن.

الإضافة الرسمية (موصى بها)

الإضافة مُدارة على GitHub: ibrahim317/vodafoncash-wordpress-plugin.

1. افتح صفحة Releases وحمّل أحدث ملف .zip مرفق بالإصدار (هذا هو الملف الذي ترفعه إلى ووردبريس).
2. من لوحة ووردبريس اذهب إلى الإضافات → أضف جديدًا → رفع إضافة، اختر الملف، ثم فعّل VodafoneCash Integration.

فكرة التكامل على WordPress

داخل موقع WordPress ستنشئ/تستخدم نموذج دفع يجمع:

• رقم الهاتف
• المبلغ

ثم يستدعي:

GET /api/payment_link_check?phone=...&amount=...&user_name=...&store_id=...&lang=ar

التعامل مع الردود داخل WordPress

نجاح

{
  "status": true,
  "requires_verification": false
}

الإجراء داخل موقعك:

• اعرض نجاح الدفع.
• نفّذ الإجراء التجاري المطلوب (رصيد/طلب/اشتراك...).

فشل أو عدم مطابقة

{
  "status": false,
  "message": "لم يتم العثور على عملية مطابقة"
}

الإجراء داخل موقعك:

• اعرض رسالة واضحة.
• اسمح بإعادة المحاولة.

إعداد المتجر في لوحة المستأجر

عند اختيار نوع الموقع → WordPress في إعدادات المتجر يظهر رابط لهذا الدليل، ويُعبأ حقل API URL تلقائيًا بشكل https://example.com/wp-json/vodafoncash/v1/callback إذا كان الحقل فارغًا (استبدل example.com بنطاقك أو الصق الرابط من إعدادات الإضافة). يمكنك أيضًا استخدام نوع Custom بنفس الرابط؛ العقد مع الخادم واحد.

Endpoint الاستقبال في موقع WordPress

عند اكتمال المطابقة لدينا، نظامنا يرسل GET إلى endpoint قمت بتكوينه في إعدادات المتجر.

تأكد أن endpoint في WordPress:

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

Anti‑Spam (يظهر هنا فقط بعد فهم التكامل الأساسي)

عند تفعيل Anti‑Spam:

• أول عملية من رقم جديد (أو رقم في blacklist) قد تظهر كـ waiting-for-approval.
• endpoint /api/payment_link_check قد يرجع requires_verification: true.
• في هذه الحالة، يجب على صاحب المتجر الدخول إلى vodafoncash.com والموافقة يدويًا.

مثال رد:

{
  "status": false,
  "requires_verification": true,
  "pending_verification": true,
  "flow_state": "waiting-for-approval",
  "message": "هذه العملية بانتظار موافقة يدوية."
}

موقع WordPress يجب أن يتعامل مع هذه الحالة برسالة مناسبة للمستخدم (مثال: "العملية قيد المراجعة، حاول لاحقًا").