للضيف طريقتان للدفع، وأنت تختار المتاح منهما في اللوحة > إعدادات الشركة > الدفع.
| الطريقة | ماذا يحدث | الحالة بعد الحجز |
|---|---|---|
| ادفع الآن بالبطاقة (ثواني) | يُنقل الضيف إلى صفحة ثواني الآمنة، ويتأكد الحجز حين تخبر ثواني خادمنا أن الدفع نجح | PENDING وUNPAID، ثم CONFIRMED وPAID |
| طلب حجز والدفع عند الوصول | لا دفع عبر الإنترنت. يؤكد المضيف الطلب من اللوحة، ويدفع الضيف في مكان الإقامة | PENDING وUNPAID، ثم CONFIRMED |
في الحالتين تُحجز الليالي فوراً، فلا يستطيع غيره حجزها في هذه الأثناء.
إعداد ثواني
افتح حساب تاجر في ثواني باي (عُمان)، وستحصل على مفتاح سري ومفتاح عام، أولاً لبيئة الاختبار (UAT).
ضعهما في
.env:THAWANI_MODE="uat" THAWANI_SECRET_KEY="..." THAWANI_PUBLISHABLE_KEY="..."أعد التشغيل، ثم فعّل الدفع بالبطاقة في إعدادات الشركة. يجب أن تكون العملة
OMR.جرّب حجزاً ببطاقة الاختبار من ثواني. وحين يعمل كل شيء غيّر
THAWANI_MODEإلىliveمع مفاتيحك الحقيقية.
كيف نتحقق من الدفع بالبطاقة
- يحسب
POST /api/bookingsالسعر على الخادم، ويحفظ الحجز ولياليه، ثم يطلب من ثواني جلسة دفع بالمجموع نفسه بالضبط (src/lib/thawani.ts). - يدفع الضيف في صفحة ثواني، ثم يعود إلى
/api/payments/thawani/return?booking=CODE. - هذا المسار يسأل ثواني هل الجلسة مدفوعة، وعندها فقط يصبح الحجز
PAIDوCONFIRMED. لا نثق بشيء في رابط العودة، فتعديل الرابط لا يؤكد حجزاً. - إذا ألغى الضيف من صفحة ثواني يُلغى الحجز وتُحرَّر لياليه.
- إذا أغلق الضيف الصفحة ببساطة يبقى الحجز غير مدفوع، وتُحرَّر لياليه بعد 30 دقيقة (
HOLD_MINUTESفيsrc/lib/booking-rules.ts).
وإذا تعذّر الوصول إلى ثواني لحظة بدء الحجز يُلغى الحجز فوراً، ويرى الضيف رسالة «تعذّر بدء الدفع بالبطاقة».
الاسترداد والإلغاء
يطلب الضيف الإلغاء من «ابحث عن حجزك»، فيظهر الطلب في النظرة العامة وفي صفحة الحجز. والقرار لك:
- ألغِ الحجز: تُحرَّر الليالي فوراً. ردّ المبلغ من بوابة ثواني، ثم اضغط سجّل كمسترد لتبقى الحسابات صحيحة.
- أبقِ الحجز: يُغلق الطلب ويحتفظ الضيف بلياليه.
مدة الإلغاء المجاني (عدد الأيام قبل الوصول) التي تظهر للضيوف تُضبط من إعدادات الشركة.
الدفع عند الوصول
حين يدفع الضيف في مكان الإقامة افتح الحجز واضغط سجّل كمدفوع. والحجوزات التي تضيفها يدوياً من اللوحة يمكن تسجيلها مدفوعة لحظة إنشائها.
مزوّدو دفع آخرون
كود الدفع صغير ومعزول: src/lib/thawani.ts (إنشاء جلسة وقراءة حالتها) وsrc/app/api/payments/thawani/return/route.ts. لاستخدام مزوّد آخر اكتب الدالتين نفسيهما له، ووجّه مسار الحجز إليهما.