מדריך להגדרת סליקת iCredit – WooCommerce

בכדי להתקין את הפלאגין יש לבחור ב-Plugins ואז ב-Add New.

יש ללחוץ על Upload Plugin ואז לבחור בקובץ הרצוי

לאחר מכן יש ללחוץ על Install Now

ואז על הפעלת הפלאגין בלחיצה על Activate Plugin

לאחר ההתקנה יש להיכנס להגדרות הפלאגין תחת התפריט של WooCommerce

לאחר מכן יש ללחוץ על Settings

ולהיכנס לחוצץ Payments (או Checkout בחלק מהמקרים)

יש ללחוץ עלPayment  iCredit מתוך רשימת שיטות התשלום בכדי להיכנס להגדרות הפלאגין

הגדרה ראשונית

להלן הנחיות להפעלת הפלאגין אל מול מסוף סביבת הייצור של העסק:

תחת מסך ההגדרות הראשי של הפלאגין בשם General Settings

יש להדביק את מזהה דף התשלום (Group Private Token) אשר התקבל לאחר ההתקנה במייל ההתחברות מהמוקד (מגיע מהכתובת[email protected] )

* במידה ואין גישה לממשק אייקרדיט יש לפנות למוקד בטלפון 03-7466300 שלוחה 3

חשוב! יש לוודא כי המזהה הודבק במלואו בצורה תקינה

לאחר מכן יש לעבור לחוצץ ההגדרות בשם Technical Settings

יש להגדיר תחתIPN Protocol את סוג הפרוטוקול התואם לכתובת האתר (HTTPS עם תעודת SSL/HTTP ללא תעודת אבטחה)

יש להגדיר תחת Payment Window Mode את תצוגת דף התשלום הרצויה (Redirect\iFrame\PopUp)

ביצוע בדיקות מול סביבת הטסט (Sandbox)

לאחר שבוצעו ההגדרות הראשוניות יש להיכנס לחוצץ General Settings

ולסמן את האופציהTest Mode

יש לוודא כי שמור מזהה תחת Test Group Private Token (הפלאגין מותקן מראש עם מזהה קיים לצורך בדיקות)

במידה ולא קיים מזהה ניתן להשתמש במזהה הבא:

80283c37-1e16-4fe3-8977-203d5180d1fa

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

4580000000000001 

או

4580000000000003

‫יתר הערכים ולידיים

ביצוע עסקה ראשונה לבדיקה מול סביבת הייצור

לאחר שהושלמו כל ההגדרות יש לבצע באתר עסקה לבדיקה על סכום הגבוה מ – 20 ש”ח כדי לראות שהמסוף עובד ותהליך התשלום באתר תקין.

הזמנה שלא חויבה בהצלחה תהיה עם סטטוס ‘ממתין לתשלום‘ (Pending Payment)

הזמנה שחויבה בהצלחה תהיה עם סטטוס ‘בטיפול‘ (Processing)

שים לב!

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

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

** במידה וסטטוס ההזמנה לא השתנה בהתאם למרות שהעסקה חויבה בהצלחה יש לפנות למוקד התמיכה של אייקרדיט

שפות

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

את מזהה דף התשלום של השפה הראשית שתוצג בכניסה לאתר יש לשמור תחת מסך ההגדרות הראשי General Settings בשדה מזהה דף התשלום (Group Private Token) כפי שנרשם בהסבר של – הגדרה הראשונית.

להגדרת שפות משניות יש להיכנס לחוצץ Languages

יש להדביק את מזהה דף התשלום של הדף בהתאם לשפה שבה הוא מוגדר באייקרדיט

מטבעות

אין צורך לבצע בפלאגין הגדרה למטבעות.

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

להלן רשימת המטבעות הנתמכים בהתאם לאופציות הקיימות מול חברות האשראי/שב”א:

שקל, דולר, יורו, ליש”ט, דולר אוסטרלי, דולר קנדי, פרנק שוויצרי, קרונה שבדית, קרונה דנית, קרונה נורבגית.

** במידה ויבחר מטבע אשר לא נתמך, ברירת המחדל תהיה שקל.

טוקניזציה (שמירת כרטיס לשימוש חוזר)

ניתן להשתמש במנגנון המובנה של ווקומרס לצורך שמירת כרטיסים לחיוב חוזר של הלקוח

שים לב – בעת חיוב הכרטיס השמור לא יהיה ניתן לבצע עסקת תשלומים.

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

• האם קיים שירות טוקניזציה פעיל במשתמש העסק ב- iCredit(השירות הינו בתשלום נוסף)
• האם המסוף פתור מדרישה ל-CVV (הבדיקה נעשית ע”י המוקד מול שב”א)

הגדרת טוקניזציה

בכניסה לחוצץ הראשי General Settings

יש לסמן את האופציה שלCreate Token

לאחר הפעלת השירות ניתן יהיה לראות בעמוד ה-Checkout של האתר – תחת בחירת סוג התשלום של אייקרדיט שנוספה ללקוח האופציה “Save to account” אשר תבצע שמירה לכרטיס בעת החיוב.

עסקה ממתינה J5

הפלאגין תומך במימוש מלא של עסקה ממתינה – יצירה חיוב

** ניתן להשתמש בעסקה מידית או ממתינה (לא במקביל)

להגדרת העסקה כממתינה יש להיכנס לחוצץ Payment Settings

יש לשנות את השדהSale Type Mode ל-On Hold/J5

