طرق الدفع
فعّلها أو أوقفها من اللوحة > الإعدادات > الدفع:
| الطريقة | كيف تعمل | متى يُعلَّم الطلب مدفوعاً |
|---|---|---|
| نقداً | يدفع الزبون عند الاستلام أو التوصيل أو على الطاولة | يعلّمه الموظف بزر تم استلام النقد في لوحة المطبخ |
| بطاقة (ثواني) | يدفع الزبون في صفحة ثواني الآمنة قبل أن يبدأ المطبخ | تلقائياً بعد تأكيد ثواني |
يجب أن تبقى طريقة واحدة على الأقل مفعّلة، وإلا لن يستطيع الزبائن الطلب.
إعداد ثواني
افتح حساب تاجر في ثواني واحصل من بوابة التاجر على زوجي مفاتيح: UAT (تجريبي) والإنتاج.
في
.env:THAWANI_MODE="uat" THAWANI_SECRET_KEY="المفتاح السري التجريبي" THAWANI_PUBLISHABLE_KEY="المفتاح العام التجريبي" SITE_URL="https://order.your-restaurant.com"أعد التشغيل، ثم فعّل الدفع بالبطاقة (ثواني) في اللوحة > الإعدادات. ستعرض صفحة الإعدادات «مفاتيح ثواني مضبوطة (uat)».
جرّب طلباً بالبطاقات التجريبية التي توفرها ثواني. عندما ينجح، ضع مفاتيح الإنتاج واضبط
THAWANI_MODE="live".
الدفع بالبطاقة يتطلب أن تكون العملة OMR (ثواني يحصّل بالريال)، وألا يقل إجمالي الطلب عن 0.100 ريال.
ماذا يحدث أثناء الدفع بالبطاقة
- ترسل صفحة الطلب الطلبَ إلى
POST /api/ordersمعpaymentMethod: "CARD". يحسب الخادم السعر من قاعدة البيانات، ويحفظ الطلب «غير مدفوع»، ويطلب من ثواني جلسة دفع بالإجمالي. - يُنقل الزبون إلى صفحة الدفع في ثواني.
- يعيد ثواني الزبون إلى
/api/payments/thawani/return?order=<الرمز>. - يسأل هذا المسار ثواني عن حالة الجلسة. لا يصبح الطلب «مدفوعاً» إلا عندما يجيب ثواني بأنه مدفوع، ولا يُعتمد على أي شيء في رابط العودة.
- يصل الزبون إلى صفحة تتبع الطلب.
إن ألغى الزبون في صفحة ثواني يُلغى الطلب ويبقى غير مدفوع. وإن تعذّر الوصول إلى ثواني عند الطلب يُلغى الطلب فوراً ويُطلب من الزبون المحاولة مجدداً أو الدفع نقداً.
إن أغلق الزبون المتصفح قبل العودة يبقى الطلب «غير مدفوع»، وتعرض صفحة التتبع «بانتظار تأكيد الدفع من ثواني». تحقّق منه في بوابة التاجر (معرّف الجلسة محفوظ في الطلب باسم paymentRef).
إضافة مزوّد دفع آخر
كود ثواني مستقل في src/lib/thawani.ts (إنشاء جلسة، والسؤال عن حالتها)، ويُستدعى من مكانين: src/app/api/orders/route.ts و src/app/api/payments/thawani/return/route.ts. المزوّد الجديد يتبع النمط نفسه: أنشئ دفعة بقيمة order.total، واحفظ معرّفها في paymentRef، ولا تعلّم الطلب مدفوعاً إلا بعد سؤال المزوّد من الخادم.