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

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

על מנת להפעיל אפשרות זו לכלל דפי הנחיתה יש לבצע הגדרה מתאימה בהגדרות >5. אישורית זהב > 2. הגדרות לפי שפה. למטה הגדרות למפתחים

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

מערכת הסליקה תבצע פנייה לדף לאחר סליקה שמבוצעת בפרוטוקול HTTP GET / POST עם הפרמטרים הבאים ( ראה דוגמה בסוף )

או בהגדרה לדף ספציפי בלבד נכנס אל לשונית פעילות שוטפת->4. דף נחיתה לתשלום

נערוך את דף הנחיתה ע"י לחיצה על העיפרון הכחול-> נעבור אל לשונית "מתקדם"

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

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

הערות:

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

שים לב ! יתכן ועם הזמן יתווספו פרמטרים נוספים לטבלה זו.

מספר	פרמטר	ערכים אפשריים לדוגמה	תיאור
1	responsecode	0 - חיוב בהצלחה אחרת חיוב נכשל	קוד תשובה של ביצוע העסקה
2	xparameter	123	פרמטר מוחזר : ערך הפרמטר DealIdentityCode שמועבר לדף הסליקה. ראה : טבלת פרמטרים : העברת פרמטרים לדף אישורית מספרים בלבד!
3	terminalnumber	1000	מספר מסוף מבצע העסקה
4	ReturnData	AFFI123	פרמטר מוחזר של הנתונים שהתקבלו ב העברת פרמטרים אל דף אישורית זהב 4 , מחרוזת 25 תווים
5	internaldealnumber	12345	מזהה ייחודי של העסקה במערכת אישורית זהב. רצוי לשמור פרמטר זה
6	suminfull	1.00 עבור שקל. 1 עבור עסקה של שקל. (מקבלים סימן נקודה)	סכום עסקה בעשרוני
7	suminagorot	100 עבור עסקה של שקל. 150 עבור עסקה של שקל וחצי. (לא מקבלים סימן נקודה)	סכום העסקה באגורות
8	cointype	0 : מטבע ISO 1 : שקל 2 : דולר 4 : תשלומים דולר 8 : תשלומים שקל	מטבע חיוב
9	ApprovelNumber	0012345	מספר אישור לעסקה מחברות האשראי
10	responsdescription	תקין	תיאור התשובה בהתאם לקוד התשובה responsecode
11	ProdName	אופניים עם 4 גלגלים	שם/תיאור המוצר הנרכש בריבוי פריטים שנרכשו ("בחירה מרובה"), פריט ראשון יופיע ProdName, שני ואילך ממוספרים. (ProdName, ProdName1, ProdName2...)
12	ProdGroupID	2	מספר הקבוצה / הדף שאליה שייך המוצר. בהתאם מספר הקבוצה / הדף שמופיע במערכת הניהול
13	GroupDescription	קורסים	תיאור שם קבוצה/דף
14	ProdItemID	2	מספר הפריט . בהתאם למספר הפריט שמופיע במערכת הניהול של קארדקום.
15	ProdQuantity	1	כמות שנרכשה עבור פריט בריבוי פריטים שנרכשו ("בחירה מרובה"), פריט ראשון יופיע ProdItemID, שני ואילך ממוספרים. (ProdQuantity, ProdQuantity1, ProdQuantity2...)
	ProdPrice	50	מחיר הפריט הנרכש
16	CardOwnerName	אלי כהן	שם בעל הכרטיס
17	CardOwnerPhone	050-8855444	טלפון בעל הכרטיס
18	CardOwnerID	123456789	תעודת זהות בעל הכרטיס
19	Lest4Numbers	5874	4 ספרות של סיומת כרטיס
20	MutagName	ויזה כאל	שם מותג הכרטיס ראה: קודי מותג
21	MutagId	2	קוד המותג ראה: קודי מותג
22	UserEmail	MyEmail@Site.com	כתובת דואר שהוקלד
23	UserIP	UserIP	כתובת IP של המשתמש
24	ProductID	AVCD123	קוד פריט / מק"ט כפי שהמשתמש הגדיר על הפריט. בריבוי פריטים שנרכשו ("בחירה מרובה"), פריט ראשון יופיע ProductID, שני ואילך ממוספרים. (ProductID, ProductID1, ProductID...)
25	AffiliateID	123	קוד רשימת התפוצה שנבחרה
26	DelivarySum	100.12	סכום המשלוח שנבחר
27	DelivaryProductID	ABC	קוד מוצר משלוח
28	NumberOfPaymentsToPrint	6	מספר תשלומים כולל
29	FirstPayment	13	בעסקת תשלומים מה סכום התשלום הראשון יש לחלק חלקי 100 , הסכום מופיע באגורות
30	ConstPayment	123	בעסקת תשלומים מה הסכום שאר התשלומים יש לחלק חלקי 100 , הסכום מופיע באגורות
	NumberOfPaymentsToPrint	3	מספר תשלומים כולל שמודפס על החשבונית
