يستقبل Stripe مدفوعات البطاقات للطلبات عبر الإنترنت مباشرةً في حساب Stripe واحد: الحساب الذي تعود إليه مفاتيح التكامل، وهو عادةً حساب المطعم نفسه. ويحوّل Stripe رصيد هذا الحساب إلى حسابه البنكي. لا يقتطع OrderTiger أي رسوم داخل Stripe؛ وأي رسوم لـ OrderTiger تُحتسب بشكل منفصل في فواتير المطعم.
لاقتطاع حصة من كل دفعة داخل Stripe، أو لتحصيل المدفوعات نيابةً عن المطاعم، استخدم Stripe Connect بدلًا منه.
الإعداد#
- في عرض الشركة، افتح المالية → تكامل الدفع وانقر على + في بطاقة Stripe.
- أبقِ Stripe محددًا أعلى النموذج (وليس Stripe Connect).
- املأ الحقول أدناه وانقر على حفظ.
- في عرض الموقع، افتح المالية → طرق الدفع، وأضف طريقة الدفع البطاقة أو عدّلها، واختر هذا التكامل معالجًا للدفع فيها.
| الحقل | ما هو |
|---|---|
| اسم المعرف | اسم تختاره أنت للتكامل، يظهر في القوائم وعند اختياره في طريقة دفع. |
| المفتاح العام | مفتاح Stripe القابل للنشر (pk_live_… أو pk_test_…)، من Developers → API keys في Stripe. |
| المفتاح السري | مفتاح Stripe السري (sk_live_… أو sk_test_…) للحساب نفسه. يكون مخفيًا افتراضيًا؛ انقر على أيقونة العين لإظهاره. |
| سر توقيع Webhook | اختياري. اتركه فارغًا: عند الحفظ ينشئ OrderTiger الـ webhook الخاص به على حساب Stripe هذا ويملأ هذا الحقل نيابةً عنك. |
| التسوية التلقائية للمدفوعات | عند التشغيل: تُخصم قيمة الطلب من البطاقة فور دفع العميل. عند الإيقاف: يُحجز المبلغ فقط على البطاقة ويُخصم عند قبول الطلب. أما المواقع التي تؤكد الطلبات تلقائيًا فتخصم المبلغ فورًا دائمًا. |
| Apple Pay / Google Pay | لعرض هاتين المحفظتين عند الدفع. يحتاج Apple Pay أيضًا إلى التحقق من النطاق في Stripe. |
| معرف تاجر iOS | معرف تاجر Apple Pay الذي يستخدمه تطبيق الطلبات على iOS. يظهر للمسؤولين الرئيسيين فقط. |
كيف يُعلَّم طلب البطاقة بأنه مدفوع#
عندما يدفع العميل، ينتظر الطلب بحالة بانتظار الدفع بالبطاقة إلى أن يؤكد Stripe الدفع. ويؤكده Stripe باستدعاء الـ webhook الخاص بـ OrderTiger؛ عندها يصبح الطلب مدفوعًا ويظهر في الطلبات المباشرة.
- يُنشأ الـ webhook لك على حساب Stripe عند حفظ التكامل، ويستمع إلى
charge.succeeded. ويظهر في Stripe ضمن Developers → Webhooks. - يُحفظ سر توقيعه في سر توقيع Webhook. عند حفظ سر، لا يقبل OrderTiger تأكيد الدفع إلا إذا حمل توقيع Stripe. ومن دونه، يُقبل التأكيد دون هذا التحقق.
- إذا كان الـ webhook موجودًا مسبقًا عند الحفظ، فسيُعاد استخدامه ويبقى الحقل فارغًا: إذ لا يعطي Stripe سر الـ webhook إلا عند إنشائه. انسخه من الـ webhook في Stripe (Reveal) والصقه، أو احذف الـ webhook في Stripe واحفظ التكامل مرة أخرى.
المبالغ المستردة#
يتم الاسترداد من الطلبات، باستخدام زر الاسترداد في الطلب. يُخصم المبلغ المسترد من حساب Stripe نفسه الذي استلم الدفعة ويعود إلى بطاقة العميل.
- لا توجد رسوم لتقسيمها: يُخصم المبلغ المسترد بالكامل من ذلك الحساب.
- لا يُعيد Stripe رسوم معالجة البطاقة الخاصة به عند الاسترداد.
- في طلبات الشركات من نوع البوابة، يسأل نموذج الاسترداد هل التاجر مسؤول عن هذا الاسترداد؟. في Stripe العادي يُخصم المبلغ دائمًا من حساب Stripe هذا؛ ولا تحدد الإجابة إلا كيفية ظهور الاسترداد في الفواتير: الاسترداد على مسؤولية التاجر يُخصم من أرباح المطعم، أما الاسترداد على مسؤولية المنصة فلا يُخصم.
- يمكن أن يكون الاسترداد جزئيًا؛ وتُدرج المبالغ المستردة حتى الآن تحت الطلب.
استكشاف الأخطاء وإصلاحها#
| المشكلة | ما الذي يجب التحقق منه |
|---|---|
| يبقى طلب مدفوع بحالة بانتظار الدفع بالبطاقة ولا يصل أبدًا إلى الطلبات المباشرة | لم يصل تأكيد Stripe. في Stripe، تحقق من وجود الـ webhook الخاص بـ OrderTiger ضمن Developers → Webhooks واطّلع على عمليات الإرسال الأخيرة. إذا لم يكن موجودًا، فاحفظ التكامل مرة أخرى لإنشائه. |
| سر توقيع Webhook لا يزال فارغًا بعد الحفظ | كان الـ webhook موجودًا مسبقًا. الصق سرّه من Stripe، أو احذف الـ webhook في Stripe واحفظ مرة أخرى. |
| تفشل المدفوعات بخطأ في المصادقة | يجب أن يكون المفتاح السري والمفتاح العام من حساب Stripe نفسه وفي الوضع نفسه (كلاهما تجريبي أو كلاهما حقيقي). |