טרנזילה + ווקומרס – חיבור, iframe ופתרון תקלות

עודכן לאחרונה: 06.11.2026 · מאת עשהאל דרייר

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

⏱ זמן ביצוע: 30–60 דקות אחרי שהמסוף פעיל · רמת קושי: בינוני · נבדק לאחרונה מול האתר והתיעוד של טרנזילה: 06.11.2026

טרנזילה (Tranzila) היא ספקית סליקה ישראלית, שעובדת עם שופיפיי, וויקס, ווקומרס ופלטפורמות נוספות. לפי עמוד הווקומרס באתר שלה, התוסף בנוי על שדות מתארחים ותומך בכרטיסי אשראי, ביט, Apple Pay, Google Pay, PayPal והוראה לחיוב חשבון. עוד לא בחרתם ספק? התחילו מהשוואת ספקי הסליקה לווקומרס.

לפני שמתחילים

• מסוף סליקה פעיל בטרנזילה, עם המודולים שאתם צריכים: טוקנים, חשבונית דיגיטלית, ביט או חיוב מחזורי. חלק מהם מודולים נפרדים בתשלום.
• קובץ התוסף ופרטי ההגדרה מטרנזילה. בקשו מהם גם הוראות התקנה לגרסה שאתם מקבלים, ושאלו אם העדכונים כלולים. לפי האתר שלהם, עדכוני התוסף כלולים בשירות.
• HTTPS עם תעודת SSL תקפה. לפי התיעוד של טרנזילה, Google Pay דורש SSL תקין בעמוד שמציג את ה-iframe. בפועל כל קופה צריכה HTTPS.
• גיבוי וסביבת בדיקות. גבו את החנות, ועדיף להתקין קודם בסביבת Staging.

אזהרה: לא להתקין תוספי טרנזילה ישנים מהמאגר

בעבר היו במאגר וורדפרס תוספי קהילה לטרנזילה שלא פותחו על ידי החברה. אחד הנפוצים, Woocommerce Tranzila Payment Gateway, נסגר במאגר ב-12 בינואר 2024 בגלל בעיית אבטחה, ואינו זמין להורדה. אם אחד מהם עדיין מותקן אצלכם, תכננו מעבר לתוסף שטרנזילה מספקת היום, ואל תשאירו קוד תשלומים שלא מתעדכן.

כך עוברים מתוסף ישן בלי לאבד הזמנות:

1. בדקו שאין הזמנות פתוחות בסטטוס "ממתין לתשלום" או "בהמתנה" שעדיין תלויות בתוסף הישן, וטפלו בהן.
2. גבו את האפליקציה, ושכפלו אותה לסביבת Staging.
3. ב-Staging נטרלו את התוסף הישן, התקינו את התוסף מטרנזילה, ובצעו עסקת בדיקה מלאה.
4. חזרו על אותו תהליך באתר החי בשעה שקטה, ומחקו את התוסף הישן רק אחרי שעסקה אמיתית עברה בהצלחה.

איך הסליקה של טרנזילה עובדת מאחורי הקלעים

כדאי להבין את המנגנון גם אם אתם לא מפתחים, כי בזכותו מבינים מה נשבר כשמשהו לא עובד. כך זה עובד לפי התיעוד הרשמי ב-docs.tranzila.com:

1. הלקוח לוחץ "בצע הזמנה". ווקומרס יוצרת הזמנה בסטטוס "ממתין לתשלום".
2. האתר פותח את דף התשלום של טרנזילה בתוך iframe, בכתובת מהצורה https://directng.tranzila.com/terminalname/iframenew.php. הכתובת הישנה direct.tranzila.com מסומנת בתיעוד כמיושנת.
3. הלקוח משלם בכרטיס, בביט או בארנק דיגיטלי, בתוך הדף של טרנזילה. פרטי הכרטיס לא עוברים בשרת שלכם.
4. טרנזילה מעבירה את הלקוח לכתובת ההצלחה או הכישלון (success_url_address / fail_url_address), עם נתוני העסקה.
5. במקביל, אם הוגדרה כתובת notify_url_address, טרנזילה שולחת אליה את נתוני העסקה ישירות מהשרת שלה. זו ההודעה שאמורה לעדכן את ההזמנה גם אם הלקוח סגר את הדפדפן לפני שחזר לאתר.

