ربط Stripe

استقبال المدفوعات الإلكترونية عبر Stripe: البطاقات، وApple Pay، وGoogle Pay.

1. نظرة عامة#

Stripe — منصة دفع عالمية. في سجل Cenaly، يتوفر Stripe للربط في 46 دولة. يتيح تكامل Cenaly + Stripe ما يلي:

• 💳 استقبال المدفوعات بالبطاقات (Visa، وMastercard، وAmEx)
• 📱 Apple Pay / Google Pay — الدفع بلمسة واحدة
• 💰 استلام التحويلات إلى حسابك البنكي
• 🔄 معالجة المبالغ المستردة من لوحة الإدارة
• 💵 الإكراميات — يضيف الضيف إكرامية عند الدفع
• 📊 التقارير — تحليلات مالية كاملة

2. المتطلبات#

• ✅ حساب Cenaly (الدفع الإلكتروني متاح على أي خطة، بما في ذلك الخطة المجانية)
• ✅ حساب Stripe (تسجيل مجاني على stripe.com)
• ✅ حساب بنكي لاستلام التحويلات (بعملة بلدك)
• ✅ مستندات للتحقق (جواز السفر / بطاقة الهوية، ومستندات الشركة)

الدول المدعومة#

يتوفر Stripe للربط في 46 دولة:

3. إنشاء حساب Stripe#

الخطوة 1. التسجيل#

1. انتقل إلى stripe.com → Start now
2. أدخل البريد الإلكتروني وأنشئ كلمة مرور
3. أكّد البريد الإلكتروني

الخطوة 2. التحقق من النشاط التجاري#

سيطلب Stripe ما يلي:

يستغرق التحقق عادةً 1–3 أيام عمل.

الخطوة 3. احصل على مفاتيح API#

1. في لوحة تحكم Stripe: Developers → API keys
2. انسخ:
   • Publishable key (pk_live_...)
   • Secret key (sk_live_...)

4. الربط بـ Cenaly#

يُربط حسابك الخاص على Stripe: تذهب أموال الضيف مباشرةً إلى رصيدك في Stripe، ولا يحتفظ بها Cenaly.

افتح متجر التطبيقات → فئة «المالية» → بطاقة Stripe → «إعداد» — ستُفتح كتلة الربط في نافذة منبثقة داخل المتجر مباشرةً. ويعمل المسار المعتاد أيضًا: الفروع → بطاقة الفرع → تبويب «المدفوعات» (قسم «دفع الضيف»)، وزر «ربط» عند بطاقة Stripe.

معالج الربط (موصى به)#

يرشدك معالج خطوة بخطوة (≈10 دقائق) عبر العملية كاملةً، موضحًا أين تنقر في لوحة تحكم Stripe:

1. اختر الوضع — تجريبي أو فعلي. يجب أن يتطابق الوضع في Stripe ومفتاح التبديل «تجريبي / فعلي» في Cenaly.
2. انسخ المفاتيح — Developers → API keys: مفتاح Secret key (sk_test_… / sk_live_…) إلزامي، ومفتاح Publishable key (pk_…) اختياري.
3. أضف webhook — Developers → Webhooks → Add endpoint، وفي حقل Endpoint URL الصق عنوان webhook الخاص بـ Cenaly الذي يمنحه المعالج بزر «نسخ». بدون webhook لن يُبلغ Stripe بأن الطلب قد دُفع، وقد يبقى الطلب في حالة «قيد الانتظار».
4. اختر الأحداث — في كتلة «Select events» أضف إلزاميًا checkout.session.completed (فهو تحديدًا ما يؤكد دفع الطلب)، ولطرق الدفع المؤجلة أضف أيضًا checkout.session.async_payment_succeeded وcheckout.session.async_payment_failed. ثم اضغط «Add endpoint». بدون هذه الأحداث يكون webhook منشأً لكنه لن يُبلغ عن الدفع.
5. انسخ Webhook signing secret (whsec_…) — حقل اختياري، لكن به يُفعَّل التحقق من توقيع الإشعارات.
6. ربط — تُرسل القيم المُدخلة إلى خادم خلفي محمي.

