المدفوعات

لاقي أي دفعة، واقرا دورة حياتها كاملة، وردّها، وتتبّع الفلوس لحد تسويتك.

الدفعة هي محاولة واحدة لخصم مبلغ محدّد من عميل، وبتظهر في لوحة التحكم بتاعتك كصف واحد في تبويب المدفوعات وصفحة تفاصيل واحدة. ورا الكواليس، هي عبارة عن Payment IntentAPI بمحاولة ChargeAPI واحدة أو أكتر، بس في لوحة التحكم إنت بتشوف الدفعة بس.

الصفحة دي بتغطّي إزاي تلاقي دفعة، وإيه اللي بيقوله لك كل قسم في صفحة التفاصيل، وإزاي لوحة التحكم بتعرض حالة المبلغ المسترد، وحالات الفشل من المعالِج، والربط بين الدفعة والتسوية اللي صرفت الفلوس.

اللي تقدر تعمله

لاقي أي دفعة بسرعة

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

اقرا دورة الحياة كاملة

خط زمني بيوريك كل خطوة من البداية للتفويض، و3-D Secure، وحركة العميل على تحويل أو قسيمة، والمبالغ المستردة، والتسوية في الآخر.

ردّ المبلغ من نفس الصفحة

اعمل رد كامل أو جزئي من صفحة التفاصيل. حالة المبلغ المسترد بتظهر على نفس صف الدفعة، من غير قائمة منفصلة للمبالغ المستردة.

تتبّع الفلوس للتسوية

كل دفعة ناجحة بتحمل رابط التسوية المرتبطة اللي بيوديك لدفعة التسوية اللي نزلت فيها الفلوس.

لاقي دفعة

اضغط المعاملات في القائمة الجانبية للوحة التحكم. الصفحة بتفتح على تبويب المدفوعات.

بطاقات المؤشرات

فيه تلات إجماليات فوق الجدول، محصورة على الفلاتر اللي طبّقتها:

البطاقة	بتوريك إيه
إجمالي المبيعات	إجمالي الإيراد من الدفعات الظاهرة، شامل المبالغ المستردة ورسوم XPay، المتاح في رصيدك.
صافي المبيعات	اللي ساهمت بيه الدفعات الظاهرة في رصيد XPay بتاعك، بعد خصم رسوم XPay والمبالغ المستردة.
المبالغ المستردة	إجمالي المبالغ المستردة اللي اتعملت على الدفعات الظاهرة.

البحث والفلاتر

خانة البحث بتطابق معرّف الدفعة، ومعرّف العميل، وبريده، واسمه، وتليفونه. شريط الفلاتر فوق الجدول فيه:

الفلتر	بيعمل إيه
الحالة	اختيار متعدّد: ناجحة، فاشلة، مستردة، مستردة جزئياً، وغيرهم.
المبلغ	نطاق أو مقارنة (مثلًا أكبر من، أو بين قيمتين). بعملة التسوية بتاعتك.
التاريخ	نطاق أو فترة نسبية. بيستخدم توقيت متصفّحك.
الدولة	تصفية حسب دولة عنوان IP بتاع العميل وقت الدفع.
المدينة	تصفية حسب المدينة المستخرجة من الـ IP.
الجهاز	موبايل، تابلت، كمبيوتر.
النظام	iOS، وAndroid، وWindows، وmacOS، وغيرهم.
المتصفّح	Chrome، وSafari، وFirefox، وغيرهم.
طريقة الدفع	بطاقة، ڤاليو، فوري، محفظة موبايل.

الأعمدة