הקוד Response=000 בנתונים שחוזרים פירושו עסקה מאושרת. כל קוד אחר הוא סירוב או שגיאה, ולטרנזילה יש טבלת קודי תשובה רשמית.

איך מתקינים את תוסף טרנזילה בווקומרס?

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

1. בניהול וורדפרס היכנסו לתוספים ← הוספת תוסף ← העלאת תוסף, ובחרו את קובץ ה-ZIP שקיבלתם מטרנזילה.
2. התקינו והפעילו את התוסף.
3. היכנסו לWooCommerce ← Settings ← Payments ופתחו את ההגדרות של טרנזילה.
4. הזינו את פרטי המסוף שקיבלתם מטרנזילה, ובחרו אילו אמצעי תשלום להציג.
5. בחרו את סוג העסקה (חיוב רגיל או תפיסת מסגרת) ואת מספר התשלומים המקסימלי.
6. שמרו, ובצעו עסקת בדיקה. בדקו שההזמנה עברה ל"בטיפול" בלי התערבות ידנית.

ה-iframe של טרנזילה: הפרמטרים שכדאי להכיר

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

פרמטר	מה הוא עושה
sum, currency	סכום ומטבע. שדות חובה
tranmode	סוג העסקה: A רגילה, V תפיסת מסגרת (J5), N בדיקה (J2), K יצירת טוקן בלי בדיקת כרטיס, J הוראת קבע
cred_type, maxpay, npay	תשלומים. ב-cred_type=8 (תשלומים רגילים) אפשר לשלוח רק maxpay ולתת לטרנזילה לחשב את הפריסה. ב-cred_type=6 (קרדיט) נדרש npay של 3 לפחות
notify_url_address	הכתובת באתר שמקבלת את נתוני העסקה מהשרת של טרנזילה
success_url_address, fail_url_address	לאן הלקוח חוזר אחרי הצלחה או כישלון
lang	שפת הדף, למשל il לעברית
bit_pay=1, apple_pay=1, google_pay=1	הצגת ביט, Apple Pay ו-Google Pay בדף
DCdisable	מניעת חיוב כפול, עם ערך ייחודי לכל עסקה

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

ביט, Apple Pay ו-Google Pay: מה צריך לדעת

• Apple Pay מופיע רק במכשירי אפל עם Touch ID או Face ID, ובדפדפן של אפל כמו Safari. ב-Chrome על אייפון או על מחשב הוא לא יופיע, וזה לא תקלה.
• Google Pay עובד רק בדף ה-iframe החדש, דורש את המאפיין allowpaymentrequest='true' בתגית ה-iframe ותעודת SSL תקינה, ותומך רק בעסקה רגילה ובתפיסת מסגרת. לפי התיעוד, ב-iframe בעברית הכפתור מוצג באנגלית.
• ביט צריך להיות פעיל במסוף שלכם. אם הכפתור לא מופיע, בדקו קודם מול טרנזילה שהשירות הופעל.

שאלות שכדאי לשאול את טרנזילה לפני ההתקנה

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

• מה שם התוסף, איך מקבלים עדכונים, ואיזו גרסה של PHP, וורדפרס ו-WooCommerce הוא דורש?
• האם התוסף תומך בקופת הבלוקים של ווקומרס, או רק בקופה הקלאסית?
• אילו אמצעי תשלום פעילים במסוף שלי (ביט, Apple Pay, Google Pay), והאם יש עלות נוספת לכל אחד?
• האם יש תמיכה בטוקנים, במנויים (WooCommerce Subscriptions) ובתפיסת מסגרת?
• איך מופקת חשבונית: דרך המודול של טרנזילה, או דרך תוכנה אחרת שכבר יש לי?
• מאילו כתובות IP נשלחות הודעות ה-notify, למקרה שאצטרך לאשר אותן בחומת האש?

מה השרת צריך כדי שהודעת ה-notify תגיע

