طلبات بوابة الدفع¶

الغرض¶

تمنحك صفحة طلبات بوابة الدفع رؤية كاملة لكل طلب دفع يرسله متجرك إلى مزوّد الدفع (مثل: Geidea، Paymob، Moyasar، Fawry، Tabby، Ziina وغيرها). استخدمها لتتبّع المدفوعات المتعثّرة، والتواصل مع دعم مزوّد الدفع، والبحث عن معرّفات المعاملات الخاصة بكل مزوّد.

يمثّل كل صف في القائمة محاولة دفع واحدة بدأها متجرك — سواءً نجحت أو فشلت أو أُلغيت أو ما زالت قيد الانتظار.

متى تستخدم هذه الصفحة¶

عندما يطلب منك مزوّد الدفع (مثل Geidea) مشاركة معرّف معاملة تجريبية لتفعيل حسابك في بيئة الإنتاج.
عندما يُبلّغك عميل أنه دفع، لكن حالة الطلب لا تزال "بانتظار الدفع".
عندما لا يظهر استرداد أجريته على لوحة تحكّم مزوّد الدفع وتريد معرفة ما تم إرجاعه بالضبط.
عند إعداد طريقة دفع جديدة، للتأكد من استلام الاستدعاءات (callbacks) من المزوّد بشكل صحيح.

الوصول إلى طلبات بوابة الدفع¶

انقر على الأقسام ← الطلبات والمبيعات ← طلبات بوابة الدفع

لتضييق القائمة على طلب معيّن، استخدم البحث برمز الطلب أو بريد العميل، أو عوامل التصفية حسب الحالة وطريقة الدفع.

عرض القائمة¶

قائمة طلبات بوابة الدفع

تعرض القائمة صفاً واحداً لكل محاولة دفع، مرتّبةً من الأحدث إلى الأقدم.

أعمدة الجدول¶

رمز الطلب¶

التنسيق: نص (مثل PO-IA8LXMD6OR)
الغرض: المرجع الفريد الذي أرسله متجرك إلى مزوّد الدفع. يسجّله معظم المزوّدين باسم المرجع التجاري (merchantReferenceId) أو رمز الطلب. هذا هو المرجع الذي تشاركه مع دعم المزوّد عندما يسألك عن الطلب.
تلميح: يمكن نسخ القيمة — مرّر الماوس لإظهار أيقونة النسخ.

طريقة الدفع¶

التنسيق: نص (مثل Geidea، Paymob، Moyasar)
الغرض: طريقة الدفع المهيّأة التي عالجت هذه المحاولة.

الحالة¶

التنسيق: شارة ملوّنة
القيم:
قيد الانتظار — تم إنشاء طلب الدفع لكن المزوّد لم يُبلّغ عن النتيجة النهائية بعد.
مكتمل — أكّد المزوّد أن الدفع تم بنجاح.
فشل — رفض المزوّد الدفع أو تعذّر إكماله.
ملغى — ألغى العميل الدفع أو انتهت صلاحية الجلسة.

تم الإرجاع¶

التنسيق: شارة (نعم / لا)
الغرض: تُشير إلى ما إذا كان قد تمّ استرداد مبلغ هذه المعاملة لاحقاً.

المبلغ¶

التنسيق: رقم مع رمز العملة (مثال: 125.00 SAR)
الغرض: المبلغ الذي تم سحبه من العميل.

معرّف المعاملة الخارجي¶

التنسيق: نص قابل للنسخ
الغرض: معرّف المعاملة الذي أعاده المزوّد (غالباً يُسمّى transactionId، payment_id، invoice_id… إلخ). استخدمه عندما يطلب منك المزوّد معرّفه الداخلي.

البريد الإلكتروني للعميل¶

التنسيق: نص (عمود قابل للإخفاء)
الغرض: بريد العميل الذي بدأ عملية الدفع.

تاريخ الدفع¶

التنسيق: تاريخ ووقت
الغرض: وقت تأكيد الدفع. يبقى فارغاً لمحاولات الدفع المعلّقة أو الفاشلة أو الملغاة.

تاريخ الإنشاء¶

التنسيق: تاريخ ووقت
الغرض: وقت بدء محاولة الدفع.

عوامل التصفية¶

الحالة — قصر القائمة على طلبات قيد الانتظار أو مكتملة أو فاشلة أو ملغاة.
طريقة الدفع — عرض مدفوعات مزوّد محدد فقط.
تم الإرجاع — مفتاح تبديل لعرض المدفوعات المستردة فقط.
البحث — اكتب في مربع البحث لإيجاد المدفوعات برمز الطلب أو معرّف المعاملة الخارجي أو بريد العميل.

إجراءات الصف¶

عرض — فتح التفاصيل الكاملة للدفع، بما في ذلك جميع معرّفات المزوّد والبيانات الخام للاستجابة.

تم تعطيل الإنشاء والتعديل والحذف عن قصد — فهذه صفحة عرض للتدقيق فقط. يتم تسجيل السجلات تلقائياً من قبل المتجر عند بدء أي محاولة دفع.

عرض طلب بوابة الدفع¶

عرض طلب بوابة الدفع

