المبالغ المستردة

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

الـ RefundAPI بيرجّع فلوس حصّلتها من عميل لطريقة الدفع الأصلية بتاعته. لوحة التحكم مفيهاش صفحة منفصلة اسمها "المبالغ المستردة". بدل كده، كل مبلغ مسترد بيعيش على الدفعة اللي جه منها، والسجل الجاري لكل المبالغ المستردة موجود في تبويب كل النشاط في المعاملات.

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

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

ردّ أي دفعة محصّلة

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

حدّد سبب

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

تتبّع كل مبلغ مسترد

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

شوف الأثر على رصيدك

كل مبلغ مسترد هو بند في الرصيد بيقلّل رصيدك المتاح. وبيتعدّل كمان إجمالي إنفاق العميل تلقائيًا.

اعمل ردّ مبلغ

افتح الدفعة

في المعاملات، لاقي الدفعة اللي عايز تردّها واضغط عليها. صفحة التفاصيل بتفتح.

اضغط ردّ المبلغ

فوق على اليمين في العنوان، اضغط ردّ المبلغ. هيفتح لوح جانبي عنوانه ردّ الدفعة.

لو مش شايف زرار ردّ المبلغ، شوف إمتى الزرار بيختفي أو بيتعطّل تحت.

حدّد المبلغ

خانة المبلغ بتبقى مملّية مسبقًا بقيمة المتاح للرد اللي تحت اللوح (المبلغ المُحصّل الأصلي ناقص أي حاجة ردّيتها قبل كده).

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

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

(اختياري) اختار سبب

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

قدّم

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

إمتى الزرار بيختفي أو بيتعطّل

لوحة التحكم بتخفي أو بتعطّل زرار ردّ المبلغ لما الرد ما يقدرش يتم.

بيختفي لما تكون الدفعة مش في حالة قابلة للرد:

السبب	ليه
الحالة مش ناجحة ولا مستردة جزئيًا	الدفعات الفاشلة، والملغاة، والمنتهية، والمعلّقة مفيهاش فلوس محصّلة علشان تتردّ.
الدفعة لسه ما اتحصّلتش	مفوَّضة بس ما اتحصّلتش: لسه مفيش خصم علشان يتعكس.
الدفعة اتردّت بالكامل خلاص	مفيش حاجة فاضلة علشان تتردّ.
طريقة الدفع ما بتدعمش الرد	فيه معالِجات وطرق بتوجّه الرد خارج النظام. الزرار بيختفي لما XPay ما تقدرش تعمل الرد مباشرة.

بيتعطّل مع تلميح لما يكون عندك نقص صلاحيات أو فيه احتجاز:

التلميح	ليه
"ليس لديك صلاحية لتنفيذ هذا الإجراء"	صلاحيتك مفيهاش إذن كتابة الرد. اطلب من مسؤول الحساب يديك الإذن.
"هذا الخصم تحت احتجاز مخاطر نشِط حاليًا..."	فيه احتجاز مخاطر على الفلوس. اتواصل مع الدعم علشان يفرج عن الاحتجاز قبل الرد.

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

"لا يمكن رد هذا الخصم في حالته الحالية."
"مبلغ الرد غير صالح أو يتجاوز المبلغ القابل للرد."
"رصيد التاجر غير كافٍ لمعالجة هذا الرد."

بيحصل إيه بعدين

التوقيت. المبالغ المستردة بتاخد من 7 لـ 14 يوم علشان تظهر على كشف حساب العميل. لوحة التحكم بتعكس الرد على طول؛ بنك العميل بياخد وقت أطول.

الرسوم. رسوم XPay على الدفعة الأصلية مش بترجع مع الرد، بس XPay مش بتاخد رسوم إضافية فوق الرد نفسه.

الوجهة. المبالغ المستردة دايمًا بترجع لطريقة الدفع الأصلية. مفيش طريقة توجّه الرد لبطاقة أو حساب تاني.

سجل العميل. إجمالي إنفاق العميل في ملفه بيتحدّث: إجمالي المسترد بيزيد، وصافي الإنفاق بيقل. أما إجمالي المنفَق (الإجمالي) فبيفضل زي ما هو كسجل تاريخي لكل ما اتخصم منه.

حالة الرد بتظهر فين

عبر لوحة التحكم، المبلغ المسترد بيبان في سبع أماكن:

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

لو مشترك كمان في webhooks، المبلغ المسترد بيطلق refund.created، وrefund.failed لو البنك رفضه. شوف المبالغ المستردة للجانب التقني المصاحب (حقول الحالة، وكائن Refund، والتعامل مع الـ webhook).

أسباب الرد

لوحة التحكم بتقدّم تلات أكواد أسباب لما تعمل رد. اختيارية، والنص الحر مش مدعوم.

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

الأسباب بتظهر على بند الخط الزمني وعلى كائن Refund في ردود الـ API وحمولات الـ webhook.