מדריך חיבור הסליקה לחנות וורדפרס - Wordpress Woocommerce Payment WOO

מאפשר רכישות דרך החנות המקוונת שלך ב Wordpress (מסוג  הו-קומרס  Woo-commerce)  

לאחר התקנת התוסף, טופס הסליקה מוצג ללקוח לאחר בחירתו לשלם באמצעות כרטיס אשראי.
הטופס מוצג בHTML האתר באמצעות IFRAME או במעבר אל עמוד חדש (REDIRECT) לבחירתך.

תנאים להפעלת הסליקה באתר

• רכישת מודול פרופיל נמוך וקבלת הרשאות גישה API לחשבון.
• אתר בפלטפורמת wordpress בגירסא 6 ומעלה
  ( במקרה של שגיאת Peer's Certificate חובה לעדכן את ה  wordpress ל 6 ומעלה  )

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

** חדש - נתמך גם עם Woo Subscriptions למנויים באתר **
מדריך לחיבור עם תוסף Woo-Subscriptions - הגדרות ודרישות טכניות

קישור להורדת תוסף  Cardcom Payment Gateway

נמצא ברשימת התוספים הרשמית של אתרי WordPress, התוסף נקרא Cardcom Payment Gateway.

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

לאחר התקנת התוסף - הפעלתו

בשביל להפעיל את התוסף אנו נלך בוורדפרס ללשונית של "תוספים מותקנים", שם אנחנו נמצא את התוסף שלנו ונלחץ על "הפעלה"

לאחר מכן אנחנו נלך ללשונית של "ווקאמרס" -> "הגדרות" -> "תשלומים" -> בתוסף שלנו נלחץ על "ניהול" בשביל להגדיר את התוסף.

תמונות להמחשה:

השדות בהגדרות תוסף:

Title: תיאור אופן התשלום כפי שיוצג למשתמש באתר .( דרוש )
Enable/Disable: האם המודל פעיל .
Description: מלל חופשי למשתמש באתר .

Operation: סוג הפעולה לביצוע:

• Charge Only - חיוב בלבד (דרוש מודול פרופיל נמוך).
  
  
• Charge and save TOKEN - חיוב ושמירת אסימון ( לקוח שחוזר לאתר מונע הזנה של פרטי אשראי בפעם השנייה רק ) - דרוש מודול אסימונים בנוסף.
  
  
• Save TOKEN - שמירת אסימון בלבד  (מתאים לאתר מנויים - דרוש מתכנת) דרוש מודול אסימונים בנוסף
  שלב 1 - יש לקבל דיווח ב API לשרת המתכנת בכתובת זו דרך האדמין - ביצוע Notify נוסף / web hooks - ולהזין את הכתובת URL כאן - 
  https://secure.cardcom.solutions/Definition/LowProfile/GlobalDef.aspx
  שלב 2 - למשוך את האסימון - למטה שלב 2  : ממשק פרופיל נמוך - חיוב,יצירת אסימון וכו [שלב 1 + 2]
  שלב 3- חיוב אסימון ידני ב API לאחר מכן לפי מדריך : חיוב/ זיכוי אסימון (דרוש מודול אסימונים) - [שלב 3]
  
  
• Suspended Deal - עסקה מושהית  - משהה את העסקה ובעל העסק מחייב באיחור דרך המערכת של קארדום באתר לפי מדריך - >עסקה מושהית  - דרוש מודול עסקה מושהית.
• Suspended Deal -J2  - בדיקת סיפרת ביקורת עד ש.ב.א (ללא תפיסת מסגרת)
  Suspended Deal -J5 - תפיסת מסגרת אשראי ( דרוש אישור מחברות האשראי לכמה זמן ניתן לתפוס)
  
  
• Capture Charge : חיוב עסקה דרך ה WOO עצמו + דרוש J5 למסוף מחברות האשראי.
  מאפשר עריכת סכום הזמנה מהמערכת ניהול של האתר WOO וחיוב מהאתר הוורדפרס.
  כמו העסקה המושהית אבל העדכון והחיוב מתבצע מהצד של האתר וורדפרס בהזמנות .
  מאחורי הקלעים מתבצע יצירה וחיוב אסימון . (דרוש מודול אסימונים) (לא דרוש מסוף ללא CVV )
  בשינוי סטטוס ל   completed או ל  Processing  זה מחייב בפועל.
  Order Status: עדכון מצב ההזמנה לאחר ביצוע התשלום - לא רוולטי בפיצר זה , תמיד ההזמנה תהפוך ל ON-HOLD במצב של Capture Charge .
  רק בחיוב העסקה בפועל מומלץ לספק את המוצר / שירות .
  בנוסף יש V בדף תשלום למחזיק הכרטיס אם ירצה לשמור פרטים להבא שזה יזהה אותו.
  
  

Invoice: האם ליצור חשבונית עם חיוב אשראי:
יש לבדוק מול בית העסק האם רכש מודול מסמכים . רק אם כן לסמן YES , אחרת לסמן אפשרות Display only.
 
* לתשומת ליבכם כי הפעולות יופקו עבור לקוח מזדמן - לקוח כללי .
   כדי להטמיע הגדרה ליצירת כרטיסי לקוח יש צורך להכנס ללשונית הגדרות -> 4. סליקה בפרופיל נמוך -> 2. הגדרות כלליות.

ולסמן בהגדרות עוקפות API את האפשרות של יצירת כרטיס לקוח.

Terminal Number: מספר המסוף הייחודי כפי שניתן לכם כאשר פתחתם חשבון במערכת אישורית זהב. (אפשר להכניס רק מספר מסוף אחד)

API User Name: משתמש הממשקים של המסוף, (נשלח במייל לבעל העסק)

API Password: סיסמת המשתמש ממשקים לביטול וזיכוי עסקאות דרך ההזמנות של ווכאמרס (נשלח במייל לבעל העסק)

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

פעיל רק עבור 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: כתובת EMAIL לקבלת התראות ולוגים מהפלאגין במידה ויש בעיה .
במקרים נוספים של תקלות ב Woocommerce עצמו , על המתכנת להפעיל דיבאג ל WOO עצמו , ניתן להיעזר במדריך זה : https://docs.woocommerce.com/document/woocommerce-product-search/api/debugging/

הגדרות תצוגתיות :

PCI certification : האם לאפשר הזנת פרטי אשראי בתוך דף ה צקאווט - שימו לב פיצר ללא תקן PCI !
בהפעלת פיצר זה - לא ניתן לעבוד עם מודול עסקה בטוחה 3D SECURE
( לכן מומלץ לעבוד עם UseIframe=yes ולעצב את הדף תשלום )

UseIframe: האם להפעיל את המודל ב IFRAME, שים לב! לפי דרישות חברות האשראי יש לרכוש SSL לאתר שלך כאשר בכדי שהאתר יהיה ב HTTPS  ואז תוכל לעבוד עם IFRAME . עדיך להשתמש ב UseIframe=yes  ולעצב את הדף - > פרופיל נמוך : עיצוב דף מותאם אישית ( גרסה 5) CSS/HTML 

הגדרות למסמכים חשבונאיים:

Invoice VAT free: חשבונית תצא עם מע"מ 0 (מתאים ללקוחות שמוכרים לחו"ל).