النموذج المختصر#

إذا كنت تعرف بالفعل موضع كل شيء في Stripe، افتح نموذج الربط المضمّن واملأ الحقول نفسها: Secret key، وWebhook signing secret (اختياري)، وPublishable key (اختياري)، إضافةً إلى مفتاح تبديل الوضع.

5. إعداد طرق الدفع#

البطاقات البنكية#

تُفعَّل تلقائيًا عند ربط Stripe:

• Visa / Mastercard — جميع الدول
• American Express — معظم الدول
• Diners Club / Discover — بشكل انتقائي

Apple Pay وGoogle Pay#

لا توجد مفاتيح منفصلة لهما في Cenaly: تتم الدفع عبر صفحة Stripe Checkout المستضافة، لذلك تُفعَّل المحافظ من جهة Stripe.

• Google Pay — يعمل مباشرة بعد ربط Stripe (Android، Chrome).
• Apple Pay — يطلب Stripe تأكيد النطاق: Settings → Payment methods → Apple Pay → Add new domain. بعد التحقق سيظهر الزر على iOS/Safari.

طرق أخرى#

عبر Stripe Dashboard يمكن تفعيل:

فعِّل الطرق المطلوبة في Stripe Dashboard → Settings → Payment methods.

6. الإكراميات#

الإعداد#

1. الفروع → بطاقة الفرع → تبويب «عام» → مفتاح «الإكراميات».
2. كيف يعمل:

كيف يرى الضيف ذلك#

عند الدفع بعد اختيار الأطباق:

طلبك: 45₾

إضافة إكرامية؟
[ 10٪ (4.50₾) ] [ 15٪ (6.75₾) ] [ 20٪ (9.00₾) ] [ مبلغ آخر ]
[ بدون إكرامية ]

الإجمالي: 49.50₾   [ادفع →]

تقارير الإكراميات#

قسم المالية:

• تبويب «نظرة عامة» — إجمالي الإكراميات للفترة مع مقارنة بالفترة السابقة؛
• تبويب «المبيعات» — الإكراميات موزَّعة حسب النادل.

7. التحويلات إلى حسابك#

كيف يحوّل Stripe الأموال#

يدفع الضيف → يحتفظ Stripe → بعد T+2 يوم → الأموال في حسابك

إعداد الجدول الزمني#

في Stripe Dashboard → Settings → Payouts:

• يوميًا (موصى به)
• أسبوعيًا (يوم محدد من الأسبوع)
• شهريًا

8. عمولات Stripe#

9. المرتجعات#

يبدأ استرداد الأموال عبر Stripe من مكانين — حسب طريقة خدمة الطلب.

مرتجعات المتجر الإلكتروني (RMA)#

1. قسم المرتجعات → بطاقة الطلب.
2. اختر وضع الاسترداد: إلى طريقة الدفع الأصلية (Stripe)، أو بطاقة هدايا (store credit)، أو استبدال.
3. حدِّد العناصر (استرداد كامل أو جزئي) وقرِّر ما إذا كان سيُعاد المنتج إلى المخزون.
4. تُرسَل الأموال مباشرة من الصفحة؛ وتصل إلى بطاقة الضيف عادةً خلال 5–10 أيام عمل.

المرتجعات عند نقطة البيع#

في POS يُسجَّل المرتجع حسب الإيصال — كاملًا أو جزئيًا، وهناك أيضًا استبدال مع إعادة بيع. ويجب أن تكون وردية نقطة البيع مفتوحة.

في بطاقة الطلب في قسم الطلبات تظهر شارات المرتجعات المسجَّلة مع رابط إلى الطلب.

10. الأمان#

PCI DSS#

• Cenaly لا تخزّن بيانات البطاقات — يتولى Stripe معالجتها بالكامل
• Stripe حاصل على شهادة PCI Level 1 (أعلى مستوى)
• تُشفَّر بيانات البطاقات وتُرمَّز