العمود	بيوريك إيه
المبلغ	المبلغ بعملة العميل. بيظهر شارة صغيرة ضريبة أو رسوم لما تكون الإعدادات دي مفعّلة؛ مرّر فوق المبلغ علشان تشوف تفصيل الدفعة.
الحالة	شارة ملوّنة. مرّر فوقها علشان تلميح من سطر واحد؛ على فاشلة، التلميح بيحمل سبب الرفض ورابط لصفحة الخطأ المطابقة.
العميل	بريد العميل اللي دفع وتليفونه، مع نقلة لملفه الشخصي.
طريقة الدفع	نوع البطاقة وآخر 4 أرقام، أو ڤاليو، أو فوري، أو معرّف المحفظة.
التاريخ	إمتى اتعملت الدفعة.
الوصف	نص حر على الدفعة، لو متظبّط.
تاريخ الاسترداد	إمتى اتعمل آخر مبلغ مسترد، لو فيه.
سبب فشل المعاملة	سبب قصير وواضح على الصفوف الفاشلة. مرّر فوقه علشان كود الرفض الكامل، وكود الشبكة، ورابط لصفحة الخطأ الصح.

اضغط أي صف علشان تفتح الدفعة.

اقرا دفعة

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

العنوان

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

XPay Intelligence

لوحة من المؤشرات اللي XPay بتستنتجها من الدفعة دي لوحدها، زي شراء متكرر، أو خصم عابر للحدود، أو إعادة محاولة دفع. شوف مؤشرات المعاملات للقائمة الكاملة وإزاي تتصرّف معاها.

الخط الزمني

سجل بترتيب زمني عكسي لكل خطوة في حياة الدفعة. البنود الشائعة:

بدأت الدفعة. لما جلسة الدفع ابتدت.
3-D Secure (نجح، اتحاول، فشل، اتساب). للبطاقات بس.
حركة العميل (نجحت أو اتسابت). لتحويلات الدفع الآجل (BNPL)، وقسايم الأكشاك، وOTP، وتحويلات محافظ الموبايل، والتحويلات البنكية.
مُفوَّضة أو فاشلة. قرار المعالِج على محاولة الخصم. البنود الفاشلة على آخر محاولة بتحمل كود الرفض، وكود رفض الشبكة، ورابط للصفحة المطابقة في أكواد الرفض.
مبلغ مسترد (نجح، معلّق، فشل). بند لكل مبلغ مسترد.
تسوية (مجدولة، في الطريق، مدفوعة، فاشلة، ملغاة). بيتتبّع دفعة التسوية اللي اتخصّصت لها الفلوس.
ملغاة. لما الدفعة اتلغت.

لو فيه محاولات خصم متعددة على نفس الدفعة (عميل بيعيد المحاولة ببطاقة تانية) كلها بتظهر هنا. معلومات الرفض بتاعة آخر محاولة هي اللي بتبقى مفرودة افتراضيًا.

ملخص الدفع

البنود اللي العميل دفع علشانها، مأخوذة من جلسة الدفع اللي عملت الدفعة. مفيدة لما العميل يسأل "أنا اشتريت إيه؟".

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

كتلة في العمود اليمين (بتنزل تحت على الموبايل) بتسرد حقول البيانات الوصفية:

الحقل	بيوريك إيه
العميل	الاسم، والبريد، والتليفون مع نقلة لملفه الشخصي.
رقم العملية	المعرّف `pi_*`، مع نسخ بضغطة واحدة.
طريقة الدفع	البطاقة أو المحفظة المستخدمة.
الوصف	أي حاجة ظبّطها الدمج بتاعك على الدفعة.
التواريخ	إمتى اتعملت الدفعة وإمتى آخر تحديث ليها.

تفصيل الدفعة

الحساب اللي ورا المبلغ. السطور بتظهر بشروط على حسب الإعدادات:

السطر	بيظهر إمتى
دفع العميل + سعر الصرف + مبلغ التسوية	لما العميل يدفع بعملة مختلفة عن عملة التسوية بتاعتك.
مبلغ الدفع	دايمًا. المبلغ الأساسي قبل الضريبة والرسوم.
ضريبة القيمة المضافة (X%)	لما يكون تحصيل الضريبة مفعّل على الدفعة دي.
رسوم معالجة XPay (يدفعها العميل)	لما يكون تمرير الرسوم مفعّل. بتزيد إجمالي العميل.
إجمالي المبلغ المحصل من العميل	لما يكون تحصيل الضريبة أو تمرير الرسوم مفعّل.
رسوم معالجة XPay (مخصومة)	لما يكون تمرير الرسوم مفعّل. المبلغ اللي XPay بتخصمه.
رسوم المعالجة	لما يكون تمرير الرسوم متوقّف. رسوم XPay الثابتة المأخوذة من تسويتك.
المبلغ المسترد	لما يكون اتعمل أي مبلغ مسترد.
صافي المبلغ	دايمًا. اللي ساهمت بيه الدفعة في رصيدك في الآخر.

التسوية المرتبطة

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

تفاصيل طريقة الدفع

لدفعات البطاقات: النوع، والرقم المخفي، والبصمة، والصلاحية، ودولة الإصدار، ونوع التمويل (ائتمان، خصم مباشر، مدفوع مقدّم)، ونتيجة 3D Secure. لڤاليو، وفوري، والمحافظ: المعرّفات المناسبة (رقم القرض، مرجع القسيمة، معرّف المحفظة).

معلومات العميل والجهاز

الموقع الجغرافي، والـ IP، والمتصفّح، ونظام التشغيل، ونوع الجهاز وقت الدفع. مفيدة لما تربطها بمؤشرات عدم تطابق بلد البطاقة أو أجهزة متعددة على ملف العميل.

المعاملات المرتبطة

دفعات تانية لنفس العميل، بحالتها ومبلغها. اضغط أي واحدة علشان تنتقل لها.

الحالات

كل دفعة بتحمل حالة. اللي هتقابلها أكتر حاجة:

الحالة	معناها إيه
ناجحة	الدفعة اتفوّضت واتحصّلت. الفلوس في الطابور للتسوية.
مستردة جزئياً	اتعمل مبلغ مسترد واحد على الأقل، بس المبلغ الكامل لسه ما اتردّش.
مستردة	المبلغ المُحصّل الكامل اتردّ.
فاشلة	المعالِج رفض الخصم. مرّر فوق الشارة في القائمة، أو افتح الدفعة، علشان تشوف سبب الرفض.
معلقة	الدفعة لسه شغّالة. شائعة لقسايم الأكشاك، وتحويلات الدفع الآجل، والتحويلات البنكية اللي مستنية تأكيد.
يتطلب إجراء	العميل محتاج يكمّل خطوة، زي تحدّي 3-D Secure أو دفع قسيمة.
ملغاة	الدفعة اتلغت قبل ما تكتمل.
باطلة	دفعة مفوَّضة اتفرج عنها من غير تحصيل.
منتهية الصلاحية	الدفعة انتهى وقتها من غير ما العميل يكمّلها.

فيه شوية حالات إضافية (زي يتطلب تأكيد ويتطلب طريقة دفع) بتظهر بس على دفعة لسه في نص الإنشاء. عرض القائمة بيدمج دول في أقرب حالة ليها معنى للمستخدم.

ردّ دفعة

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

الزرار بيختفي لما الدفعة ما تكونش قابلة للرد: لسه ما اتحصّلتش، أو اتردّت بالكامل خلاص، أو على طريقة دفع ما بتدعمش الرد، أو تحت احتجاز مخاطر.

شوف المبالغ المستردة للمسار الكامل، وقواعد الرد الجزئي، واللي بيظهر فين.

شارة "محتجزة"

أحيانًا بتحمل الدفعة شارة محتجزة في العنوان. دي مراجعة مخاطر مؤقتة من XPay: الفلوس المُحصّلة بتتجمّد، وزرار ردّ المبلغ بيختفي لحد ما المراجعة تتقفل. الاحتجازات بيحطّها ويفرج عنها فريق المخاطر في XPay. اتواصل مع الدعم لو محتاج توضيح بخصوص احتجاز معيّن.