מדריך חיבור הסליקה לחנות וורדפרס - Wordpress Woocommerce Payment WOO
מאפשר רכישות דרך החנות המקוונת שלך ב-WordPress (מסוג הו-קומרס WooCommerce).
לאחר התקנת התוסף, טופס הסליקה מוצג ללקוח לאחר בחירתו לשלם באמצעות כרטיס אשראי.
הטופס מוצג ב-HTML של האתר באמצעות IFRAME או במעבר אל עמוד חדש (REDIRECT) — לפי בחירתך.
תנאים להפעלת הסליקה באתר:
רכישת מודול פרופיל נמוך וקבלת הרשאות גישה API לחשבון.
אתר בפלטפורמת WordPress בגירסה 6 ומעלה.
(במקרה של שגיאת Peer's Certificate חובה לעדכן את ה-WordPress לגירסה 6 ומעלה.)
לבונה האתר / מתכנת:
יש לבדוק האם בעל העסק רכש מודול פרופיל נמוך (חובה).
מודול מסמכים / אסימונים (אופציונלי) — ולעדכן בהגדרות תוסף הסליקה בהתאם לאפיון.
נתמך גם עם Woo Subscriptions למנויים באתר.
מדריך לחיבור עם תוסף Woo Subscriptions - הגדרות ודרישות טכניות.נתמך גם עם UpStroke: WooCommerce One Click Upsell לאפסייל באתר.
עבודה עם אפסייל UpStroke: WooCommerce One Click Upsell for CardCom.
קישור להורדת תוסף Cardcom Payment Gateway
נמצא ברשימת התוספים הרשמית של אתרי WordPress.
שם התוסף: Cardcom Payment Gateway.
מומלץ להתקין מתוך רשימת התוספים הרשמית ב-WordPress.
אם הותקן בעבר ממקור אחר — יש לבטל את הפעלתו, לבצע הסרה מלאה, ולאחר מכן להוסיף מחדש.
לאחר התקנת התוסף — הפעלתו
יש לגשת בוורדפרס ללשונית "תוספים מותקנים", שם נמצא את התוסף ולוחצים על "הפעלה".
לאחר מכן:
"ווקומרס" -> "הגדרות" -> "תשלומים" -> בתוסף שלנו נלחץ על "ניהול" כדי להגדיר את התוסף.
תמונות להמחשה:
השדות בהגדרות התוסף:
Title (חיוני)
תיאור אופן התשלום כפי שיוצג למשתמש באתר. (שדה דרוש)
Enable/Disable (חיוני)
האם המודל פעיל.
Description (חיוני)
מלל חופשי למשתמש באתר.
Operation (חיוני) – סוג הפעולה לביצוע:
1. Charge Only
חיוב בלבד. (דורש מודול פרופיל נמוך)
2. Charge and Save TOKEN
חיוב ושמירת אסימון — מאפשר ללקוח החוזר לבחור את פרטי האשראי לתשלום במקום להזין מחדש. במידה ובית העסק אינו רוצה בכך, הוא יצטרך להסתיר את האפשרות מהצד שלו.
חיוב האסימונים יעשה מצד המתכנת & דרוש מסוף ללא דרישה לCVV ות''ז.
(דורש מודול פרופיל נמוך + אסימונים}.
3. Save TOKEN
שמירת אסימון בלבד. מתאים לאתר מנויים.
דורש מתכנת + מודול אסימונים.
שלבים להגדרה:
שלב 1: יש לקבל דיווח ב-API לשרת המתכנת דרך כתובת זו:
https://secure.cardcom.solutions/Definition/LowProfile/GlobalDef.aspx
(ביצוע Notify נוסף / Webhooks - להזין כתובת URL).שלב 2: משיכת האסימון בקראית GET – ממשק פרופיל נמוך - חיוב, יצירת אסימון וכו [שלב 1 + 2].
-
שלב 3: חיוב אסימון ידני ב-API לפי מדריך: חיוב/ זיכוי אסימון (דרוש מודול אסימונים) - [שלב 3]
דרוש מסוף ללא דרישה לCVV ות''ז.(דורש מודול אסימונים.)
4. Suspended Deal
עסקה מושהית – משהה את העסקה. בעל העסק מחייב ידנית דרך מערכת קארדקום באתר לפי מדריך - >עסקה מושהית.
(דורש מודול עסקה מושהית.)
4.1 Suspended Deal - J2
בדיקת ספרת ביקורת עד ש.ב.א — ללא תפיסת מסגרת.
4.2 Suspended Deal - J5
תפיסת מסגרת אשראי.
דורש אישור מחברות האשראי על משך זמן התפיסה.
5. Capture Charge
חיוב תפיסת מסגרת דרך מערכת ה-WooCommerce.
(דורש אסימונים & J5 למסוף מחברות האשראי.)
מאפשר:
עריכת סכום הזמנה במערכת הניהול של האתר.
חיוב דרך האתר עצמו.
עדכון וחיוב מתבצע בצד של WooCommerce (ולא דרך קארדקום).
ברקע: נוצר ונחייב אסימון.
(דורש מודול אסימונים, אך לא דורש מסוף עם CVV).דגש חשוב! במידה ומבצעים החלפת ח.פ - מעבר למנוי חדש, ההזמנות שנמצאות בהשהיה יקבלו סירוב ברגע שמחברים את המסוף החדש, צריך לחייב את כל ההזמנות לפני הטמעת פרטי API של המסוף החדש. או לחילופין לפנות עם המתכנת לתמיכה למתכנתים לקבלת הסבר איך למחוק את מספר האישור שמתקבל בהזמנות (Approval Number) ואז לחייב את ההזמנות כרגיל
Order Status (חיוני)
עדכון מצב ההזמנה לאחר ביצוע תשלום — לא רלוונטי בפיצ'ר זה.
תמיד יהפוך ל-ON-HOLD במצב של Capture Charge.
במצב Capture Charge בשינוי סטטוס ההזמנה ל-completed או processing – רק אז מתבצע החיוב בפועל.
מומלץ: לספק מוצר/שירות רק לאחר חיוב העסקה בפועל.
בנוסף: יש אפשרות בטופס התשלום למחזיק הכרטיס לסמן שמירת פרטים להבא – לזיהוי אוטומטי בהמשך.
Invoice (חיוני) – האם ליצור חשבונית עם חיוב אשראי?
יש לבדוק עם בית העסק האם נרכש מודול מסמכים.
אם כן: יש לבחור YES.
אם לא: יש לבחור באפשרות Display only.
לתשומת ליבכם:
הפעולות מתבצעות עבור לקוח מזדמן / לקוח כללי בלבד.
כדי להטמיע אפשרות ליצירת כרטיסי לקוח, יש להיכנס אל:
לשונית הגדרות -> 4. סליקה בפרופיל נמוך -> 2. הגדרות כלליות
ושם לסמן תחת "הגדרות עוקפות API" את האפשרות:
"יצירת כרטיס לקוח."
Terminal Number (חיוני)
מספר המסוף הייחודי כפי שניתן לכם כאשר פתחתם חשבון במערכת אישורית זהב. (אפשר להכניס רק מספר מסוף אחד)
API User Name (חיוני)
משתמש הממשקים של המסוף (מפתחות API - איפה הם נמצאים ואיך לקבל?)
API Password (חיוני)
סיסמת המשתמש ממשקים לביטול וזיכוי עסקאות דרך ההזמנות של ווקומרס (מפתחות API - איפה הם נמצאים ואיך לקבל?) בשביל לבצע ביטול הזמנות אפשר להיעזר במדריך ביטול וזיכוי עסקאות והזמנות דרך האתר של וורדפרס שבו מותקן התוסף של קארדקום.
פעיל רק עבור Charge and Save TOKEN.
Must CVV
האם המסוף חייב CVV.
אם כן – במקרה שהלקוח חוזר בפעם השנייה לרכוש, הטופס יבקש ממנו להקליד את ה-CVV שלו.
Cvv Must Terminal Number
מספר מסוף הוראות קבע / ללא בדיקת CVV בחברת אשראי.
הגדרה זו תקפה רק בעבודה עם אסימונים. (לא חובה)
Max Payment
מספר התשלומים המקסימלי שמוצג בדף.
(מומלץ לעבוד עם מדרגות תשלומים)
Currency
סוג מטבע:
0 – זיהוי אוטומטי מהזמנה
1 – שקל
2 – דולר
(למטבעות זרים דרוש אישור מחברות האשראי)
Lang
שפת ממשק: he לעברית, en לאנגלית.
ריבוי שפות נתמך עם תוסף WPML או Polylang
https://wpml.org/he/purchase
https://wordpress.org/plugins/polylang
Admin Email
כתובת אימייל לקבלת התראות ולוגים מהפלאגין במידה ויש בעיה.
במקרים נוספים של תקלות ב-WooCommerce, על המתכנת להפעיל Debug ל-Woo עצמו. ניתן להיעזר במדריך:
https://docs.woocommerce.com/document/woocommerce-product-search/api/debugging/
PCI certification (חיוני ביותר, לעשות על NO תמיד)
האם לאפשר הזנת פרטי אשראי בתוך דף הצ'קאאוט.
שימו לב: פיצ'ר זה ללא תקן PCI! כלומר שאינו מאובטח! וחשוף להתלבשות על הדף תשלום על בית העסק לגניבת פרטי אשראי!
בהפעלתו – לא ניתן לעבוד עם מודול עסקה בטוחה (3D Secure).
מומלץ לעבוד עם UseIframe=yes ולעצב את הדף תשלום.
UseIframe
האם להפעיל את המודול בתוך IFRAME.
שימו לב: לפי דרישות חברות האשראי, יש לרכוש SSL לאתר ולהפעיל HTTPS.
מומלץ לעבוד עם UseIframe=yes ולעצב את הדף בפרופיל נמוך – גרסה 5 – CSS/HTML מותאם אישית.
הגדרות למסמכים חשבונאיים:
Invoice VAT Free
חשבונית תצא עם מע"מ 0.
מתאים ללקוחות שמוכרים לחו"ל.
Invoice Will Include VAT
(ברירת מחדל) – המחיר והחשבונית כוללים מע"מ.
המערכת תחלץ את המע"מ בחשבונית.
(בעוסק פטור – יוצא מסמך מתאים לפי ההגדרות בקארדקום)
Invoice Include Tax Per Product
מע"מ ברמת פריט – מאפשר שילוב מוצרים עם ובלי מע"מ באותה הזמנה.
Invoice Include VAT by Country
מע"מ לפי מדינת השילוח בהזמנה:
אם ישראל – כולל מע"מ
אם לא ישראל – ללא מע"מ
מומלץ להשתמש בהגדרה זו גם לפי כתובת IP של הלקוח (דורש התאמה בשפת הדף והגדרות המסוף).
Order Status
עדכון מצב ההזמנה לאחר ביצוע תשלום בהצלחה.
processing | completed | on-hold
Failed URL (3.5.1.0)
נכון לגרסה העדכנית – אין שדה כתובת כשלון בפלאגין.
הכתובת תהיה ברירת המחדל של WooCommerce.
כדי לשנות – יש להיכנס לקוד PHP ולבצע שינויים ידניים.
בעת עדכון גרסה – ייתכן והשינויים יידרסו.
Success URL (3.5.1.0)
נכון לגרסה העדכנית – אין שדה כתובת הצלחה בפלאגין.
הכתובת תהיה ברירת המחדל של WooCommerce.
כדי לשנות – יש להיכנס לקוד PHP ולבצע שינויים ידניים.
בעת עדכון גרסה – ייתכן והשינויים יידרסו.
Invoice for Paypal
(אופציונלי) האם להפיק חשבונית עבור תשלומים בפייפאל דרך כפתור חיצוני (לא נמצא בטופס הסליקה).
Invoice for Paypal – Send to Email
האם לשלוח את החשבוניות של פייפאל למייל.
Debug Logging
הפעלת / כיבוי כתיבת לוגים.
כדאי להשאיר כבוי כברירת מחדל.
מיועד רק לצרכי ניתוח פעולות הפלאגין במקרי תקלה.
ליצירת חשבוניות עבור PayPal – כפתור חיצוני (כפתור מחוץ לדף התשלום)
המערכת תפיק חשבונית עבור כל עסקאות ה-PayPal כאשר הסטטוס שלהן משתנה ל-
CompletedאוProcessing,
בנוסף, דרך אירוע PayPal המתריע על סיום העסקה.מומלץ להשתמש בכפתור פנימי, משום שהמסמך החשבונאי נשלח באופן מיידי לאחר השלמת העסקה דרך PayPal.
במקרה בו נעשה שימוש בכפתור חיצוני, יש לשנות את ההגדרה:
Invoice for Paypal → לבחור ב-YES.
אפשרות לכפתור PayPal פנימי (מופיע על דף התשלום)
מאפשר הצגת כפתור PayPal ישירות בדף הסליקה.
יתרון: מסמך החשבונית נשלח מיד לאחר השלמת העסקה.
הגדרת כפתור Paypal על דף הסליקה.
במקרה של תקלה בדיווחים או בסגירת ההזמנה באתר
לדוגמה: השגיאה The remote server returned an error: (400) Bad Request)
בית העסק צריך לפנות לחברת האחסון שלו ולבקש לפתוח את טווחי הכתובות הבאים בחומת האש (Firewall) של החברה:
(לרבות ב-Cloudflare, במידה וקיים)
82.80.227.17/255.255.255.248(CIDR 29)82.80.222.124/255.255.255.248(CIDR 29)
ניתן לחשב את טווח הכתובות המלא לפי Subnet באמצעות מחשבון CIDR.
במקרה של :
| תיאור התשובה מהשרת לדיווח: |
|
יש לנטרל תוסף קאש ב באתר WOO שגורם לבעיה.
במקרה ולקוח מקבל את ההודעת שגיאה:
"אנו מתנצלים, אך קיימת בעיה זמנית בעיבוד התשלום. יש לנסות שוב בעוד כמה דקות או ליצור קשר עם החנות לקבלת סיוע" - בית העסק יכול לומר ללקוח לנסות בדקות הקרובות. זו היא בעיית תקשורת רגעית. כמובן גם אפשר ליצור איתנו קשר על מנת לוודא זאת מולנו.
במקרים של תקלות לא ידועות : יש להפעיל דיבאג Debugging ל WOO עצמו שכותב ללוג כל הזמנה מה קורה איתה :
https://woo.com/document/woocommerce-product-search/api/debugging
במקרים שלקוח מזין ב צקאווט שם חברה / Company Name - זה הפרמטר שנלקח לחשבונית במקום השם הפרטי ורק הוא יופיע בדף התשלום .
ללקוחות שרוצים לעבוד בתצורה של Checkout Blocks -
ניתן להחזיר לתצוגה הקלאסית "Switch to classic checkout"
בWOO יש להיכנס אל "עמודים -> Checkout -> Edit
How to switch back to WooCommerce Classic Checkout (0:35)
https://youtu.be/bnkCkzCkY94?si=UypSKZ_z9iUpwzJl
או
(3:32) How to convert blocks checkout to classic checkout or default woocommerce checkout
https://youtu.be/1saN_yZ7-c8?si=WANYGQCTWpnl0KUN
במקרים שלא ניתן להיכנס להגדרות ויזואליות ניתן להיעזר במדריך זה בכדי לחזור לתצוגה קלאסית
https://wordpress.org/support/topic/use-classic-woocommerce-checkout-but-still-use-blocks-otherwise/
לאחר לחיצה על מעבר לתצוגה קלאסית , יש ללחוץ על עדכן למעלה , ולא ללחוץ על חזרה לבלוקס בטעות.
לביצוע טסטים
מומלץ לבצע רכישה בכרטיס אשראי במסוף ה אמיתי על 1 שקל (לא בטסט) בכדי לוודא כי המסוף תקין ולהשלים תהליך רכישה במלואו.
לעיצוב דף התשלום ראה מדריך זה : פרופיל נמוך : עיצוב דף מותאם אישית ( גרסה 5) CSS/HTML
הערות
0 הערות
המאמר סגור להערות.