לאחר יצירת עסקה ממתינה תתווסף בדו”ח המכירות בממשק אייקרדיט מכירה עם סטטוס ‘ממתינה‘

חיוב עסקה ממתינה

ניתן לקבוע את תנאי החיוב בשדות הנוספים:

• שדה Charge J5 By Bulk  – חיוב ממתינה בצורה מרוכזת דרך Bulk (סימון ברשימת הזמנות ושינוי סטטוס)

ניתן לבצע חיוב מרוכז של כמה עסקאות מתוך מסך ניהול ההזמנות ע”י סימון ההזמנה הרצויה ושינוי הסטטוס שלה.

לצורך כך יש לשנות את השדה ל-Yes

• שדה Bulk J5 Charge Status –  קביעת הסטטוס לפיו יתבצע החיוב בעת השינוי (מומלץ סטטוס Completed)

• השדה ב-Change J5 Details –האם לקבלשינוי של פרטי ההזמנה וסכום החיוב של הממתינה.

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

במידה ונדרש לבצע שינויים בעת החיוב יש לשנות את השדה ל-Yes

האופציה הנ”ל תשפיע גם על דו”ח המכירות שירשם בממשק אייקרדיט:

No – לאחר חיוב סטטוס המכירה שנוצרה בעסקה הממתינה ישתנה מ-‘ממתינה‘ ל-‘חויבה‘ (לא תתווסף שורה נוספת בדו”ח.

Yes – המכירה של העסקה הממתינה תישאר כפי שהיא עם סטטוס ‘ממתינה‘ ותתווסף שורה של מכירה חדשה עם סטטוס ‘חויבה‘ שבה יוצגו כל הפרטים שנשלחו בחיוב (במידה והסכום השתנה יהיה הבדל בין השורות)

שימוש בשני מסופים לתהליך טוקניזציה (בהתאם לדרישה של חברת האשראי)

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

מסוף לצורך חיוב ראשוני ויצירת טוקן – עם דרישה ל-CVV

מסוף שני לצורך חיוב טוקן הכרטיס השמור – ללא דרישה ל-CVV

** יש לפנות למוקד לעזרה לצורך יצירת דפי התשלום בהתאם והגדרתם בפלאגין

הגדרת שני מסופים שונים

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

את המזהה דף תשלום של המסוף הנוסף לחיוב הטוקן של הכרטיס השמור יש להגדיר באותו חוצץ

לאחר הפעלת מנגנון הטוקניזציה בסימון Create Token יתווסף השדה Second Group PrivateToken

שפות נוספות במקרה של שני מסופים

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

תחת החוצץ Languages יש לשמור את המזהה דף בהתאם לשפה

הו”ק

נכון להיום לא קיימת תמיכה מלאה בפלאגין למימוש הו”ק

ניתן לבצע יצירה של הו”ק עם תנאים קבועים – לעזרה בנושא יש לפנות למוקד התמיכה של אייקרדיט.

** ניהול ההו”ק שהוקמו מתבצע בממשק אייקרדיט בלבד

פריטים וניהול מלאי

איתור פריטים

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

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

יש להגדיר בכל פריט באתר את המק”ט (SKU) בהתאם למה שמוגדר על הפריט בריווחית.

** ערך המק”ט צריך להיות ייחודי לכל פריט כדי שיתבצע איתור תקין

הגדרת מק”ט לפריט מסוג משלוח

נכון להיום ב-WP לא קיימת אופציה מובנית לשמירת מק”ט תחת הגדרת המשלוח

בהגדרות הפלאגין ניתן לבצע שמירה של מק”ט לפי המשלוחים הקיימים באתר.

לצורך שמירת המק”ט יש להיכנס לחוצץ Payment Settings

לאחר סימון האופציה Shipping SKU יופיע שדה עבור כל סוג משלוח שקיים באתר

יש לשמור בשדה של המשלוח את המק”ט הרצוי

שימוש מותאם אישית – עבור מתכנתים

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

לצורך כך יש להיכנס לחוצץ ההגדרות Technical Settings

דף תודה מותאם אישית

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

ניתן לשמור את הקישור הרצוי תחת השדה Thank You Page URL

אינטגרציית IPN מיוחדת

ניתן לשמור נתיב שונה עבור קבלת נתוני העסקה שנשלחים ב-IPN משרת אייקרדיט לאתר לאחר החיוב (כיום הודעה זו שמתקבלת בנתיב אחראית על שינוי סטטוס ההזמנה ושמירת פרטי העסקה והמסמך/קבלה בהזמנה באתר)

ניתן לבטל תהליך זה במידה וקיים צורך אחר ולשמור בשדה IPN Integration את הנתיב הרצוי לקבלת המידע.

שיטת שליחת ה-IPN

כיום שיטת שליחת המידע ב-IPN המומלצת היא בצורת Post במידה ומסיבה כלשהי האתר לא יכול לקבל כך את המידע ניתן לשנות זאת בשדה IPN Method לקבלת המידע בשליחה דרך Get

הסבר על לוגים קיימים ולוגים אופציונליים

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

בהפעלת הלוגים הנוספים יכתבו ללוג גם נתוני הודעת ה-IPN עם פרטי העסקה ו-Request המתודות GetUrl/SaleChargeToken שנשלחו לאייקרדיט

סימון האופציות הנ”ל יבצע שמירה של הלוגים הנוספים