3D Secure#

• تحقق تلقائي عبر 3D Secure لبطاقات EU (SCA/PSD2)
• يقلل الاحتيال وعمليات الاسترداد العكسي
• بالنسبة للضيف: تأكيد في تطبيق البنك

Radar (الحماية من الاحتيال)#

يحجب Stripe Radar المعاملات المشبوهة تلقائيًا:

• نمط شراء غير معتاد
• بطاقات من القوائم السوداء
• شذوذ في الموقع الجغرافي

11. الاختبار#

قبل التفعيل في بيئة الإنتاج، اختبر:

بطاقات Stripe التجريبية#

CVV: أي 3 أرقام. التاريخ: أي تاريخ مستقبلي. ZIP: أي رمز.

كيف تختبر#

1. عند الربط اختر مفتاح «الوضع التجريبي» (لكل مزوّد مفتاحه الخاص).
2. استخدم المفاتيح التجريبية (pk_test_...، sk_test_...) — وكذلك webhook المُنشأ في نفس وضع Stripe التجريبي.
3. أنشئ طلبًا تجريبيًا → وادفع ببطاقة تجريبية.
4. تحقق من حالة الطلب في قسم الطلبات — يجب أن تصبح «مدفوع».
5. عندما يعمل كل شيء — أعد ربط المزوّد بمفاتيح حقيقية في وضع «الإنتاج».

12. مزوّدو الخدمة البدلاء#

للدول التي لا يتوفر فيها Stripe أو كإضافة — جاهزون بالفعل للربط:

وهناك 94 مزوّدًا آخر (Adyen، وPayTR، وЮKassa، وLiqPay، وMercado Pago، وRazorpay وغيرها) موجودون بالفعل في القائمة، لكنهم يظهرون باللون الرمادي — فالتكامل لا يزال قيد الاختبار. النظرة الكاملة — في قسم الدفع.

ربط أي مزوّد: متجر التطبيقات ← فئة «المالية» ← بطاقة المزوّد ← «إعداد»، أو بالطريقة المعتادة الفروع ← بطاقة الفرع ← تبويب «المدفوعات».

13. الأسئلة الشائعة#

متى سأستلم المال؟#

بعد يومَي عمل من الدفع (T+2). قد تستغرق أول دفعة 7–14 يومًا (حتى يتحقق Stripe من الحساب).

يريد الضيف الدفع نقدًا — ماذا نفعل؟#

طريقتا «نقدًا» و«بالبطاقة عند الاستلام» متاحتان دائمًا ولا تحتاجان إلى مزوّد دفع — يختارهما الضيف عند الدفع، ويتولى أمين الصندوق التحصيل. ولا يُستخدم Stripe في هذه الحالة؛ ويُطبع الإيصال على نقطة البيع إذا كانت لديكم أجهزة ضريبية متصلة (انظر الفوترة الضريبية).

هل يمكن ربط Stripe وBOG iPay معًا؟#

نعم. في تبويب «المدفوعات» يمكن تفعيل عدة مزوّدين في الوقت نفسه — وسيرى الضيف عند الدفع زرًّا لكل مزوّد يحمل اسمه.

حظر Stripe الحساب — ماذا نفعل؟#

1. تحققوا من البريد الإلكتروني — يرسل Stripe السبب
2. عادةً ما يُطلب تحقق إضافي
3. تواصلوا مع Stripe Support: support.stripe.com
4. أثناء الحظر يمكن استخدام مزوّد بديل

كيف نقلل العمولة؟#

• شجّعوا الدفع ببطاقات EU (1.5% بدل 2.9%)
• استخدموا SEPA للمبالغ الكبيرة (0.35€ ثابتة)
• عند حجم أعمال كبير (>100K€/شهر) — اطلبوا من Stripe خطة فردية

14. الدعم#

• Stripe: support.stripe.com
• Cenaly: support@cenaly.com ← الموضوع «Stripe / الدفع»
• Stripe Status: status.stripe.com (التحقق من حالة الخدمة)