Invoice will include Vat: (ברירת המחדל) - המחיר והחשבונית כולל מע"מ, המערכת תחלץ את המע"מ בחשבונית (בעוסק פטור זה תקין - יצא מסמך מתאים בהתאם להגדרות בקארדקום).

Invoice include Tax per product: מע"מ ברמת פריט! מאפשר ערבוב של מוצרים עם ובלי מע"מ.

Invoice include VAT by country: מע"מ ברמת מדינת השילוח בהזמנה, ישראל כולל, לא ישראל ללא מע"מ.
* מומלץ להשתמש ב אפשרות בתוך הגדרות המסוף(שימו לב להגדרות ברמת שפת הדף) גם להוציא חשבונית עם מע"מ 0 ללקוחות לפי כתובת IP מחו"ל .

Order Status: עדכון מצב ההזמנה לאחר ביצוע התשלום

failed Url (3.5.1.0): נכון לגרסה העדכנית, אין שדה כתובת כשלון בפלאגין שלנו.

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

success Url (3.5.1.0): נכון לגרסה העדכנית, אין שדה כתובת הצלחה בפלאגין שלנו.

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

Invoice for Paypal: (אופציונלי) האם להפיק חשבונית ב Paypal דרך כפתור חיצוני ( שאינו נמצא על טופס הסליקה)

Invoice for Paypal - Send to email: האם לשלוח את החשבוניות של פיפאל למייל .

ליצירת חשבוניות PAYPAL חיצוני (כפתור מחוץ לדף התשלום)

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

מומלץ לבחור בכפתור פנימי - כי המסמך החשבונאי נשלח באופן מיידי אחרי השלמת העסקה דרך PAYPAL
במקרה שימוש בכפתור חיצוני יש לשנות את ההגדרה "Invoice for Paypal" ל-YES

אפשרות לכפתור PAYPAL פנימי (מופיע על דף התשלום)

הגדרת כפתור Paypal על דף הסליקה

במקרה של תקלה בדיווחים או בסגירת ההזמנה באתר
כמו  The remote server returned an error: (400) Bad Req

יש לפנות לחברת איחסון ולבקש לפתוח את כל טווחי הכתובת הבאים בחומת האש של החברה
( גם ב cloudflare למי שיש )

- 82.80.227.17/255.255.255.248 (CIDR 29) >> מחשבון subnet

- 82.80.222.124/255.255.255.248 (CIDR 29) >> מחשבון subnet

במקרה של :

יש לנטרל תוסף קאש ב באתר 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