كاشير (Kashier)
كاشير هي بوابة البطاقات الأساسية في TakeTheme لمصر. يدفع المشترون على صفحة كاشير المستضافة ثم يعودون إلى متجرك.
التكامل للبطاقات فقط وبتحصيل تلقائي — تُسحب الأموال فور إتمام المشتري للدفع، دون خطوة تحصيل منفصلة.
الربط
الإعدادات ← المدفوعات ← كاشير.
| البيانات | مطلوبة | من أين تحصل عليها |
|---|---|---|
| مفتاح API | نعم | لوحة تحكم كاشير ← مفاتيح API |
| معرّف التاجر (MID) | نعم | لوحة تحكم كاشير |
يُحفظ الاثنان لمتجرك وحده. ومفتاح API هو نفسه ما تستخدمه TakeTheme للتحقق من الويب هوك الوارد، لذا يجب أن يبقى متطابقًا مع كاشير — فتغييره هناك دون تحديثه هنا سيؤدي إلى رفض كل تأكيدات الدفع.
الإعدادات
| الإعداد | الافتراضي | الوظيفة |
|---|---|---|
| إرسال بريد تأكيد الدفع | مفعّل | يرسل بريدًا للعميل عند نجاح الدفع |
| التنبيه عند فشل الدفع (عناوين بريد) | فارغ | يرسل بريدًا لهذه العناوين عند فشل عملية دفع لدى البوابة |
| تعليم الطلبات كمدفوعة تلقائيًا | مفعّل | غير مُفعَّل حاليًا — أي دفع مؤكَّد يجعل الطلب مدفوعًا على أي حال |
ما يراه المشتري
- يختار كاشير عند إتمام الشراء ويؤكد.
- تُنشئ TakeTheme جلسة دفع موقّعة لدى كاشير بالمبلغ والعملة تحديدًا، وتحوّله إلى الصفحة المستضافة.
- يدفع بالبطاقة.
- تستدعي كاشير الويب هوك، ويُنشأ الطلب في هذه اللحظة وهو مدفوع بالفعل.
- يعود إلى صفحة نجاح الطلب في متجرك.
الصفحة المستضافة تظهر بـالعربية افتراضيًا وبلون علامتك التجارية.
إذا ترك المشتري صفحة كاشير دون دفع، فلن يُنشأ شيء — وتظهر المحاولة ضمن السلات المتروكة. راجع كيف تعمل المدفوعات.
الويب هوك
ترسل كاشير نتائج ا لدفع إلى:
POST https://<your-api-host>/api/v1/payment/webhook/kashier
يُسجَّل هذا العنوان تلقائيًا مع كل جلسة دفع — لا يوجد ما تضبطه في لوحة تحكم كاشير.
كل ويب هوك يُتحقق من توقيعه مقابل مفتاح API المحفوظ. وأي استدعاء غير موقّع أو بتوقيع غير مطابق يُرفض بالرمز 400 ولا يُسجَّل شيء.
تعيد كاشير المحاولة حتى تستقبل استجابة 200. وأي إعادة إرسال لعملية دفع مسجّلة كناجحة تُقبل وتُتجاهل، فلا يمكن أن تُنشئ طلبًا ثانيًا أو تُضاعف الإيراد.
الاسترداد
يُسجَّل الاسترداد في TakeTheme فقط — ولا يُرسَل أي طلب استرداد إلى كاشير. نفّذ الاسترداد من لوحة تحكم كاشير ثم سجّله على الطلب حتى تتطابق تقاريرك. راجع الاسترداد.
حل المشكلات
كل عمليات الدفع تفشل في التأكيد بعد تغيير مفتاح API.
المفتاح المحفوظ يُستخدم للتحقق من الويب هوك. حدّثه في الإعدادات ← المدفوعات ← كاشير وأعد كتابته كاملًا — فالقيم المقنّعة (••••1234) تُتجاهل عند الحفظ.
دفع المشتري ولم يظهر أي طلب. إما أن الويب هوك لم يصل أو فشل التحقق منه. يستطيع الدعم مراجعة سجل الويب هوك الوارد برقم العملية لدى كاشير.
المبلغ في كاشير لا يطابق سلة الشراء. الجلسة موقّعة على الإجمالي الكامل شاملًا الشحن والضريبة وأي رسوم مناولة. عدم التطابق يعني أن السلة تغيّرت بعد إنشاء الجلسة — على المشتري العودة إلى صفحة الشراء والبدء من جديد.