הסבר דוח פעילות פרופיל נמוך (למתכנת)

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

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

 

מצבי עסקה : 

הצלחה - בוצע החיוב בהצלחה

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

לא הגיע - מחזיק הכרטיס לא הגיע לדף התשלום , בדרכלל לא יהיה גם כתובת IP מחזיק כרטיס בטבלה גם

לאחר מכן
ניתן להיכנס ל מידע למפתח

לשונית - פרטי תשובה לעסקה אחרונה
בדיווח , תיאור התשובה שהשרת של המתכנת השיב לנו לאחר הדיווח עסקה ב API - מומלץ להחזיר לנו oK או -1 לתקינות .

כתובת פנייה : ניתן להעתיק ולראות את כל הפרמטרים עם הפניה חזרה שאנו השבנו לאתר ל IndicatorUrl .

מספר ניסיונות לפניית דיווח:

אם שרת בית העסק לא מחזיר תשובת HTTP-200 השרת של קארדקום יפנה שוב ושוב לדיווח העסקה 7 פעמים:
[ הטווח בדקות לדיווח שני והלאה: 1 דקה , 2 , 2 , 16 , 60  דק, 12 שעות , 12 שעות ]. 

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

תחת לשונית - פרטי בקשה לחיוב

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

דוגמאות לשגיאות :

 The remote server returned an error: (503) Server  

 The remote server returned an error: (400) Bad Req

The remote server returned an error: (403) Forbidden
 

דוגמא - The operation has timed out
השרת של המתכנת השיב לשרת שרת טיים אווט - יש לפנות לחברת אחסון לבדיקה

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

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

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

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

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


 

דוגמא באתרי WOO קומר :  דיווח של 1-  זה תקין 

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

פרטי חיוב

קוד פרופיל נמוך

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

סוג פעולה

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

• חיוב בלבד.

• חיוב ויצירת אסימון.

• יצירת אסימון בלבד.

• עסקה מושהית בלבד.

• חיוב מיידי עם אימות 3DS.

• גביית חוב הוראת קבע.

• דרישה לתשלום.

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

תאריך יצירה

התאריך והשעה שבהם נוצרה בקשת התשלום.

שם מוצר

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

סכום לחיוב

הסכום שהוגדר לחיוב בבקשה.

מטבע

המטבע שהוגדר לחיוב. השדה מוצג רק אם הוגדר מטבע בבקשה.

מצב

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

API Level

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

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

הפניות

כתובת הצלחה

הכתובת שאליה מופנה הלקוח לאחר תשלום שהצליח.

כתובת כשלון

הכתובת שאליה מופנה הלקוח כאשר התשלום נכשל.

כתובת דיווח עסקה

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

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

כתובת לחצן בטל

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

ערך להחזרה

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

פרמטרים שונים

מספר תשלומים מקסימלי

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

מספר תשלומים מינימלי

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

שפה

שפת התצוגה שהוגדרה לדף התשלום שהוצג ללקוח.

הסתר ת.ז.

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

הסתר CVV

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

סוג אשראי חיוב

סוג עסקת האשראי שהוגדר לחיוב, למשל רגיל, תשלומים או קרדיט.

פרמטרים שונים

פרמטרים נוספים שהועברו עם הבקשה, אם הוגדרו.

Return Value

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

הצג AVS

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

האם לפתוח חלון PinPad

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

פרמטרים לעסקה מושהית ולאסימון

קבוצה עסקה מושהית

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

עסקה מושהית מאפשרת לשמור הרשאת חיוב לביצוע במועד מאוחר יותר.

סוג בדיקה מושהית

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

תוקף אסימון

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

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

סוג בדיקה אסימון

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

ניסיונות חיוב כרטיס אשראי

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

מספר עסקה

מספר העסקה במערכת. לחיצה עליו פותחת את פרטי העסקה.

קוד תשובה

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

4 ספרות אחרונות

ארבע הספרות האחרונות של הכרטיס ששימש בניסיון החיוב.

שם בעל הכרטיס

שם בעל הכרטיס כפי שהוזן בדף התשלום.

תאריך

התאריך והשעה שבהם בוצע ניסיון החיוב.

