חיבור 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. חיבור ל-Meni#

מתחבר החשבון שלכם של Stripe: כספי האורח עוברים ישירות ליתרה שלכם ב-Stripe, Cenaly לא מחזיק אותם.

פתחו חנות האפליקציות → קטגוריית „פיננסים“ → כרטיס Stripe → „הגדרה“ — בלוק החיבור ייפתח בחלון קופץ ישירות בחנות. המסלול המוכר עובד גם כן: סניפים → כרטיס הסניף → לשונית „תשלומים“ (סעיף „תשלום על ידי האורח“), כפתור „חיבור“ ליד כרטיס Stripe.

אשף החיבור (מומלץ)#

אשף שלב-אחר-שלב (≈10 דקות) מוביל אתכם דרך כל התהליך, ומראה היכן ללחוץ בלוח הבקרה של Stripe:

1. בחרו מצב — בדיקה או אמת. המצב ב-Stripe והמתג „בדיקה / אמת“ ב-Meni חייבים להתאים.
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. חיבור — הערכים שהוזנו נשלחים ל-Backend מאובטח.

טופס מקוצר#

אם אתם כבר יודעים מה נמצא היכן ב-Stripe, פתחו את טופס החיבור המוטבע ומלאו את אותם שדות: Secret key, Webhook signing secret (אופציונלי), Publishable key (אופציונלי) ובנוסף מתג המצב.

5. הגדרת אמצעי תשלום#

כרטיסי בנק#

מופעלים אוטומטית בעת חיבור Stripe:

• Visa / Mastercard — כל המדינות
• American Express — רוב המדינות
• Diners Club / Discover — באופן סלקטיבי

Apple Pay ו-Google Pay#

אין מתגים נפרדים עבורם ב-Meni: התשלום מתבצע בעמוד מתארח של 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. שאלות נפוצות#

מתי אקבל את הכסף?#

כעבור 2 ימי עסקים לאחר התשלום (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 (בדיקת תקינות)