31	IsTrumaDebite	true	האם מצב תרומה
32	NumOfPaymentForTruma	12	מספר תשלומים במצב תרומה
	AffiliateID	12	מספר אפליאט אי די / מספר הדף
33	RecurringCode	0 - הצלחה אחרת כישלון	במידה ומוסיפים להוראת קבע בענן קוד התשובה של ההוספת
34	RecurringIsNewAccount	true	הוראת קבע בענן : האם נוצר חשבון לקוח חדש
35	RecurringAccountID	123	הוראת קבע בענן : מספר חשבון לקוח החדש
36	RecurringOrderID	3	הוראת קבע בענן : מספר הוראה לחיוב
37	CardYear	2019	תוקף הכרטיס YYYY
38	CardMonth	12	תוקף הכרטיס חודש M
39	Token	4cf8e168-XXXX-4613-XXXX-000332986b24	אסימון הכרטיס – רק למי שיש מודל הוראת קבע בענן בהרשאות למסוף.
40	SuspendedDealId	1451512	מספר עסקה מושהית שנוצרה
41	screamid	1055	מספר scream למי שעובד עם ממשק זה
42	TotalCommition	2.5	עמלה שחברת UPAY גבתה במקרה של תשלומים בקרדיט במסופי UPAY
43	CreditCardIssuer	Tourist Isracard CAL Diners American Express JCB MAX	מנפיק הכרטיס

פרטי חשבונית

מספר	פרמטר	ערכים אפשריים לדוגמה	תיאור
1	invNumber	123	מספר חשבונית
2	invType	1 : חשבונית מס / קבלה 2 : קבלה תרומה	סוג חשבונית
3	invResponseCode	0 : חשבונית נוצרה אחר קוד השגיאה של יצירת חשבונית	קוד תשובה ליצירת חשבונית
4	intTo	משה	חשבונית לכבוד
5	invCompanyID	012345678	תעודת זהות / ח.פ לחשבונית
6	intCity	אילת	חשבונית עיר
7	InvAddress		חשבונית כתובת שורה אחת
8	InvAddress2		חשבונית כתובת שורה 2
9	InvPhone		טלפון חשבונית
10	InvMobile		טלפון נייד חשבונית
11	CouponNumber	12GF11	מספר קופון שהוכנס במערכת
	ProdPrice	50	מחיר פריט
12	ProdTotalLines	2	מספר כולל של שורות מסמך

פרמטרים למשלוח ( הפעלת שדות למשלוח בעיצוב חדש בלבד )

מספר	פרמטר	ערכים אפשריים לדוגמה	תיאור
1	DelivaryProductID	delivery normal	קוד המשלוח , קוד פריט לחשבונית
2	DeliveryCity	חולון	עיר למשלוח
3	DeliveryStreet	הרוקמים	רחוב למשלוח
4	DeliveryBuilding	26	מספר בית
5	DeliveryApartment	4	מספר דירה
6	DeliveryFloor	1	קומה
7	DeliveryEntrance	ב	מספר כניסה
8	DeliveryNotes	הערות עד 250 תווים	הערות לשליח
9	DeliveryMethod	2	מספר קוד המשלוח, מספר תוספת

שדות מותאמים אישית:

בנוסף לפרמטרים הקבועים ישנם שדות מותאמים אישית המועברים גם הם:

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

אזי יופיע בוובהוק: Custom22=example2024).

שם שדה	תיאור שדה
Custom19	קוד קבוצה
Custom20	מספר תשלומים
Custom21	קוד פריט
Custom22	מספר קופון
Custom23	כמות
Custom24	תיאור פריט

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

לדוגמה אם הלקוח הקליד ערך בשדות מספר 4 ו8 מה שיעבור הוא :

Custom04=Today&Custom08=Male

דוגמה לפנייה:

http://www.yoursite.co.il/yourpage.aspx?responsecode=0&UserEmail=yaniv@smsendsr.co.il&suminfull=120.50 .....

שם לב!

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

ניתן לראות LOG של הדיווח על העסקה עצמה בדוחות סליקה יש ללחוץ על העסקה עצמה .

ולאחר מכן יש ללחוץ על לשונית ממשקים .
ניתן לבדוק את הדיווחים כאן.

הטיים אווט של הדיווחים הם 10 שניות בדיווח הראשון .

אם לא מצליח שולח שוב ושוב 7 ניסיונות

ניתן להיעזר באתר זה :

https://meyerweb.com/eric/tools/dencoder/

אתר Webhook חינמי לבדיקות :
https://webhook.site/#!/1e592943-0f07-4f7c-819d-c35f63db860a

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

* במקרה של תקלה בדיווח עסקה מהשרת של קארדקום לשרת של הלקוח *

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

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

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

בנוסף יש לפתוח כמובן PORT ים : 80 , 8080 , 443 .