תיאור תשובה

תיאור מילולי של תוצאת הניסיון.

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

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

תיאור התשובה מהשרת לדיווח

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

מספר מסוף

מספר המסוף שדרכו בוצעה העסקה.

קוד מצב פנימי דיווח

קוד מצב פנימי המציין את שלב הטיפול בבקשה.

User Agent

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

כתובת פנייה

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

• בגרסת ממשק ישנה: מוצגת כתובת הפנייה שבוצעה בפועל, כולל הפרמטרים שנשלחו.

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

מידע פנייה

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

מספר נסיונות לפניה

מספר ניסיונות הדיווח שבוצעו לשרת שלכם.

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

תאריך ניסיון הבא

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

פרטי תשובה לעסקה אחרונה – תשובה חיוב כרטיס

סעיף זה מוצג עבור בקשות שכללו חיוב כרטיס.

קוד

קוד התשובה שהתקבל מחברת האשראי עבור החיוב.

תיאור

תיאור מילולי של תוצאת החיוב.

מספר עסקה פנימי

מספר העסקה הפנימי במערכת עבור החיוב.

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

סעיף זה מוצג עבור בקשות שכללו יצירת אסימון.

קוד

קוד התשובה של פעולת יצירת האסימון.

תיאור

תיאור מילולי של תוצאת יצירת האסימון.

אסימון כרטיס

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

ת.ז. בעל הכרטיס

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

תוקף כרטיס שנה

שנת התוקף של הכרטיס שנשמרה עם האסימון.

תוקף כרטיס חודש

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

מספר אישור J5 בלבד

מספר האישור שהתקבל עבור עסקת בדיקת תקרה, J5, אם בוצעה.

מספר תשלומים

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

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

סעיף זה מוצג עבור בקשות שכללו יצירת עסקה מושהית.

קוד

קוד התשובה של פעולת יצירת העסקה המושהית.

תיאור

תיאור מילולי של תוצאת יצירת העסקה המושהית.

מספר עסקה מושהית

המזהה של העסקה המושהית שנוצרה. מזהה זה משמש לביצוע העסקה בהמשך.

קבוצה עסקה מושהית

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

פרטי תשובה לעסקה אחרונה – תשובה חשבונית

סעיף זה מוצג עבור בקשות שכללו הפקת חשבונית.

קוד

קוד התשובה של פעולת הפקת החשבונית.

תיאור

תיאור מילולי של תוצאת הפקת החשבונית.

מספר חשבונית

מספר החשבונית שהופקה.

סוג חשבונית

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

פרטי חשבונית ליצירה – כותרת חשבונית

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

שם לקוח

שם הלקוח שיופיע על החשבונית.

האם לשלוח באימייל

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

שפת החשבונית

השפה שבה תופק החשבונית.

דואר לקוח

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

כתובת שורה 1

שורת הכתובת הראשונה של הלקוח, כפי שתופיע על החשבונית.

כתובת שורה 2

שורת הכתובת השנייה של הלקוח, כפי שתופיע על החשבונית.

עיר

עיר הלקוח, כפי שתופיע על החשבונית.

טלפון קווי

מספר הטלפון הקווי של הלקוח.

טלפון נייד

מספר הטלפון הנייד של הלקוח.

מספר ת.ז. או ח.פ חברה

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

הערות לחשבונית

הערות חופשיות שיודפסו על החשבונית.

מטבע

המטבע שבו תופק החשבונית.

ללא מע"מ

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

צור/ עדכן כרטיס לקוח

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

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

מפתח זר

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

מזהה נוסף

מזהה נוסף שניתן לשייך לחשבונית לצורך הצלבה עם נתונים במערכת שלכם.

פרטי חשבונית ליצירה – פריטים לחשבונית

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

תיאור

תיאור הפריט.

מחיר יחידה

המחיר של יחידה אחת מהפריט.

כמות

מספר היחידות של הפריט.

הוסף מעמ למחיר פריט (לא בשימוש)

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

קוד מוצר

קוד המוצר של הפריט במערכת.

פריט פטור מעמ

מציין אם הפריט הוגדר כפטור ממע"מ.