كيفية إنشاء Check Form

هذا الدليل يشرح كيف تنشئ نموذجًا في موقعك يطلب بيانات العميل ثم يستدعي:

GET /api/payment_link_check

ما الذي يجمعه النموذج؟

الحد الأدنى:

• phone: رقم الهاتف الذي أرسل التحويل
• amount: المبلغ

ويُرسل أيضًا:

• user_name: اسم المستخدم داخل موقعك
• store_id: رقم متجرك في نظامنا
• lang: ar أو en

شكل الطلب

GET /api/payment_link_check?phone=01000000000&amount=100&user_name=customer_001&store_id=2&lang=ar

حسب التنفيذ الحالي، هذا endpoint لا يتطلب Authorization: Bearer.

مثال Frontend (JavaScript)

const params = new URLSearchParams({
  phone,
  amount,
  user_name,
  store_id,
  lang: 'ar',
})

const res = await fetch(`/api/payment_link_check?${params.toString()}`)
const body = await res.json()

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

نجاح

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

الإجراء:

• اعرض نجاح الدفع.
• كمل منطقك التجاري في موقعك.

فشل عادي (لا توجد مطابقة)

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

الإجراء:

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

حالة Anti‑Spam (waiting-for-approval)

{
  "status": false,
  "requires_verification": true,
  "pending_verification": true,
  "flow_state": "waiting-for-approval"
}

الإجراء:

• اعرض للمستخدم أن الطلب قيد المراجعة.
• لا تعتبر العملية فاشلة نهائيًا.
• اطلب المحاولة لاحقًا بعد الموافقة اليدوية.