טיצ׳ר כארד — מדריך הכנה לחיבור חנות אינטרנטית
https://teachercard.co.il/integrations/

מסמך לתיאום טכני. אינו מפרט API פעיל ואינו אישור להפעלת סליקה.
כתובות שירות, הרשאות וסביבת בדיקות יימסרו לאחר בדיקת התאמה ואישור בית העסק.

1. פרטי האתר
כתובת החנות; מערכת וגרסה; תוסף קופה וגרסה; אמצעי האשראי הקיים; פרטי קשר למפתח; סביבת בדיקות; הצורך בתשלום חלקי ובהשלמת הפרש.
אין לשלוח סיסמאות, מספרי כרטיס או מפתחות סודיים בפנייה.

2. דרכי החיבור
כפתור וקישור: מחולל הכפתור באתר מעצב קישור תשלום פעיל שכבר הונפק לעסק. הוא אינו מנפיק קישור ואינו מפעיל מסוף. קישור סטטי אינו מסנכרן לבדו את סכום הסל או את מצב ההזמנה.
חיבור לקופה: מתאם במערכת החנות יוצר בקשת תשלום בצד השרת, מפנה לעמוד התשלום ומעדכן הזמנה לאחר אישור מאומת.
מערכת מותאמת: מתווה החיבור והפעולות הזמינות יסוכמו מול הצוות.

3. פרטים לתיאום בממשק
מזהה חנות נגזר מהרשאת החיבור; מזהה הזמנה יציב; סכום סופי ביחידות קטנות (אגורות); מטבע; כתובות חזרה מאושרות; מנגנון בירור סטטוס; מניעת יצירה וחיוב כפולים; הודעת שרת חתומה ואימותה.
המחיר, המשלוח וההנחות מחושבים בשרת החנות. מפתח סודי נשאר בשרת. חזרה לעמוד הצלחה בדפדפן אינה הוכחת תשלום.

4. מהלך מוצע
יצירת הזמנה ממתינה לתשלום → בקשת תשלום בשרת → מעבר לעמוד טיצ׳ר כארד → אימות מחזיק הכרטיס ומימוש → אישור מאומת לחנות → עדכון ההזמנה וחזרה לחנות.
ניסיון חוזר משתמש באותה זהות עסקה. במקרה של תשובה לא ברורה יש לברר סטטוס לפני ניסיון חיוב נוסף.

5. התאמה לפלטפורמה
nopCommerce: גרסת nopCommerce ו־.NET, תוסף הקופה והרשאה להתקנת תוסף תשלום. יש לעדכן תשלום דרך שירות ההזמנות המתאים לגרסה.
WooCommerce: קופה קלאסית או Checkout Blocks, גרסאות WordPress/WooCommerce ותוספים המשפיעים על ההזמנה.
Wix: בדיקת מסלול חיבור ספק תשלום וזכאות. כפתור בעמוד אינו תחליף לחיבור להזמנות.
Shopify: בדיקת מסלול ואישור ספק תשלומים לפני התחייבות לפיתוח או להתקנה.

6. ביטולים, החזרים ותשלום משולב
יש לתאם מה זמין: ביטול, החזר מלא, החזר חלקי וחזרה למקור התשלום. כל החזר קשור לעסקה המקורית ומוגן מביצוע חוזר.
תשלום משולב TeacherCard ואשראי דורש תכנון שמירת יתרה, השלמת ההפרש, שחרור או זיכוי במקרה כשל ותיעוד הסכום בכל מקור. אינו מופעל באמצעות כפתור בלבד.

7. בדיקות לפני הפעלה
קנייה כאורח ומשתמש מחובר; מחשב ומובייל; משלוח והנחות; שינוי סכום בדפדפן; לחיצה כפולה; תשובה שהתעכבה; סגירת חלון אחרי חיוב; הודעת שרת כפולה; יתרה לא מספקת; ביטול והחזר; ניסיון חוזר ללא חיוב כפול.

מקורות טכניים לפלטפורמות:
https://docs.nopcommerce.com/en/developer/plugins/payment-method.html
https://developer.woocommerce.com/docs/features/payments/payment-gateway-api/
https://dev.wix.com/docs/develop-websites/articles/code-tutorials/wix-pay/tutorial-payment-provider-service-plugin
https://shopify.dev/docs/apps/build/payments

לתיאום חיבור: https://teachercard.co.il/contact/
טלפון: 02-970-9231, שלוחה 3.