הודעת ה-notify היא בקשה שמגיעה מהשרתים של טרנזילה לאתר שלכם. אם משהו בדרך חוסם אותה, הלקוח יראה "תודה על ההזמנה", וההזמנה תישאר "ממתינה לתשלום". ארבעה דברים לבדוק:

1. חומת אש והגנה מבוטים. בשרת Flexible בקלאודוויז (Cloudways) בדקו בלשונית Security ← Incidents אם נחסמו כתובות של טרנזילה. אם כן, אשרו אותן ב-Firewall. את כתובות ה-IP העדכניות של טרנזילה בקשו מהתמיכה שלהם, כי הן לא מופיעות בתיעוד הפומבי.
2. Cloudflare. אם האתר מאחורי Cloudflare, ודאו שמצב Under Attack או חוקי WAF לא מציגים אתגר לבקשות שמגיעות לכתובת ה-notify.
3. קאש. כתובת ה-notify לא אמורה להישמר בקאש. Varnish בקלאודוויז מחריג בקשות POST ואת הנתיב wc-api כברירת מחדל. אם התוסף משתמש בנתיב אחר, החריגו אותו גם בתוסף הקאש שלכם.
4. הפניות. הפניה מ-http ל-https, או מ-www לכתובת בלי www, עלולה לשבור בקשת POST. ודאו שכתובת ה-notify בהגדרות זהה לכתובת הראשית של האתר.

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

אילו תקלות נפוצות יש בטרנזילה ווקומרס ואיך פותרים אותן?

שגיאה Illegal Operation 912791: לפי התיעוד של טרנזילה, הסכום בדף התשלום לא תואם לסכום שנשלח ב-Handshake. Handshake הוא מנגנון הגנה שבו האתר "רושם" מראש את סכום העסקה, כדי שאי אפשר יהיה לשנות אותו בדפדפן. כשהוא מופעל, כל עסקה חייבת לכלול טוקן thtk תקף, והנתונים נשמרים 20 דקות. לפי התיעוד, Handshake דורש רכישת מודול טוקנים והפעלה על ידי התמיכה של טרנזילה, ולכן הוא לא פעיל בכל מסוף. אם לקוח השאיר את הקופה פתוחה יותר מזה, או שקופון שינה את הסכום אחרי ה-Handshake, תופיע השגיאה.

הלקוח שילם, וההזמנה נשארת "ממתין לתשלום": הודעת ה-notify לא הגיעה או לא עובדה. בדקו את ארבעת הסעיפים בחלק על השרת, ואת לוג הגישה של האפליקציה בזמן העסקה.

חיוב כפול על אותה הזמנה: קורה כשהלקוח לוחץ פעמיים או חוזר אחורה. הפרמטר DCdisable מונע זאת, אבל לפי טרנזילה צריך להגדיר אותו מראש ב"שדות נוספים לעסקה" במסוף, ובמסוף עם תתי-מסופים בכולם.

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

חיוב מחזורי לא עובד: פרמטרי הוראת הקבע עובדים רק עם מודול My Billing בתשלום. בלי המודול הם פשוט לא פועלים.

ה-iframe לא נטען או נחתך במובייל: בדרך כלל זו התנגשות עם תבנית או עם בונה עמודים, או חוסר בתעודת SSL. בדקו בחלון גלישה בסתר, ונסו להחליף זמנית לתבנית ברירת מחדל ב-Staging.

שאלות נפוצות על טרנזילה בווקומרס

מדריכים קשורים

• השוואת ספקי סליקה לווקומרס בישראל
• הסליקה עברה אבל ההזמנה לא התעדכנה
• אחסון לחנות ווקומרס בקלאודוויז
• חיבור קארדקום לווקומרס
• כל המדריכים בתחום: מדריכי וורדפרס ווקומרס

מקורות רשמיים: אתר טרנזילה (עמוד "סליקה בוורדפרס / ווקומרס" בתפריט תוספי הסליקה) · DirectNG iframe integration (Tranzila Docs) · דף התוסף הסגור במאגר וורדפרס · A Brief Guide to Server Security Management (Cloudways Knowledge Base). המדריך נכתב ונבדק על ידי עשהאל דרייר · עודכן: 06.11.2026

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