انقر على أي صف لفتح صفحة تفاصيله. تم تنظيم التفاصيل في عدة أقسام.

الملخص¶

يعرض القسم العلوي الحقائق الأساسية للدفع:

رمز الطلب — المرجع التجاري المُرسَل إلى المزوّد (قابل للنسخ).
الحالة — شارة الحالة الحالية.
تم الإرجاع — ما إذا كانت المعاملة قد استُردّت.
المبلغ — المبلغ المُحصّل مع العملة.
طريقة الدفع — المزوّد الذي عالج عملية الدفع.
معرّف المعاملة الخارجي — معرّف المزوّد الخاص (قابل للنسخ).
تاريخ الدفع — وقت تأكيد الدفع.
تاريخ الإنشاء — وقت بدء المحاولة.
الوصف — الوصف المترجم الذي أُرسل إلى المزوّد (مثال: "دفعة للطلب رقم 42").

العميل¶

الاسم والبريد الإلكتروني والهاتف — بيانات التواصل مع العميل الذي بدأ الدفع. البريد والهاتف قابلان للنسخ.
بيانات العميل — كتلة JSON تحتوي على معلومات إضافية يُرسلها المتجر (مثل المعرّف الداخلي order_id). الكتلة كاملة قابلة للنسخ لإلصاقها في تذكرة دعم.

بيانات مزوّد الدفع¶

هذا أهم قسم عند تتبع المشكلات. يظهر كل مفتاح أعاده المزوّد كصف منفصل مع زر نسخ. المفاتيح الشائعة:

Geidea: geidea_order_id، geidea_session_id، geidea_merchant_reference_id، geidea_status، geidea_detailed_status
Fawry: fawry_reference_number، fawry_merchant_ref
Ziina: ziina_payment_intent_id
Thawani: thawani_session_id
MyFatoorah: myfatoorah_invoice_id
مفاتيح عامة: transaction_id، status، message، original_amount، payment_method_fee

إذا أعاد المزوّد قيمة غير مُدرجة هنا، انتقل إلى أسفل القسم إلى بيانات الدفع الخام (JSON) — فهي تحتوي على الاستجابة الكاملة، منسّقة وقابلة للنسخ.

تلميح: عندما يطلب منك وكيل دعم المزوّد معرّف الطلب الخاص به (مثال: يطلب Geidea orderId لمعاملة تجريبية)، انسخ القيمة من صف Geidea Order Id في هذا القسم.

بيانات الاسترداد¶

تظهر فقط عند استرداد المعاملة. تحتوي على استجابة الاسترداد من المزوّد (معرّف معاملة الاسترداد، المبلغ المستردّ، المعرّف الأصلي، والبيانات الخام للاسترداد).

الاستدعاءات والروابط¶

مطوي افتراضياً — افتحه لرؤية:

رابط النجاح / رابط الفشل — حيث يُعاد توجيه العميل بعد معالجة المزوّد.
استدعاء النجاح / استدعاء الفشل — الخطّافات الداخلية التي تعمل على الخادم عند استلام الاستدعاء.

مفيدة في أغلب الأحيان لتشخيص سبب ظهور صفحة خاطئة للعميل بعد الدفع، أو لماذا لم يتم تحديث حالة الطلب تلقائياً.

الإضافات المتجاهلة¶

نادراً ما تظهر. تُعرض فقط إذا تم استثناء إضافات محدّدة من معالجة محاولة الدفع هذه.

إجراءات رأس الصفحة¶

عودة إلى القائمة — يُعيدك إلى القائمة.
عرض الطلب المرتبط — عندما تكون محاولة الدفع مرتبطة بطلب متجر (عبر customer_data.order_id)، يفتح هذا الزر صفحة الطلب المرتبط مباشرةً.

معلومات أساسية¶

قراءة فقط: لا يمكنك إنشاء أو تعديل أو حذف طلبات بوابة الدفع من هذه الصفحة — فهي تُنشأ تلقائياً من قِبل دفق الدفع.
متاحة للمدير الأعلى فقط: افتراضياً، يراها المدير الأعلى فقط. قد تحتوي البيانات على تفاصيل تواصل العميل ومعرّفات المزوّد، لذا تُحمى بصلاحية.
صف واحد لكل محاولة: كل صف يمثّل محاولة واحدة. إذا أعاد العميل المحاولة بعد فشل، تُضاف صفوف جديدة مرتبطة بنفس الطلب.
مرتبطة بالطلبات: إذا بدأ الدفع من طلب متجر (الحالة الشائعة)، فسيحتوي قسم "بيانات العميل" على order_id، ويعرض رأس الصفحة اختصاراً إلى الطلب المرتبط.
لا تشارك JSON الخام خارجياً دون مراجعة: قد تحتوي الحمولة الخام على معلومات لا يرغب المزوّد بكشفها علناً (رموز الجلسات، التواقيع).

الطلبات والمبيعات — طلبات المتجر ومدفوعاتها.
طرق الدفع — تهيئة بوابات الدفع التي تنشئ طلبات بوابة الدفع هذه.
طرق الدفع غير المتصلة — التحويل البنكي والطرق اليدوية الأخرى.