إعداد المتجر (للمبتدئين)

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

قبل كل شيء: أنشئ حسابك

1. ادخل إلى vodafoncash.com.
2. أنشئ حساب جديد (Sign up).
3. فعّل الحساب وسجّل الدخول.

بعد تسجيل الدخول، يصبح لديك حساب تاجر يمكنك من خلاله إنشاء متجر وربطه بموقعك.

ما هو المتجر (Store)؟

المتجر هو الإعداد الرئيسي الذي يربط:

• موقعك/نظامك
• عملتك وسعر التحويل
• endpoint الاستقبال في موقعك
• مفاتيح التكامل (مثل store_id و API Token)

ما هو store_id؟

store_id هو رقم تعريف المتجر الخاص بك داخل نظامنا. موقعك يرسله مع طلبات التحقق حتى يعرف نظامنا لأي متجر تنتمي العملية.

ببساطة: بدون store_id صحيح، التحقق لن يعمل كما يجب.

ما هو API Token؟ وكيف تنشئه؟

API Token هو مفتاح أمان يُستخدم في تحقق/تفويض طلبات callback أو ربطات المزود حسب إعدادات متجرك.

الفكرة: عند استلام موقعك طلب الإكمال من نظامنا، أو عند التكامل مع مزود خارجي، تستخدم هذا المفتاح لتأكيد أن الطلب موثوق ومسموح.

الخطوات:

1. من لوحة حسابك افتح إعدادات التكامل/API.
2. أنشئ Token جديد.
3. احفظه بشكل آمن (لا تضعه في الواجهة الأمامية للمتصفح).

طريقة الإرسال الدقيقة تعتمد على نوع التكامل/المزود (قد تكون header أو query parameter).

ما هو payment_link_check؟

payment_link_check هو endpoint التحقق الأساسي في النظام.

وظيفته:

• يأخذ من موقعك phone + amount + store_id + user_name.
• يبحث في العمليات التي وصلت من تطبيق الهاتف.
• إذا وجد تطابقًا، يحوّل العملية من pending إلى completed.

مثال الطلب:

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

نوع الموقع: WordPress

إذا كان موقعك يعمل على WordPress مع إضافتنا الرسمية، اختر نوع الموقع → WordPress عند إنشاء المتجر أو تعديله:

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

نوع WordPress يستخدم نفس طلب الإكمال مثل Custom (GET مع key وaction=addPayment وغيرها)؛ الفرق في الواجهة فقط لتوجيهك للوثائق والرابط الافتراضي المناسب.

إعدادات المتجر التي يجب إكمالها

داخل إعدادات متجرك تأكد من ضبط:

• بيانات المتجر الأساسية.
• store_id.
• API Token.
• Callback endpoint في موقعك (العنوان الذي يستقبل طلباتنا بعد إكمال العملية) — راجع الدليل: كيفية إنشاء Callback Endpoint.
• إعدادات العملة وسعر التحويل.

Checklist سريع قبل الانتقال

قبل الانتقال إلى فهم التدفق تأكد أن لديك:

• حساب فعّال على vodafoncash.com
• متجر مُنشأ
• store_id
• API Token
• Callback endpoint جاهز في موقعك (راجع: كيفية إنشاء Callback Endpoint)