אשראית - "א תכנת שב
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
תכנת שב"א -אשראית
®
PC
גרסה 5.98
כל הזכויות שמורות
אין להעתיק או לשדר מסמך זה או קטעים ממנו בשום צורה ובשום
אמצעי אלקטרוני או מכני ,לכל מטרה שהיא ,ללא אישור מפורש בכתב
מחברת שב"א.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
-1-
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
תוכן עניינים
1
ריכוז שינויים 6 ............... ................................ ................................
1.1
שינויים באשראית 6 ........................................ ................................
1.1
שינויים בבמסמך ERROR! BOOKMARK NOT DEFINED. .......................
1
מידע כללי 7 .................... ................................ ................................
1.1
חברות האשראי 7 ............ ................................ ................................
1.1
אפשרויות הפעלת התוכנה 7 .............................. ................................
1.2
מידע כללי – בדיקות 8 ...................................... ................................
1.2.1
בדיקות ברמת המסוף 8 .................................. ................................
1.2.1
שאילתא -בקשה לאישור ע"י התקשרות 8 ........................................
2
ממשק שב"א -אשראית 6 ............................ ................................ 66
2.1
שלבי הטיפול בעסקה 6 .................................... ................................
4
פונקציות מערכת אשראית 11 ........................ ................................ 66
4.1
הקמה 11 ...................... ................................ ................................
4.1
שידור (ע"י הפעלת תוכנית TRANSMITאו 12 ...................... )TRANS95
4.2
הקרנת סיכומים לשידור -מתאריך רצוי 12 ..........................................
4.4
הקרנת רשומות שגויות 14 ................................ ................................
4.4
בדיקת קובץ תנועות 14 ..................................... ................................
4.6
תוכן קבצים 14 ............... ................................ ................................
4.7
בדיקה התאמה בין קבצי קלט פלט ותנועות 14 ......................................
4.8
הקרן או הדפס תוכן שידורים 14 ........................ ................................
4.6
תוצאות בדיקת עסקאות ע"י תוכנית ממשק של שב"א 14 ........................
4.14
עדכון נתוני מסוף 14 ....................................... ................................
4.11
טיפול בעסקאות 16 ........................................ ................................
4.12
שינוי פרמטרים לטיפול בעסקאות 16 ................. ................................
4.12
שידור באמצעות טלפון חד פעמי 16 ................... ................................
4.14
כלים לעזרה 16 ............. ................................ ................................
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
-2-
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
4.14
תוכנית עזר 16 .............. ................................ ................................
4
סוגי העסקאות במערכת 17 ................................ ................................
6
סוגי האשראי -ישראכרט /אמקס (אמריקן אקספרס) 18 ........................
7
סוגי האשראי – כ.א.ל ,דיינרס 16 ....................... ................................
8
סוגי האשראי -לאומיקארד 14 .......................... ................................
6
קובץ הקלט11 ..................................... ................................ INT_IN
14
קובץ הפלט 17 .................................... ................................ INT_OT
11
אופציות מיוחדות לשימוש בתוכנית הממשק (24 .................. )INTRFACE
11.1
שימוש בתוכנית הממשק כ DOS( TSR -בלבד) 21 ................................
11.1
העברת קבצי INT_IN , INT_OTדרך הזיכרון ( DOSבלבד) 21 ................
11.2
הסבר לשיטת רישום של קובץ TRANע"י 21 ...................... INTRFACE
11.4
העברת עסקאות דרך תוכנית INTRFACEללא אפליקצית משתמש 21 ....
11.4
דוגמאות למיקום קבצים 21 ............................ ................................
11
קריאת פונקציות מתוך 22 ............. ................................ INTR32.DLL
11.1
א ראשונה 24 ................ ................................ ................................
11.1
שניה 24 ...................... ................................ ................................
12
קריאה ל INTR32.DLL-ממג'יק 24 ...................... ................................
12.1
כללי 24 ....................... ................................ ................................
12.1
אופן הקריאה ממג'יק 24 ................................. ................................
14
רשימת תוכניות -מערכת אשראית 27 ............. ................................ 66
14
רשימת קבצים -מערכת אשראית 28 ............... ................................ 66
16
מבנה קובץ 26 ........................................ ................................ JENR
17
מבנה קובץ 26 ........................................ ................................ DATA
18
מבנה קובץ 44 ..................................... ................................ STATIS
16
קבצי DUMPו41 ......................... ................................ DUMPALL -
14
מבנה קובץ ( ISO 46ראה נספח – 4עבודה במט"ח) 41 ............................
11
רב ספק /רב מוטב 42 ....................................... ................................
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
-3-
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
11
טופס פתקית ללקוח 44 ..................................... ................................
12
מערכת אשראית -עבודה ברשת 44 ..................... ................................
12.1
תוכנית ממשק 44 ................ ................................ INTRFACE.EXE -
12.1
תוכנית עצמאית 41 ........................................ ................................
12.2
העברת עסקאות לחברות האשראי 41 ................ ................................
14
שרת אשראית 41 ............. ................................ ................................
14.1
כללי 41 ....................... ................................ ................................
14.1
מהלך עבודה41 ............ ................................ ................................ .
14.2
תצורות עבודה 41 ........... ................................ ................................
14.2.1
ניהול מסוף בודד בשרת42 ........................... ................................ .
14.2.1
ניהול מספר מסופים בשרת44 ...................... ................................ .
14.4
14.4.1
התקנה והפעלה שרת אשראית44 .................... ................................ .
כמות קישורים במקביל46 ........................... ................................ .
14.4
הערות כלליות46 .......................................... ................................ .
14.6
שידור תנועות47 .......................................... ................................ .
14.7
קודי שגיאה המוחזרים על-ידי שרת אשראית47 ................................ .
14.8
48 .............. ................................ CALLSERV.DLL
14
אשראית 64 ............ ................................ ................................ WEB
25.1
כללי64 ...................... ................................ ................................ .
25.2
אבטחת מידע61 .......................................... ................................ .
14.2
שרידות 61 ................... ................................ ................................
14.4
פונקציות ה61 ..................... ................................ .WEB SERVICE -
14.4.1
61 ................. AUTHCREDITCARDFULL
14.4.1
67 ................... AUTHCREDITCARDGAS
14.4.2
66 .............. DEPOSITTRANSACTIONS
25.4.4
74 .............. DEPOSITTRANSACTIONSEX
14.4.4
74 .......GETDEPOSITINFORMATION
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
-4-
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
14.4.6
71 ........................... CHANGEPASSWORD
14.4
מבנה של 71 ..................................... ................................ INT_OT
14.6
קודי שגיאה המוחזרים על-ידי אשראית 74 ............................... .WEB
16
מערכת אשראית -התקשרות 76 ......................... ................................
16.1
להלן הסבר לגבי כל אחד מהפרמטרים77 ......................................... :
16.1
כיצד מזהים באם התקשורת הסתיימה בהצלחה? 77 ............................
16.2
בדיקת תוצאות שידור 78 ................................. ................................
16.4
תקלות בתקשורת78 ..................................... ................................ .
נספח 1קודי סטטוס 81 ..................... ................................ ................................ .
נספח - 1תוצאות בדיקת 84 ............................ ................................ UCAF/CAVV
נספח – 2הנחיות למפיצים לשילוב כרטיסים נטענים/מתנה 86 ...................................
נספח – 4הנחיות למפיצים לשילוב תמיכה בסליקה רב מטבעית64 ............................ .
נספח – 4הוראות שימוש לתוכנית 62 .................... ................................ .STUNNEL
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
-9-
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
1
ריכוז שינויים
1.1שינויים באשראית
.aבגרסה 4.68בוצע תיקון עבור כרטיסי contact lessשל ויזה בהנפקת ישראכרט ולאומי קארד (
)Wave
Pay
.bהחל מגרסה 4.67ניתן לעבוד עם קורא כרטיסים מצפין לצורך מניעת זליגה של הנתונים הרגישים.
וכן התווספו ערכים נוספים בקובץ התשובה ( ) int_otלזיהוי כרטיס חיוב מיידי וכרטיס מתנה/נטען
פרט לכרטיס מתנה שמונפק ע"י כאל בשלב זה.
.cהחל מגרסה 4.66נוספה תמיכה בסליקה צולבת של המותג "ישראכרט".
כרטיסים באורך 5ספרות בהנפקת ישראכרט סווגו ל 2 -מותגים שיזוהו במסוף באמצעות הגדרות
דינאמיות שיפורטו להלן:
מותג "ישראכרט" בסליקה צולבת (מותג ) 9
מותג PLבסליקת חברת ישראכרט בלבד
.dהחל מגרסה 4.64התוכנה ערוכה לקבל את הכרטיס גם ע"י . contactless
בנוסף הוכנסה תמיכה בעידכון אובליגו של כרטיס בתחנות דלק באמצעות J5עם סכום מוגדר מראש.
.eהחל מגרסה 4.64השדרוג מרחוק מחליף את Inter32.dllגם כאשר הקובץ תפוס על ידי התוכנית
המפעילה אותו .נוצר קובץ בשם .Inter32.dll1ניתן ורצוי למחוק אותו.
.fהחל מגרסה 4.86מתבצע מיסוך הנתונים הרגישים בפס המגנטי (ע"י הספרה ) 5בקובץ TRAN
וכתוצאה מכך גם ב .TRANB
.gהמיסוך נעשה כצעד ראשון של עמידה בדרישות תקן PCIלצורך להגברת האבטחה של אשראית
למקרה שמישהו חודר למחשב של בית העסק
.hהחל מגרסה 4.86לא מודפס תוקף הכרטיס בכלל (בשני העותקים) .מודפסים רק 4ספרות אחרונות
של כל סוגי הכרטיסים בעותק לקוח .בעותק סוחר מודפסים כל ספרות הכרטיס.
על מפיץ שמכין פתקית בעצמו לעמוד בהוראות אילו.
.iהחל מגרסה 4.87מוחזר בשדה קוד שירות קוד מועדון עבור כרטיסים מסוימים על פי הסיכום של
בית העסק עם חברת האשראי ,.ראה פרק INT_OT 11
.jהחל מגרסה 4.84ניתנת תמיכה בביצוע עסקאות חובה/זכות רגילות במגוון מטבעות נוספים מעבר
למה שהיה קיים עד כה .ראה נספח 4הנחיות למפיצים לשילוב תמיכה בסליקה רב מטבעית
.kהחל מגרסה 4.84ניתנת תמיכה בטיפול בכרטיסים נטענים/מתנה.ראה נספח 3הנחיות למפיצים
לשילוב תמיכה בכרטיסים נטענים/מתנה.
.lהחל מגרסה 4.77ניתן להגדיר הצפנת קובץ תנועות ע"י פרמטר בשב"א.
.mהחל מגרסה 4.76ניתן לבצע תקשורת דרך האינטרנט
.nבמידה ומוגדר שתקשורת מתבצעת דרך האינטרנט,קובץ התנועות יוצפן בדיסק הקשיח ויועבר
בתקשורת המוצפנת .תוכניות מערכת האשראית הותאמו לצורך זה ,אך אם משתמש עושה שימוש
בתוכניות משלו לניתוח של קובץ התנועות ( )TRANומעוניין לעבוד בתקשורת דרך האינטרנט ,אזי יש
להשתמש בתוכנית convtran.exeהמפענחת קובץ מוצפן .מבנה הקובץ המפוענח הוא כמבנה קובץ
,TRANאך במקום ערוץ 2בעסקאות מגנטיות מופיע רק מספר כרטיס ( 15פוזיציות עם אפסים
מובילים) ,ולאחר מכן תאריך תוקף במבנה ( YYMMכמו בעסקה טלפונית).
.oאופן ההפעלה תוכנית convtranכדלקמן:
Convtran <input file name> .i
<outputfile name> start=<masof
>namber
.pהחל מגרסה 4.74אין צורך בהפעלת תוכנית TRANMAXכדי לחלק קובץ TRANשמכיל יותר מ-
11,111רשומות.תוכנית השידור TRANSMITאו TRANS95מבצעת את חלוקת הקובץ במידת הצורך
ומשדרת את הקבצים באופן אוטומטי אחד אחרי השני.
פירוט השינויים נמצא בקובץ readmeבאתר ובכל setup
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
-6-
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
1
מידע כללי
תוכנת אשראית ל PC-מיועדת לעסקים שמעונינים לקבל תשלומים בכרטיסי אשראי כחלק מהפעילות העסקית
שלהם במשולב במערכת תפעול העסק שלהם על גבי מחשב .PC
התוכנה פותחה ע"י חברת שב"א ומופעלת במגוון רחב של תצורות.
להלן יפורטו תכונות התכנה ,אפשרויות הפעלתה והצעדים הנדרשים להטמעת התוכנה ע"י הלקוח.
1.1חברות האשראי
מערכת אשראית מטפלת בכרטיסי האשראי של החברות הבאות:
ישראכרט:
מסטרכרד /יורוקרד (מקומי ותייר) ,ויזה (מקומי ותייר) ,ישראכרט (מותג) ,ישראכרט
,PLאמריקן אקספרס (מקומי ותייר) ,כרטיסי דלק JCB ,תייר.
כ.א.ל:.
ויזה(מקומי ותייר) ,מסטרכרד (מקומי ותייר) ,ישראכרט (מותג),דיינרס (מקומי
ותייר) ,כרטיסי דלק.
לאומי קארד :ויזה (מקומי ותייר) ,מסטרכרד (מקומי ותייר) ,ישראכרט (מותג),כרטיסים במותג
פרטי.
דרישות חומרה מינימליות:
מחשב אישי PCסטנדרטי ,דיסק קשיח ומודם רגיל.
1.1אפשרויות הפעלת התוכנה
כממשק:
מערכת הלקוח משולבת עם התוכנה של שב"א המבצעת את כל הפעילויות
הקשורות בכרטיסי אשראי וכוללת בדיקות ,שידור תנועות ועדכון קבצי
פרמטרים וכרטיסים חסומים.
כתוכנית עצמאית:
התוכנית מבצעת את כל הפעילויות כמו תוכנית הממשק ובנוסף מכילה מסכים
לקליטת הנתונים הרלוונטים ,לטיפול בכרטיסי האשראי.
כתוכנית תקשורת
בלבד:
מטפלת בהעברת קובץ עסקאות אשר נוצר ע"י המשתמש לשב"א ובקבלת
קבצי חסומים ופרמטרים.
בכדי ליצור קובץ עסקאות שלא באמצעות תוכניות שב"א יש לקבל את
אישור חברות האשראי.
כשירות :WEB
מערכת הלקוח קורא לפונקציות שמפורסמות בשירות )Web service( WEB
שנמצאים בכתובת URLשמפורסמת על ידי שב"א.
השימוש כשירות WEBמחייב הרשמה בשב"א של כל מסוף .ראה פרק .26
שרת אשראית:
אפשרות להפעיל את תוכנת הממשק ממספר קופות או מסופים במקביל ללא
חשש ליצירת התנגשויות בין ההפעלות .ראה פרק .29
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
-7-
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
1.2מידע כללי – בדיקות
כל בדיקות התקינות על הכרטיס מתבצעות ברמת ה , PC -למעט ארבעה מקרים בהם המסוף חייב לבצע
שאילתא (בקשה לאישור ע"י התקשרות) למחשב חברת האשראי.
1.2.1בדיקות ברמת המסוף
א .מול קובץ פרמטרים המתקבל בהקמת המסוף ומתעדכן במידת הצורך.
קובץ הפרמטרים ייחודי לכל בית עסק (מספרי ספק ,תקרות וכו').
ב .מול קובץ הוקטורים המכיל מאפיינים המשותפים לכל המסופים
(לדוגמא :הרשאות לפי קבוצות כרטיסים).
ג.
מול הגדרות התוכנה.
ד .מול קובץ חסומים שכיום מכיל 55,111כרטיסים חסומים המתקבל במלואו בהקמת מסוף
ומתעדכן אחת ליום.
1.2.1שאילתא -בקשה לאישור ע"י התקשרות
כל נקודת מכירה נקראת בשם מסוף( .שם נוסף למסוף הינו "ספק")
המסוף מבצע שאילתא למחשב המרכזי של שב"א ,המקושר למחשב של חברת האשראי והתשובה חוזרת
בכיוון ההפוך ,במידה והתשובה חיובית ,מתקבל מס' אישור .
במקרים שלא מתקבל אישור יש שתי אפשרויות :דחייה או הודעה:
"התקשר לחברת האשראי" ,במקרה זה יש להתקשר ידנית לחברת האשראי לקבלת מס' אישור לעסקה.
כאשר הבדיקה מתבצעת ברמת ה , PC -הכרטיס נבדק מול קובץ חסומים חלקי .במידה ומתבצעת
שאילתא ,הכרטיס נבדק מול קובץ החסומים המלא של חברות האשראי .
השאילתא בודקת האם הכרטיס אכן קיים במערכת ,כך שלא יועברו כרטיסים חוקיים מבחינת הבדיקות,
אך טרם הונפקו בפועל ע"י חברות האשראי.
נבדק תוקף הכרטיס כפי שרשום בחברת האשראי ,אל מול התוקף המועבר בשאילתא( .חשוב מאוד
בעסקאות טלפוניות).
תוכנת הממשק מחליטה האם לבצע שאילתא על פי ארבעה מקרים בהם על המסוף לבצע
שאילתא:
א .סכום מעל תקרה -
ב .התקשרות אקראית -
ג.
חסום בספק -
ד .עפ"י דרישת חברת
האשראי -
כאשר סכום העסקה הינו מעל תקרה .תקרת בית העסק
הנקבעת לספק ע"י חברת האשראי.
מתבצעת בהתאם לשלשה פרמטרים הנקבעים ע"י חברות
האשראי (תקרה ,רצפה ופרמטר אקראי) ,והינם נפרדים לכל
חברת אשראי .כאשר מספר עסקאות ,אשר סכום העסקה של
כל אחת מהן נמוך מהתקרה וגבוה מהרצפה ,שווה לפרמטר
האקראי מתבצעת שאילתא (התקשרות) באופן אוטומטי.
אחרי זה מניית עסקאות לצורך שאילתא אקראית מתחיל
מחדש.
בקובץ החסומים מספר הכרטיס צומצם ל 11 -ספרות.
קיימת אפשרות (בחלק קטן מהכרטיסים) ששני כרטיסים
שונים הינם זהים למספר שצומצם ל 11 -ספרות .במידה ואחד
מהכרטיסים חסום ,תבוצע התקשרות למחשב על מנת לוודא
האם הכרטיס חסום הוא שניבדק כעת.
ישנם כרטיסים אשר אמורים לבצע שאילתא בכל עסקה.
ניתן להגדיר בשב"א את המסוף כך שיבצע שאילתא לגבי כל עסקה ועסקה( .צריך לפנות לשב"א
בבקשה בכתב ובו לציין להגדיר את המסוף לתקרות ) Z.F.L( 1בשדה זה
קיימים שני מצבים .1 :בעת בעיית תקשורת המסוף ממשיך לעבוד בoffline -
לפי התקרות הרגילות במסוף .1 .בעת בעיית תקשורת יש הפסקת עבודה.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
-8-
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
ניתן לבצע בקשה לאישור ללא עסקה( .ע"י שימוש בפרמטר J5ראה בהמשך פירוט פרמטר ) J
ניתן לבצע בקשות לאישור אשר גם במקרים של תשובה חיובית לא תיבנה עסקה .מקרים אלה הינם
חריגים ביותר ויבוצעו רק לאחר שחברת האשראי נתנה אישור לכך לשב"א.
ניתן לבצע בקשה לאישור ביוזמת הקמעונאי ( -) J6במקרה של תשובה חיובית ,תרשם העסקה
בקובץ התנועות.
2
ממשק שב"א -אשראית 66
מסמך זה מפרט את שיטת העבודה עם כרטיסי אשראי במערכת אשראית .56חברת שב"א מספקת תוכנית
תשתית )INTRFACE.EXE( ,מבצעת בדיקת עסקאות ובמידת הצורך העברת נתוני העסקה לחברת האשראי
לצורך אישור העסקה (למשל במקרים של סכום גבוה) .התוכנית דורשת כ K121 -זיכרון פנוי ,תוכנית INTRMIN
דורשת כ 70K -זיכרון ,אך לא כוללת אופציות של הדפסת פתקית ,לא ניתנת לשימוש כ , TSR -ולא מקרינה
באופן עצמאי תוצאות בדיקה.
תוכנית נוספת של שב"א ( )TRANSMIT.EXEמשמשת להעברת עסקאות אשר עברו בדיקות לחברות אשראי
לצורך חיוב לקוחות.
תוכניות מקבילות לתוכניות הנ"ל למערכת חלונות הם :
לתוכנית
.INTR32.DLL , INTR95.EXE – INTRFACE.EXE
לתוכנית .TRANS95.EXE – TRANSMIT.EXE
הפעלת פונקציות מתוך
INTR32.DLL
תוכנית INTR32.DLLמכילה שלוש פונקציות לבדיקת נתוני עסקה עם פעולה זהה:
long intrface () .1
long intr2000 (char input [ ] , char output [ ] , char env [ ] ) .2
ורושמת תוצאות INT_INהפונקציה הראשונה מופעלת ע"י שמה ללא פרמטרים .דהיינו מקבלת נתונים מקובץ
INTRMIN.EXE.או INTRFACE.EXEכמו תוכנית INT_OTבדיקה לקובץ
הפונקציה השניה מקבלת 3פרמטרים :
.1שורה של קלט (מספר כרטיס ,סכום וכו') במבנה של קובץ INT_INמסתיימת באפס בינארי (ראה להלן).
.2שורה שבה הפונקציה intr2000מחזירה תוצאה בדיקה במבנה של קובץ ( INT_OTגודל מנימלי 191בתים
– ראה להלן ).
.3שורה אשר מכילה הגדרות של מיקום קבצי מערכת (ראה להלן ) או NULLכאשר אין צורך בכך( .כל
הקבצים בסיפריה הנוכחית)
הגדרות הללו מופרדות על ידי ( ; ) לדוגמאIWRI=C:\ASH\;IREQ=C:\ASH2\ :
זאת אומרת שבמידה ומשתמשים בפונקציה INTR2000אין צורך ביצירת קובץ קלט ( )INT_INוקריאת קובץ
פלט ( )INT_OTוגם בהגדרות חיצוניות של מיקום קבצי המערכת – נתונים אלו מועברים כפרמטרים בקריאה
לפונקציה הנ"ל.
דוגמאות לקריאה ל DLL -מתוך סביבות פיתוח שונות ראה במסמך .README.DOC
2.1
א.
שלבי הטיפול בעסקה
תוכנית המשתמש קולטת את כל נתוני העסקה ורושמת את הנתונים הדרושים בקובץ קלט .))INT_IN
השדות בקובץ הקלט הינם בחלקם אופציונליים ,ובחלקם בעלי אורך משתנה .מיקום תחילת
השדה מצוין ע"י אות גדולה ( . )CAPITAL LETTERסדר הפרמטרים הכרחי על פי הפירוט בקובץ
קלט( )INT_INבמידה והמשתמש מקפיד על אורך שדות קבוע (מקסימלי) ניתן למלא ברווחים את
הפוזיציות הריקות.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
-5-
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
ב.
תוכנית המשתמש קוראת לתוכנת ממשק בשם INTRFACE.EXEהאחראית על בדיקת נתוני עסקאות.
הבדיקה יכולה להיות מקומית או ע"י בקשה לאישור מחברת האשראי המתבצעת דרך מודם.
במידה והמשתמש עובד עם מודם מרוחק אזי תוכנית הרשת אשר מטפלת בגישה למודם המרוחק,
(לדוגמא MODEM ASSIST :לרשת )NOVELLיודעת להפנות את התקשורת לתחנה עם המודם .על
המשתמש להגדיר באופציה "עדכון נתוני מסוף -ביצוע תקשורת ע"י - INTERRUPT 14כן".
הטיפול בכרטיסי אשראי בתוכניות , INTR95.EXE, INTR32.DLL INTRMIN.EXEו -
INTRFACE.EXEהינו זהה.
ג.
במידה והופעלה פונקציה INTR2000אזי הנתונים מועברים לא דרך קבצים
אלה דרך פרמטרים בקריאה לפונקציה.
INT_INוINT_OT -
תוכנית INTRFACEמבצעת את הפונקציות הבאות:
1
קוראת את הרשומה מקובץ הקלט (.)INT_IN
2
מבצעת את הבדיקות הדרושות ברמת מסוף.
3
במידה וסכום העסקה הינו מעל ה"תיקרה" מתבצעת התקשרות אוטומטית ,ללא כל שאלה.
כיום ברירת המחדל במסופים הינה התקשרות אוטומטית ,למעט מקרים חריגים שבהם התוכנית
מקרינה מסך מתאים (לאלץ או להתקשר) ופועלת בהתאם להחלטת המפעיל( .מותנה בפרמטר
המסוף)
4
מבצעת התקשרות ,במידת הצורך ,למחשב המרכזי של שב"א (מעל תקרה ,חסום בספק ,בקשה
לאישור אקראית ,ע"פ דרישת חברת האשראי או ביוזמת הקמעונאי או כאשר המסוף מוגדר
לצאת לשאילתא על כל עסקה).
9
בונה קובץ פלט ) (INT_OTורושמת את נתוני העסקה ואת הסטטוס.
6
במידה והסטטוס 111תקין:
תוכנית ה INTRFACE -רושמת את נתוני העסקה בקובץ חיובים הנקרא ( .TRANפרט ל-
-ראה מבנה קובץ הקלט .)INT_IN
J5, J3, J2
ד.
תוכנית INTRFACEמסיימת את עבודתה( ,חוזרת לתוכנת המשתמש).
ה.
תוכנית המשתמש בודקת את נתוני קובץ הפלט ) (INT_OTכולל הסטטוס ומודיע למשתמש על תוצאות
הבדיקה (ראה נספח .) 1
במידה והתקבל סטטוס " "111יש לבדוק גם שדה "מספר אישור" בקובץ הפלט .אם השדה מכיל נתונים
שונים מאפסים ,הווה אומר שהתקבל אישור לעסקה ,ועל תוכנית המשתמש לשמור את מספר האישור.
כאשר קובץ הקלט ) (INT_INמכיל רשומה אחת אזי מתקיימים התנאים הבאים:
אורך רשומה בקובץ INT_INהוא ללא הגבלה .
אם אורך הרשומה בקובץ גדול מ 144 -בתים בשל נתוני המשתמש אשר אינם רלוונטיים לתכנית
הממשק ,יש להפעיל את התכנית עם פרמטר . SINGLE/
קובץ הפלט ( )INT_OTמכיל גם הוא רשומה אחת.
כאשר קובץ הקלט ) (INT_INמכיל מספר רשומות אזי מתקיימים התנאים הבאים:
אורך הרשומה הינו קבוע ( 81בתים) או משתנה (עד 191בתים -אזי סימנים )ASCII13( CRו-
)ASCII10( LFמציינים את סוף הרשומה).
קובץ INT_OTיכיל אותו מספר רשומות שהיו בקובץ INT_INפרט למקרים בהם לא ניתן כלל
לבצע בדיקות לדוגמא :קובץ חסומים אינו מעודכן .במקרים אלה קובץ INT_OTיכיל רק
רשומה אחת ושדה "סטטוס" יציין את סיבת התקלה.
תוכנית INTRFACEמנסה לבצע את כל הבקשות לאישור בחיוג אחד .במידה ובין שתי בקשות
לאישור עברו יותר מ 9 -שניות אזי התקשורת מתנתקת .לכן כדאי למיין את קובץ INT_INלפי
סכום העסקה ואז כל הבקשות לאישור לגבי סכומים גבוהים (הגורם העיקרי להתקשרות)
תתבצענה ברציפות.
ו.
תוכנית השידור ) )TRANSMIT/TRANS95תשדר את כל התנועות שנרשמו בקובץ ( TRANאחת ליום או
מספר פעמים ביום) לחברת שב"א אשר בסוף היום תעבירן לחברת האשראי לצורך חיוב.
רק לאחר שידור מוצלח של קובץ TRANהוא יישמר בשם XXX . TRANBXXXמשתנה החל מ. 111 -
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 11 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
האסמכתא שמקבל בית העסק בסיום השידור מהווה רק אישור לקבלת התנועות ,ולא מהווה אישור
שחברות האשראי תזכנה על כל התנועות שהועברו בשידור .ז"א שיכולים להיות מקרים שבהם חברת
האשראי מודיעה בכתב לבית העסק על תנועה מסוימת שלא תזוכה.
הדגשות
.1
אין לאתחל את ה bufferשל INT_OTבערך 111כדי שאפשר יהיה לזהות מצב של תעופה של ה .DLL
.2
כשמבצעים בקשות לאישור דרך המסוף ,ישנם מקרים בהם תחזור תשובה עם סטטוס " – 113התקשר
לחברת האשראי"( .תשובה כזאת יכולה להתקבל עקב סיבות שונות ,לדוגמא :כרטיס שבוצעו עבורו
בזמן האחרון מס' בקשות לאישור) .לכן האפליקציה של המשתמש צריכה להיות ערוכה להכנסת מס'
אישור שהתקבל בצורה ידנית.
.3
כאשר הופסקה עבודת תוכנית ה INTRFACE -בגלל סיבה כשלהי (הפסקת חשמל) באמצע קובץ
INT_INשמכיל מספר רשומות ,חלק מהרשומות שקיבלו סטטוס 111נכנסו לקובץ TRANוהפעלה
נוספת של התוכנית תגרום לרשומות כפולות בקובץ .TRANולכן צריך להערך למצב כזה באחת משתי
דרכים:
א .צריך לדעת לנתח נתונים בקובץ ,TRANכדי לדעת איפה הופסקה העבודה וליצור INT_INמחדש
החל מהרשומה המתאימה או למחוק קובץ TRANולהפעיל INTRFACEמחדש .אך יש לוודא
שקובץ TRANלא מכיל רשומות עקב הפעלת INTRFACEעל קבצי INT_INקודמים אשר טרם
שודרו.
.4
במידה והכרטיס נמצא בקובץ החסומים אזי העסקה נרשמת בקובץ TRANלצורך דיווח לחברת
האשראי על שימוש בכרטיס זה.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 11 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
4
פונקציות מערכת אשראית 66
(פונקציות המופעלות מתוך מסך תפריט ראשי ב)DOS -
.1
הקמה וקליטת פרמטרים וקובץ חסומים מלא.
.2
שידור.
.3
הקרנת סיכומים לשידור (מתאריך רצוי).
.4
הקרנת רשומות שגויות.
.9
בדיקת קובץ תנועות.
.6
תוכן קבצים.
.7
בדיקת התאמה בין קבצי קלט ופלט ותנועות.
.8
הקרן או הדפס תוכן שידור.
.5
תוצאות בדיקת עסקאות ע"י תוכנית ממשק של שב"א.
.11
עדכון נתוני מסוף.
.11
טיפול בעסקאות.
.12
שינוי פרמטרים לטיפול בעסקאות.
.13
שידור באמצעות טלפון חד פעמי.
.14
כלים לעזרה.
ע"י הקשה על מקש F1בתפריט ראשי (תוכנית )ASHניתן לקבל הסבר קצר לגבי כל פונקציה.
תפריט ראשי ב( WINDOWS -הפעלת תוכנית ) ASH95מכיל את הפונקציות הבאות:
.1
.2
.3
.4
.9
שידור.
ביצוע עסקאות.
דוחות מערכת.
עדכון פרמטרים.
דוחות תקשורת.
.6
כלים לעזרה.
4.1
הקמה
הקמה הינה הפעולה הראשונה אשר יש לבצע במסוף על מנת להתחיל לעבוד עם המערכת .לעתים
רחוקות פעולת ההקמה מבוצעת גם על מסוף פעיל כדי לשנות את מספרו .במקרה כזה קבצי
היסטוריה של המערכת ( )DUMP, DUMPALL ,STATIS, TOTALיכולים להישמר או להימחק עפ”י
רצונו של המפעיל (יש לענות למס' שאלות תוך כדי ההקמה).
קבצי חסומים ( )NEG, NEGMINוקבצי שרות ( )JENR, DATAימחקו בכל מקרה.
הקמה של מסוף מחדש מבוצעת לאחר העתקת קבצי תוכנה מהדיסקט לתוך ספריה בדיסק קשיח
אשר נבחרה ע"י המשתמש להתקנת המערכת( .אין הגבלות לשם הספרייה או מיקומה) אולם יש
חשיבות רבה שכל התוכניות יופעלו אך ורק מתוך אותה ספריה.
מתוך הספרייה יש להפעיל תוכנית
ASH/INIT
ASH95/INIT
ב-
DOS
בWINDOWS -
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 12 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
על המסך יתקבל תפריט .שתי השורות הראשונות מתחילות בסימן @ .שורה ראשונה משמשת
להקמת המסוף והשורה השניה לכתיבת לוגו לפתקית.
השורות הנוספות (מסתיימות בסימן :) Vשורות אלו הינן רשימת הפונקציות של המערכת.
המשתמש יכול להפוך את הפונקציות ללא פעילות.
כדי להקים מסוף הקש ENTERבשורה הראשונה .אחרי כמה התראות ושאלות לגבי מחיקת קבצים
יתקבל מסך טבלה .יש להכניס את הנתונים הדרושים :מספר מסוף אשר מתקבל משב"א ,ערוץ
תקשורת ( ,) PORTמהירות מודם ,סוג המודם וכו'),
ולהקיש F2אזי מופעלת תוכנית TRANSMITאשר מבצעת התחברות למחשב המרכזי של שב"א לצורך
קבלת פרמטרים ווקטורים וקובץ חסומים מלא.
במידה והתקשורת הסתיימה בהצלחה (שורה אחרונה בדו"ח תקשורת :דור חסומים ) XXXXהמסוף
הוקם.
במידה וההקמה נכשלה יש לצאת מתפריט הקמה ,ולהפעיל תוכנית ASHללא . /INIT
בתפריט שיופיע להקיש ENTERבאופציה "שידור" כדי לסיים את קליטת הנתונים.
התאמת כותרת פתקית
אופציה שנייה בתפריט הקמה מיועדת לכתיבת כותרת לפתקית שהלקוח צריך לחתום עליה.
במידה ומשתמשים באופציה הזאת נוצר קובץ בשם HEADLINEאשר תוכנו יודפס כל פעם בתחילת
פתקית.
אופציות שמסתיימות בסימן : Vהקשת ENTERגורמת להורדת סימן ה V -ואופציה כזאת לא תופיע
בתפריט ראשי( .תמיד יש להקיש F2לשמירת השינויים).
אחרי שההקמה בוצעה אפשר להפעיל תוכנית . ASHהתפריט שיתקבל הינו תפריט ראשי של המערכת
ומכיל את האופציות שיפורטו בסעיפים הבאים:
4.1
שידור (ע"י הפעלת תוכנית TRANSMITאו )TRANS95
2.2.1
לשידור יש ארבעה שלבים:
שלב א' :קליטת פרמטרים (במידה ובוצע שינוי באחד מהפרמטרים ע"י חברות האשראי).
שלב ב' :שידור תנועות.
שלב ג' :קליטת קובץ חסומים (עדכונים או קובץ מלא).
שלב ד' :עדכון תוכנה (.)DOWNLOAD
2.2.2
קליטת קובץ חסומים מלא מבוצעת (לעתים רחוקות) במקרים הבאים:
הקמה.
הפרש בין דור חסומים המעודכן במסוף לבין דור חסומים המעודכן ב > HOST-מ.3 -
חל שיבוש בקליטת העדכונים.
בסיום השידור יוקרן ו /או יודפס דו"ח תקשורת (ראה סעיף "עדכון נתוני מסוף").
תוכנית TRANSMITתחזיר 1 RETURN CODEבמקרה של שידור מוצלח .במידה והיה קובץ
חיובים ( )TRANיגובה הקובץ בשם TRANB001,002 :וכו' .
2.2.3
2.2.4
כל אחד מהשלבים הנ"ל הינו אופציונלי.
במידה ומסוף מעודכן בחסומים ,אין לו תנועות ,פרמטרים לא שונו ואין צורך בעדכון תוכנה אזי
בשידור לא יבוצעו שום שינויים.
4.2
הקרנת סיכומים לשידור -מתאריך רצוי
מופעלת תוכנית . STATISTהנתונים מוקרנים מתוך קובץ . STATIS
הקרנת הסיכומים הינה ברמה של שידור כאשר לכל שידור מופיעה שורה אחת במידה והשידור כולל
תנועות חובה בלבד או שתי שורות במידה והיו תנועות חובה וזכות.
כל שורה מפרטת את מספר התנועות וסכומן לכל חברת אשראי וכן סיכום כללי לכל חברות האשראי
(ישראכרט ,כ.א.ל ,דיינרס,אמקס' ,לאומיקארד).
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 13 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
המשתמש יכול לקבוע את מספר הימים שמבקש לשמור באמצעות :שמירת נתוני שידורים -מס'
דורות (ראה סעיף עדכון נתוני מסוף).
הנתונים הנ"ל נרשמים לקובץ בשם ( STATISראה מבנה) .עבור כל שידור נרשמות שתי שורות:
לשקלים ולדולרים.
הערה :קובץ TOTALמכיל נתוני שידור אחרון במבנה של . STATIS
הקרנת רשומות שגויות
4.4
מופעלת תוכנית CHKTRANעם פרמטר . BADTRAN
הקרנת תנועות שגויות אשר התגלו באופציה "בדיקת קובץ ללא שידור".
בדיקת קובץ תנועות
4.4
מופעלת תוכנית CHKTRANעם פרמטר TRAN
בדיקת קובץ תנועות ותאריך פתיחה (לפני שידור).
מידה וקיימת רשומה שגויה אזי יוקרן תוכן הרשומה וסיבת השגיאה.
תוכן קבצים
4.6
מופעלת תוכנית .TRANFILEהנתונים שמוקרנים הם מתוך הקבצים הבאים:
TRANB001, TRANB002 ,TRAN, STATIS
וכו'.
הקרנת/הדפסת פירוט נתוני העסקאות של כל קובץ בנפרד ואפשרות חיתוך לפי כל נתון בקובץ חיובים.
ניתן להקרין/להדפיס את נתוני העסקאות בקובץ שטרם שודר לשב"א וגם בקובץ ששודר.
הקרנת/הדפסת דוח תקשורת של שידור מסוים.
המשתמש יכול לקבוע את מספר הימים שמבקש לשמור את קבצי התנועות באמצעות:
שמירת נתוני שידורים -מס' דורות (ראה סעיף עדכון נתוני מסוף).
בדיקה התאמה בין קבצי קלט פלט ותנועות
4.7
מופעלת תוכנית . CHKFILE
נבדקת התאמה בין קבצי .TRAN , INT_OT , INT_IN
הקרן או הדפס תוכן שידורים
4.8
אין תוכנית מיוחדת להפעלה .הנתונים מוקרנים מתוך קבצי - DUMP :דו"ח תקשורת אחרון.
- DUMPALLדו"ח תקשורת מצטבר.
מקרין או מדפיס דו"ח תקשורת הכולל אסמכתא ,דור חסומים ,מס' קובץ ,סיכומים לפי חברות,
סוגי כרטיס ,סוגי אשראי.
דו"ח תקשורת מהווה אסמכתא המתקבלת לאחר כל שידור ושידור.
ניתן להתייחס לדו"ח של השידור האחרון וכן לדפדף בדוחות של שידורים קודמים.
תוצאות בדיקת עסקאות ע"י תוכנית ממשק של שב"א
4.6
מופעלת תוכנית . SHOW_OUT
הקרנת קובץ ( INT_INקלט) +הקרנת קובץ ( INT_OTפלט) עם פירוט שדות.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 14 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
4.14
עדכון נתוני מסוף
מופעלת תוכנית . BUILD.EXEהנתונים מוקרנים מתוך קובץ . START
מספר מסוף -מספר מזהה של בית העסק בשב"א .לכל מסוף קשור מספר ספק אחד בכל חברת אשראי.
ערוץ ( - )PORTמיקום מודם במחשב.
מהירות -מהירות זרימת נתונים למודם רצוי שתהיה זהה למהירות המודם.
טלפון להקמה -מספר טלפון שדרכו מתבצע חיוג רק לצורך הקמת המסוף .לאחר ההקמה ,החיוג יבוצע
דרך מספר הטלפון המוגדר למסוף בשב"א.
שיטת חיוג -צליל או טון.
מרכזיה -במידה וישנה יש להכניס קידומת .במידה והקידומת היא יותר מ 2 -ספרות להכניס בחלון של
קידומת בינלאומית.
שמירת נתוני שידורים – מספר קבצים -ניתן לשמור את קבצי ההיסטוריה עד 55קבצים.
להקרין /להדפיס סיכום שידור אחרון -הקרנת /הדפסת דו"ח תקשורת .במידה וישנה מדפסת צרה
ניתן לבחור אופציה מתאימה.
ליצור קובץ חסומים בצורה - XXXXברירת המחדל . BINARYלשנות רק באם המשתמש רוצה לעבוד
עם הקובץ באופן עצמאי (ראה קובץ חסומים).
להדפיס פתקית תנועות – ישנן מס' אופציות והן:
להדפיס פתקית = כן -ניתן להדפיס פתקית ,מדובר על עותק אחד שמיועד לבית העסק .במקרה זה
נתוני הפתקית נשמרים בקובץ . NOTE
קובץ – אין הדפסה ,נוצר קובץ NOTEשמכיל העתק אחד לבית העסק.
כפול -נוצר קובץ NOTEשמציג רק את ההעתק לבית העסק .בהדפסה יוצאים שני
העתקים זהים.
קובץ כפול – אין הדפסה ,נוצרים שני קבצים .קובץ NOTEשמכיל את ההעתק לבית
העסק .וקובץ NOTECLשמכיל את ההעתק למחזיק הכרטיס.
להקרין שלבי התקשרות -בתהליך השידור המערכת יכולה להקרין או לא להקרין נתונים על המסך.
סוג מודם -שמות קבצים אשר מכילים פקודות אתחול המתאימים למודם מסוים.
למודמים עם מהירות מעל 2411מומלץ שם . MODEM
לבדוק תאריך פתיחה -במידה וקיים קובץ תנועות ,בקובץ DATAצריך להופיע תאריך תנועה ראשונה
בקובץ .ברירת המחדל = "כן" .במידה וקובץ תנועות נוצר ע"י INTRFACEהתאריך מוכנס
אוטומטית.
IRQוכתובת בזיכרון -מאפיינים למודם לא סטנדרטי ,לדוגמא :אם 9 IRQאזי יש להכניס את הערך
( ,)9אחרת תשמש ברירת המחדל .ההמשך של הפרמטרים אמור להישאר כברירת מחדל אלא בתיאום
מיוחד עם שב"א.
הערה :1נתונים אשר מוקרנים במסך שני של האופציה הנ"ל (ע"י הקשת ) F10מוגדרים בצורה שלילית
כברירת מחדל ובד"כ לא צריך לשנותם.
הערה :1מסיבות הסטוריות כאשר מוגדר IRQשונה מ 3 -או 4אחרי שמירת נתונים בשדה "ערוץ"
מופיע .COM0אזי תוכנית TRANSMIT.EXEמתייחסת רק לשדות "כתובת בזיכרון" ו "IRQ" -לעומת
זאת תוכנית TRANS95.EXEשל WINDOWSתמיד מתייחסת לשדה "ערוץ" בלבד .לכן אם בכוונת
המשתמש להפעיל תוכנית TRANS95.EXEיש להשתמש או בתוכנית BUILD95.EXEאשר לא נושאת
הגדרות “ ”IRQאו ע"י תוכנית BUILD.EXEלהגדיר "ערוץ" בהתאם להגדרות windowsשל המודם עם
” 3 “IRQאו 4אפילו אם ה ”IRQ“ -האמיתי הוא שונה.
החל מגירסה 9.76ישנה אפשרות להתחברות דרך האינטרנט
לשם כך נוספה אופציה חדשה בחלון "עידכון פרמטרים"" -פרמטרים נוספים"-
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 19 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
"תקשורת באמצעות "INTERNETבמידה ואופציה מוגדרת ,אזי גם אופציה "תקשורת
באמצעות " TCPIPפעילה והכתובת שיש להגדיר בה היא 127.1.1.1פורט . 999
4.11
החל מגירסה 9.77נוספה האפשרות להגדיר קו גיבוי כקו .TCPIP
החל מגרסה 9.57נוסף פרמטר "קורא מצפין" ניתן ורצוי לסמן אותו כאשר מחברים את קורא
כרטיסים מצפין.
טיפול בעסקאות
מופעלת תוכנית INTRFACEעם פרמטר . / INPUT
קלט נתונים של עסקאות בכרטיסי אשראי.
שינוי פרמטרים לטיפול בעסקאות
4.11
מופעלת תוכנית . CHPARM
פונקציה זו מאפשרת למשתמש לבחור מתוך האופציות הקיימות (בסוג אשראי ,בסוג
עסקה או בסוג מטבע) את האופציות הדרושות לו (לטיפול בקלט הנתונים) או להשאיר את
כולן ,הכל בהתאם להחלטת המשתמש.
שידור באמצעות טלפון חד פעמי
4.12
מופעלת תוכנית .TRANSMIT
ניתן לבצע שידור באמצעות טלפון חד פעמי שינתן ע"י שב"א .הטלפון שהוקלד לצורך ביצוע
השידור ,הוא בתוקף עד התקשורת המוצלחת הבאה.
שימוש באופציה זו יגרום לשידור הפרמטרים מחדש.
כלים לעזרה
4.14
מופעלת תוכנית .UTILS
תוכניות לעזרה:
אפשרות לערוך קובץ ( DATAכולל תאריך תנועה ראשונה).
אפשרות לערוך קובץ ( JENRכולל דורות של חסומים ופרמטרים).
אפשרות לערוך קובץ . MODEM
הצגת פרמטרים של המסוף.
הצגת קובץ .VERSION
הצגת שער יציג של הדולר.
שינוי מקשי TSRו interrupt -ל.intrface -
הערה :כעיקרון אין צורך בשימוש האופציות הנ"ל אלא בתיאום מוקדם עם שב"א.
4.14
תוכנית עזר
תוכנית STATFIX.EXEמשחזרת נתונים הסטורים אשר מוקרנים באופציות "הקרנת סיכומים
לשידור" ו" -תוכן קבצים" ,במידה וקובץ STATISאשר מכיל אותם השתבש.
השחזור מתבסס על נתונים שנשארו ולא מכיל אסמכתאות של שידורים .לכן תוכנית זו אינה מופעלת
מתוך תפריט ראשי בכדי שלא תופעל בטעות.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 16 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
4
סוגי העסקאות במערכת
עסקת חובה (לחובת בעל הכרטיס) זו העסקה הרגילה .העסקה מתבצעת על ידי העברת הכרטיס בקורא
כרטיסים.
עסקת זכות (לזכות בעל הכרטיס) .העסקה מתבצעת על ידי העברת הכרטיס בקורא כרטיסים או ללא נוכחות
כרטיס.
עסקה טלפונית -כאשר מקלידים את מספר הכרטיס בלבד ,וכן ניתן לבצע גם עסקת זכות טלפונית .עסקאות
טלפוניות יתבצעו בכפוף להרשאה מחברות האשראי.
עסקה טלפונית נקראת עסקה במסמך חסר בחברות האשראי ומאופיינת ע"י :
א .אין חתימת לקוח.
ב .קיימת אפשרות לשגיאה בהקלדת מספר הכרטיס.
ג .חסרים נתונים שנמצאים על גבי הפס המגנטי (כגון תאריך תוקף הכרטיס) המשמשים לבדיקת
תקינות הכרטיס.
עסקת חתימה בלבד מס' הכרטיס מוקלד וישנה חתימת הלקוח (מתבצע כאשר לא ניתן לקרא את הפס
המגנטי).
עסקה מאולצת מתבצעת על ידי הקמעונאי במקרים בהם אשראית מחליטה לבצע התקשרות ובמסוף ישנה
אפשרות "להתקשר או לאלץ" הקמעונאי החליט לא להתקשר .העסקה תסומן כמאולצת והאחריות לגבי
העסקה חלה על הקמעונאי.
עסקה מאושרת כאשר מתבצעת שאילתא לצורך קבלת מס' אישור (כולל אישור במענה קולי) והתקבל אישור
לעסקה מחברת האשראי ,יוקלד מס' האישור בתחילת העסקה ולא תבוצע בדיקה מול תקרה וקובץ חסומים וכן
לא תבוצע "התקשרות אקראית".
עסקת ביטול נועדה לבטל עסקה קודמת (אחרונה) בלבד .והרשומה אמורה להכיל אותם נתונים (פרט לסוג
העסקה כמובן) .מספר סודר של עסקת ביטול הינו מספר העסקה המבוטלת . 1 +ניתן לבטל רק עסקת חובה.
עסקת כוכבים/נקודות חלק מסכום העסקה ישולם באמצעות כוכבים/נקודות (או מיילים באמקס) במידה
וישנם .עסקת כוכבים/נקודות יכולה להתבצע במספר סוגי אשראי (רגיל ,תשלומים )...בהתאם להרשאות
המסוף.
עסקת במט"ח עסקה שאינה מתבצעת בשקלים ,ובה מוגדר סוג המטבע = 1קוד מטבע מיוחד ב . ISO
עסקת טעינה עסקת זיכוי עם סימון מיוחד ,בש"ח או במט"ח ,שאינה מקושרת לעסקת חובה קודמת בכרטיס
ומעדכנת את יתרת הכרטיס באופן מקוון .ניתן לבצע עסקת טעינה בכרטיס נטען ( :) pre-paidכרטיס אשראי
שניתן לטעון אותו בסכום כסף בחברת האשראי או בבית העסק וניתן לבצע אתו עסקאות חובה עד גובה היתרה
בכרטיס .סכום היתרה מתעדכן באופן מקוון לאחר כל פעולה בכרטיס .עסקת טעינה במט"ח מתאפשרת רק
במסופי פריקה/טעינה .יישום בפועל רק בתיאום עם שב"א וחברת האשראי.
עסקת פריקה עסקת חובה במט"ח עם סימון מיוחד ,המעדכנת את יתרת הכרטיס באופן מקוון .העסקה
מוגבלת לכרטיסים נטענים( .ניתן לבצע רק במסוף פריקה/טעינה – מסוף אשר יכבד אך ורק כרטיסים נטענים
במט"ח ויהיה רשאי לבצע עסקות מסוג פריקה ,טעינה וברור יתרה)
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 17 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
סוגי האשראי -ישראכרט /אמקס (אמריקן אקספרס)
6
קוד
סוג אשראי
1
1
אשראי רגיל
ישראקרדיט או
אמקס קרדיט
אין להקליד מס'
תשלומים.
-
2
חיוב מיידי
(כרטיסי ישראכרט
בלבד)
-
4
אשראי מועדון
-
.4
סופר קרדיט
-
6
קרדיט בתשלומים
קבועים
-
8
תשלומים
-
6
אשראי מועדון
בתשלומים
-
הלקוח מחויב במועד החיוב הקרוב הקבוע.
הלקוח מחויב על חלק מסה”כ יתרת העסקאות שלו שבוצעו
בישראקרדיט וזאת לפי ההסכם שחתם בסניף הבנק שלו.
לחיובים אלה מצטרף גם חיוב בגין הריבית שנזקפה עבור יתרת
העסקאות שטרם שולמו.
במידה וללקוח אין הסכם מתאים תחשב העסקה כאשראי רגיל.
רשאים לסוג אשראי זה כל הכרטיסים הישראלים (למעט כרטיסי
חיוב מיידי).
בעל הכרטיס מחויב מידית ,לכרטיסים ישראלים ( 5ספרות)
שהקידומת שלהם 71זהו סוג האשראי היחידי המותר.
כרטיסי תייר אינם רשאים לבצע אשראי זה.
כרטיסים ישראלים ,בעלי קידומת שונה מ 71 -רשאים רק אם
המסוף מאושר לכך ע"י חברת האשראי.
לכרטיס חיוב מיידי אסורה פעולת זכות אך מותרת פעולת ביטול.
אשראי שמהותו נקבע בין חברת האשראי לבין בית העסק.
הקודים של אשראי מועדון1 , 2 , 3 , 4 , 9 , 6 :
הנתונים המוקלדים :יש להקליד את מספר התשלומים בלבד.
הלקוח יחויב ,בנוסף לסכום התשלום ,גם בריבית כפי שחושבה ע”י
חברת האשראי .רשאים לסוג אשראי זה כל הכרטיסים הישראלים
(למעט כרטיס חיוב מיידי) .מתייחס לקרדיט במספר תשלומים
גדול (בד"כ מעל 18תשלומים)
הנתונים המוקלדים :יש להקליד את מספר התשלומים בלבד.
הלקוח יחויב ,בנוסף לסכום התשלום ,גם בריבית כפי שחושבה ע”י
חברת האשראי .רשאים לסוג אשראי זה כל הכרטיסים הישראלים
(למעט כרטיס חיוב מיידי).
הסכם תשלומים נקבע בין הקמעונאי לבעל הכרטיס.
הנתונים המוקלדים :סכום תשלום ראשון ,סכום תשלום קבוע,
ומספר התשלומים לסכום הקבוע (לא כולל תשלום ראשון).
רק סוג אשראי זה יכול להיות צמוד למדד המחירים לצרכן או
לדולר.
אשראי שמהותו נקבע בין חברת האשראי לבין בית העסק.
הנתונים המוקלדים :הם כמו באשראי תשלומים +קוד מועדון
הקודים של אשראי מועדון . 1 , 2 , 3 , 4 , 9 , 6
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 18 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
7
סוגי האשראי – כ.א.ל ,דיינרס
קוד
סוג אשראי
1
אשראי רגיל
-
1
עדיף24 + /
-
24 +
-
קוד 2לסוג אשראי משותף לעדיף ו .+31 -במידה וללקוח יש הסכם
עם הבנק על עדיף יבוצע עדיף אחרת .31 +
הלקוח מחויב שוטף . 31+
עדיף
(אין להקליד מס'
תשלומים)
-
2
חיוב מיידי
-
הלקוח מחויב על חלק מסה”כ יתרת העסקאות שלו שבוצעו בעדיף
וזאת לפי ההסכם שחתם בסניף הבנק שלו.
לחיובים אלה מצטרף גם חיוב בגין הריבית שנזקפה עבור יתרת
העסקאות שטרם שולמו.
בעל הכרטיס מחויב מיידית.
4
אשראי מועדון
-
6
קרדיט
-
8
תשלומים
-
הלקוח מחויב במועד החיוב הקרוב הקבוע.
כרטיסים מיוחדים אשר נערכו לחיוב מיידי מזוהים לפי קוד
השירות.
אשראי של חיוב מיידי לכרטיסים אחרים מותר רק לפי הפרמטר
המתאים.
כרטיסי תייר אינם רשאים לבצע אשראי זה .כרטיסים ישראלים
שאינם כרטיסי חיוב מיידי רשאים רק אם התקבל אישור לזה ע"י
חברות האשראי.
להלן פירוט הקודים של אשראי מועדון :התוכנה במסוף תעביר
קודים נומריים במקום האותיות כמקובל כיום:
A-1;B-2;C-3 ; D-4 ; E-9 ; F-6; X-7; Y-8 ; Z-5
עבור כל קוד כנ"ל יש לבדוק הרשאה מתאימה בחברות ויזה
ודיינרס.
הערה :קוד ( 1לשימוש עתידי) הינו במקום העשירי.
הנתונים המוקלדים :יש להקליד את מספר התשלומים בלבד.
הלקוח יחויב ,בנוסף לסכום התשלום גם בריבית כפי שחושבה ע”י
חברת האשראי.
הסכם התשלומים נקבע בין הקמעונאי לבעל הכרטיס.
הנתונים המוקלדים :סכום תשלום ראשון ,סכום תשלום קבוע
ומספר התשלומים הקבועים( .לא כולל
תשלום ראשון).
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 15 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
8
סוגי האשראי -לאומיקארד
קוד
סוג אשראי
1
1
אשראי רגיל
עדיף 24+ /
-
+ 24
עדיף
-
2
חיוב מיידי
-
לחיובים אלה מצטרף גם חיוב בגין הריבית שנזקפה עבור יתרת העסקאות שטרם
שולמו.
בעל הכרטיס מחויב מיידית.
כרטיסים מיוחדים אשר נערכו לחיוב מיידי .
אשראי של חיוב מיידי לכרטיסים אחרים מותר רק לפי הפרמטר המתאים.
4
אשראי מועדון
-
להלן פירוט הקודים של אשראי מועדון :התוכנה במסוף תעביר קודים נומריים
במקום האותיות כמקובל כיום:
4
סופר קרדיט
6
קרדיט
-
8
תשלומים
-
הלקוח מחויב במועד החיוב הקרוב הקבוע.
קוד 2לסוג אשראי משותף לעדיף ו .+31 -במידה וללקוח יש הסכם עם הבנק על
עדיף יבוצע עדיף אחרת .31 +
הלקוח מחויב שוטף . 31+
הלקוח מחויב על חלק מסה”כ יתרת העסקאות שלו שבוצעו עדיף וזאת לפי ההסכם
שחתם בסניף הבנק שלו.
A–1;B-2;C–3 ; D-4 ; E-9 ; F-6
הנתונים המוקלדים :יש להקליד את מספר התשלומים בלבד.
הלקוח יחויב ,בנוסף לסכום התשלום ,גם בריבית כפי שחושבה ע"י
חברת האשראי .רשאים לסוג אשראי זה כל הכרטיסים הישראליים (למעט כרטיס
חיוב מידי) מתייחס לקרדיט במספר תשלומים גדול (בד"כ מעל 18תשלומים)
הסכם תשלומים נקבע בין הקמעונאי לבעל הכרטיס.
הנתונים המוקלדים :יש להקליד את מספר התשלומים בלבד.
הלקוח יחויב ,בנוסף לסכום התשלום גם בריבית כפי שחושבה ע”י חברת האשראי.
רשאים לסוג אשראי זה כל הכרטיסים הישראליים (למעט כרטיס חיוב מידי)
הסכם תשלומים נקבע בין הקמעונאי לבעל הכרטיס.
הסכם התשלומים נקבע בין הקמעונאי לבעל הכרטיס.
הנתונים המוקלדים:
סכום תשלום ראשון ,סכום תשלום קבוע ומספר התשלומים
הקבועים( .לא כולל תשלום ראשון).
אשראי בתשלומים מותר לכל סוג כרטיס שיש לו תקרת תשלומים.
הערה:
סוגי האשראי המצוינים ב -יכולים להיות גם צמודים למדד המחירים לצרכן או לדולר וזאת במידה ויש לכך
הרשאה ברמת המסוף.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 21 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
6
קובץ הקלט INT_IN
להלן תיאור השדות הנדרשים בקובץ הקלט .INT_IN
לכל שדה בקובץ יש לציין את האות של השדה ומיד אחריה את הערך של השדה.
במידה ומשתמש יוצר רשומת קובץ INT_INבאורך קבוע אשר כוללת את כל השדות האפשריים ,אזי יש למלא
ברווחים את כל השדות אשר אינם בשימוש וכך גם לשדות אשר אורכם גדול מאורך הנתונים שהוכנסו בהם.
A
( )9
-
תוכן ערוץ 2של הפס המגנטי (כפי שנקרא ע"י קורא כרטיסים מגנטי רגיל וכן ע"י קורא
מצפין( .ראה הערה מס' .) 5
-
B
C
D
( )7
( )8
-
-
מספר הכרטיס בלבד ( עסקה נחשבת כעסקה טלפונית /חתימה בלבד).
הערות:
.1במקרה זה חלק מהבדיקות הינן באחריות בית העסק
.2בקובץ צריך להופיע רק שדה אחד A:או. B
הסכום באגורות – [אורך השדה משתנה (עד 8פוזיציות) :אין לרשום נקודה עשרונית לאחר
השלמים].
הערה :במידה ועסקה הינה עסקת כוכבים ,יש לציין בשדה “” Cאת סכום ההנחה שתמורתו
הלקוח יחויב בכוכבים
לדוגמא 211 - C 20000 * 5000 :ש"ח הסכום הכולל 91 ,ש"ח -הנחה בכוכבים.
האות Dהינה קידומת ל 4 -שדות( :כל 4המשתנים חובה)
סוג עסקה:
- 11עסקת חובה
- 91עסקת זכות
- 92עסקת ביטול
סוג אשראי:
- 1אשראי רגיל
- 2ישראקרדיט ,אמקס' קרדיט,ויזה עדיף ,31+ /דיינרס עדיף. 31+ /
- 3חיוב מיידי
- 4אשראי מועדון
- 9סופר קרדיט
- 6קרדיט/קרדיט בתשלומים קבועים.
- 8תשלומים
- 5עסקת מועדון בתשלומים.
הערות:
.1כאשר מצוין ויזה סוג האשראי תקף בכ.א.ל ובלאומי קארד.
.2אמקס' הינו אמריקן אקספרס
() 8
סוג מטבע:
- 1מטבע מיוחד
- 1ש"ח
- 2דולר
- 4עסקת תשלומים צמודה ל ( $ -עסקה בש"ח התשלומים צמודים ל.)$ -
- 8עסקת תשלומים צמודה למדד
קוד עסקה:
- 11עסקה רגילה
- 11שרות עצמי
- 12שרות עצמי בתחנות דלק
contactless - 19
contactless self service - 16
- 91עסקה טלפונית
- 91עסקת חתימה בלבד
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 21 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
E
)(1
-
מס' אישור (אופציונלי) -
השדה מופיע כאשר בוצעה התקשרות אוטומטית או באמצעות שיחה טלפונית רגילה
לחברות האשראי ,והתקבל מספר אישור לעסקה.
השדה אלפא נומרי .במידה והאישור מכיל גם אותיות ,יש להשתמש באותיות קטנות
בלבד .במידה ומשתמש מעונין לשמור ברשומה מקום לשדה באופן קבוע ,ניתן
להכניס בו אפסים.
סימן "?" אחרי Eולפני מספר אישור מבטיח שכל נתון לאחר "?" ייחשב כמספר
אישור( כולל אפסים או רווחים אשר היום לא נחשבים כאישור) .כמובן גם מספרי
אישור רגילים יכולים להישתל לאחר "?" או בלעדיו (כמו לפני התיקון) .למעשה
תיקון מהמפיץ נדרש רק במקרה שבית העסק נדרש להכניס לעסקה מספר אישור
שכולו אפסים.
סכום התשלום הראשון (ראה הערות).
סכום התשלום הקבוע (ראה הערות).
מספר תשלומים (ראה הערות).
מס' קופה (אופציונלי) -
מספר קופה עד 3ספרות אשר יועבר לקובץ חיובים כחלק של מספר עסקה .כעיקרון
משמש לעבודה ברשת על מנת להבטיח ייחודיות של מספר עסקה בקובץ חיובים,אשר
נוצר מתחנות עבודה (קופות) שונות.
-
אופן הפעלה (אופציונלי) -
) J1( 1ההוראה למסוף היא לא לצאת לשאילתא.במקרים של מעל תקרה וכו'.
אם אין צורך בשאילתא הכרטיס נבדק ברמת ה ,PC -והיה והכרטיס נמצא תקין,נוצר
חיוב -.ז"א העסקה נכנסה לקובץ התנועות אם יש צורך לצאת לשאילתא ,נוצר קובץ
תשובה בלבד ,ולא נרשמת עסקה בקובץ התנועות.
(J2) 2בדיקה בלבד של נתוני העסקה.
הבדיקה מתבצעת ברמת ה PC -ללא אפשרות יציאה לשאילתא וללא רישום עסקה,
בקובץ התנועות .נוצר קובץ תשובה בלבד.
במיוחד כשמדובר באפליקציה של קופה ב PC -ותוכנת הממשק מופעלת ברקע,
מומלץ לבצע את ההפעלה הראשונה של הממשק עם פרמטר – J2לצורך קביעת
חברת האשראי מנפיקת הכרטיס ,כך שניתן יהיה להקרין את סוגי האשראי הקיימים
של אותה חברה בלבד ,ואז ההפעלה השנייה תהיה לצורך חיוב (ללא הפרמטר Jאו על
פי הצורך).
הערה :כאשר הפרמטר הינו J1או J2וישנה סיבה להתקשרות אזי במקום להתקשר מציינת
התוכנית את סיבת ההתקשרות (ראה קוד סטטוס 141 - 147המפורטים בנספח , 1שהם
סטטוסי התראה ולא שגיאה) ולכן בהפעלה עם J2אין צורך להתייחס אליהם בשלב הזה .
(J3) 3בדיקה בלבד של נתוני העסקה +החזרת סכום.
כמו 2Jובנוסף מחזיר בשדה "סכום" את סכום התקרה נטו (סכום התקרה פחות
סכום העסקה הנוכחית פחות סכום מצטבר של עסקאות קודמות במידה והיו
לכרטיס)
(J4) 4ההתקשרות הינה אוטמטית,ללא שאלה (מונע אפשרות בחירה באילוץ עסקה) .כיום
לא רלוונטי ,היות והפרמטר מותנה בשב"א וברירת המחדל בכל המסופים הינה
התקשרות אוטומטית,ללא כל שאלה .גם כשלא משתמשים בפרמטר Jההתקשרות
הינה אוטומטית.
(J5) 5בקשה לאישור ללא עסקה אופציה זו נועדה לעסקים כגון :חברות להשכרת רכב,
בתי מלון וכד' בשלב הראשון מבצעים שאילתא לצורך בדיקת תקפות הכרטיס
והעסקה מול חברת האשראי וקבלת מס' אישור .העסקה תבוצע בשלב מאוחר יותר
כאשר יודע סכום העסקה המדויק( .גם במקרים שהתשובה לבקשה הינה חיובית,
העסקה לא תרשם בקובץ (.TRAN
עבודה כזאת מתאפשרת רק לאחר קבלת אישורים מחברות האשראי.
)J6( 6בקשה לאישור ביוזמת הקמעונאי.
זאת אופציה נוספת שבה המשתמש יכול ליזום התקשרות לחברות האשראי לצורך
קבלת מס' אישור.
במקרה של תשובה חיובית ,העסקה תרשם בקובץ חיובים ).)TRAN
)J7( 7ביצוע עסקת טעינה .בכרטיסים נטענים/מתנה ניתן לבצע עסקת טעינה בכרטיס
אשראי שניתן לטעון אותו בכסף .בפועל מתבצעת עסקת זיכוי עם סימון מיוחד.
-
F
- G
)(1
H
-I
)(1
J
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 22 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
) J8( 8ביצוע עסקת פריקה .עסקת פריקה במט"ח עם סימון מיוחד ,המעדכנת את יתרת
הכרטיס באופן מקוון.העסקה מוגבלת לכרטיסים נטענים.
עסקאות בצי רכב (שדות )K, L, M, N, O, P
-
K
קוד דלק
1
2
3
4
9
6
7
8
5
11
11
12
14
36
אוקטן 51
אוקטן 56
אוקטן - 59נטול עופרת
סולר
אופנועים
בנזין צבאי
סולר צבאי
נפט
סוגי דלק אחרים
אוקטן - 51נטול עופרת
אוקטן 58
אוקטן - 58נטול עופרת
סולר דל גופרית
גז פחמימי
-L
כמות דלק במאיות ליטרים.
-M
כמות שמן במאיות ליטרים.
-N
שמן (סכום).
-O
מד מרחק > .4
-P
מספר רכב > .4
הערה :לכרטיסים מיוחדים מספר רכב בשדה Pחייב להיות זהה למספר רכב
אשר מופיע על גבי הפס המגנטי.
()2
S
()2
V
T
Q
-
מס' מסוף מרכזי (אופציונלי) -מספר מסוף מרכזי במסוף השייך לרב ספק.
מס' העסק (אופציונלי) -מספר עסק בחברת האשראי במסוף השייך לרב מוטב.
תוקף כרטיס )MMYY(-חובה להכניס את השדה לעסקה טלפונית.
קוד מועדון (אופציונלי) -קוד מועדון לאשראי מועדון:
ישראכרט ואמריקן-אקספרס הקודים האפשריים.A – 1, B - 2, C - 3, D - 4 , E – 9, F – 6 :
כ.א.ל /דיינרס הקודים האפשריים- 2 ; C - 3 ; D - 4 ; E - 9 ; F - 6 ; X - 7 ; Y - 8 ; Z - 5:
.A – 1 ; B
לאומיקארד הקודים האפשריים.A – 1 ; B - 2 ; C - 3 ; D - 4 ; E - 9 ; F - 6 :
במידה ועסקה אינה עסקת מועדון אך הוכנס " "Qיש להוסיף אחריו רווח.
-
תחום כרטיס מועדון (אופציונלי) 4 -ספרות של מספר מועדון אשר מופיעים על פני
כרטיס המועדון ויש להקלידם בעסקה טלפונית עם כרטיס מועדון.
()3
-
ערך 3 CVV - 1או 4ספרות ימניות אחרונות שכתובות בצידו האחורי של הכרטיס .
()3
-
R
U
החובה לספק שדה זה מותנית בפרמטר מתאים במסוף.
Y
מספר תעודת הזהות (עד 6ספרות) החובה לספק שדה זה מותנית
בפרמטר מתאים במסוף.
()4
W
-
ארבע ספרות אחרונות .החובה לספק שדה זה מותנית בפרמטר מתאים במסוף.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 23 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
!
()5
-
– UCAF/CAVV ,ECIשדה לקליטת נתוני האימות של מחזיק הכרטיס (שמנוי לשירות עסקה
בטוחה) ולהעבירו לחברת האשראי בשאילתא.
עד 3ספרות עבור מטבע( .סוגי מטבע אשר נמצאים בטבלת ) ISOסוג מטבע ISO
נתונים נוספים -נתונים אלו יירשמו לקובץ התנועות ויועברו לחברות האשראי.
שימוש בשדה זה מותנה בפרמטר מתאים במסוף .שדה זה נומרי עד
שמונה תווים.
שימוש אפשרי העברת אסמכתא לצורך התאמות מול חברות האשראי.
שדה אחרון אופציונלי – נתוני משתמש
-$
-Z
()6
X
שדה לנתונים מיוחדים להעברה לקובץ פלט ( )INT_OTעפ"י רצונו של המשתמש .נתונים
אלו לא צריכים חיוב של הלקוח אך יכולים לעזור למשתמש לזהות את העסקה (מספר
הזמנה וכו') .נתונים אלו ירשמו גם לקובץ TRANבסוף הרשומה שנוצרה עקב הפעולה,
באורך 15בתים CR +ו LF -אך לא ישודרו לחברת האשראי.
הערות:
(.)1
הסכומים F,Gמופיעים בקובץ רק בעסקת תשלומים (סוג אשראי = 8או .)5
הסכומים באגורות .אין לרשום נקודה עשרונית.
השדה Hמופיע בקובץ בעסקאות תשלומים (סוגי אשראי 8או 5ומכיל מספר תשלומים קבועים),
ובאשראי מיוחד (סוגי אשראי = 9או 6ומכיל מספר תשלומים כולל).
לעסקה בתשלומים צריך להתקיים התנאי הבא.C = F+HG :
Hחייב להיות גדול מ 1 -לסוגי אשראי 9או .6ויותר מ 1 -לסוג אשראי 8או . 5
דוגמא :
לעסקת 3תשלומים של 111ש"ח:
שדה ( 3334 : Fבאגורות).
שדה ( 3333 : Gבאגורות)
שדה : Hמכיל ( .2תשלומים קבועים של .)33.33
(.)1
רב ספק/רב מוטב.
חובה להשתמש בשדה במידה ולבית העסק קיים יותר ממספר ספק אחד באותה חברת
א.
אשראי(.מצב של רב ספק)
שימוש באופציה דורש הסכם מיוחד עם חברות האשראי.
ב.
במידה ובית העסק יתחשבן עם כל אחד מספקיו בכוחות עצמו יש להשתמש בפרמטר (Vמצב
ג.
של רב מוטב) ,אחרת בפרמטר .S
לפרטים נוספים ראה פרק רב ספק/רב מוטב.
(.)2
דרישה להקלדת CVV2ו/או תעודת הזהות.
בדיקת CVV2ו/או נתוני תעודת זהות בעסקאות טלפוניות ועסקאות בהן הלקוח לא נוכח.
הבדיקה תבוצע לכל סוגי הכרטיסים (כולל אמקס ,דיינרס ו ) PLעל פי דרישה של חברת אשראי
(מותנה בפרמטר מתאים במסוף) .הבדיקה מהווה נידבך נוסף לאמצעי הביטחון ,והאבטחה שמבצע
העסקה אכן מחזיק בידיו את הכרטיס.
האשראית מחזירה קוד תשובה ב .INT_OTעל סמך קוד תשובה זה ,ובהתייחס לפרוט קוד תשובת
חברת האשראי – ת"ז ,CVV2-יחליט המסוף האם להנחות את המשתמש להקליד את הפרטים בשנית.
.1יתכן מצב ש CVV2 -לא קריא או לא מודפס על הכרטיס ,ולכן אפשר לדלג על הזנת השדה תוך ציון
הסיבה.
במקרה כזה יש להכניס את הערכים הבאים לשדה ": ”U
– 1בית העסק בחר לא להקליד .CVV2
CVV2 – 2לא קריא.
CVV2 – 5לא קיים על הכרטיס.
.2במידה ומספר ספרות שהמפיץ מגדיר ל CVV2 -או ת.ז הנו קבוע יש להצמיד לימין ולהשלים
ברווחים.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 24 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
.3אם לא הוזן נתון בשדה ת.ז .אין לשלוח את השדה ". "Y
התגובה של אשראית .56
במקרה בו המסוף מחייב הקלדת נתוני CVV2או ת.ז (על פי הפרמטר) ,ולא הוזנו נתונים במסכי הקלט
או שהנתונים לא הועברו ב INT_INוסכום העסקה מחייב יציאה לשאילתא (מעל תקרה ) יתקבל קוד
שגיאה:
– 197לא הוקלד מספר תעודת הזהות.
– 198לא הוקלד . CVV2
– 195לא הוקלדו מספר תעודת הזהות וה. CVV2 -
במקרה בו הוזנו נתונים והועברו לחברת האשראי בשאילתא ,רק אז תתבצע התאמה של
הנתונים .במצב שגיאה מתקבלת התגובה CVV2 – 116 :ו/או תעודת הזהות לא תקינים
(.)4
פענוח מצב השגיאה הוא על פי המפורט בקובץ INT_OTבפוזיציות ( 34מצב ת.ז) ,או ( 39מצב .)CVV2
דרישה להקלדת 4ספרות האחרונות של מספר הכרטיס
השוואת 4ספרות אחרונות של הכרטיס לפס המגנטי.
בדיקה מותנית בפרמטר במסוף ,לפיה נדרשת הקלדת 4ספרות אחרונות של הכרטיס עבור עסקאות
מגנטיות .הספרות המוקלדות יושוו לספרות הנקראות מהפס המגנטי ,הצורך בבדיקה נקבע על פי
פרמטר של המסוף (בנפרד לכל חברת אשראי) שנטען ממחשב שב"א .הבדיקה נועדה לאתר זיופי פס
המגנטי.
התגובה של אשראית .56
במקרה בו המסוף מחייב הקלדת 4ספרות אחרונות (על פי הפרמטר) ,ולא הוזנו נתונים במסכי הקלט
או שהנתונים לא הועברו ב INT_INיתקבל קוד שגיאה:
– 117לא הוקלדו 4ספרות האחרונות.
אם הוקלדו הנתונים תשווה תוכנת אשראית את הספרות המוקלדות מהשדה " "Wלספרות הנקראות
מהפס המגנטי .אם התוצאה אינה זהה ,יתקבל קוד שגיאה:
– 119אין התאמה בין המספר שהוקלד לפס המגנטי.
והעסקה תדחה.
הבדיקה היא מקומית ,והעסקה לא תירשם בלוג.
באפשרות המפיץ לתת אופציה להקלדה חוזרת של הספרות למקרה של טעות בהקלדה.
(.)4
הוסף שדה "!" בקובץ INT_INהמכיל נתונים הרלוונטיים לעסקאות . INTRNET
.1
.2
.3
לדוגמא:
ערך ( ECIראה נספח 2טבלת הערכים האפשריים של – ECIתו אחד)
אורך ( UCAF/CAVVשתי ספרות)
UCAF/CAVV
B4580000000000000C100000D011150T0303!509ABCD12345
במקרה זה ECIשווה 9אורך נתון UCAF/CAVVהנו )15( 5ונתון עצמו הנו
ABCD12345
בקובץ הפלט INT_OTפוזיציה 64תכיל תוצאת בדיקה של ערך UCAF/CAVVבמידה ובדיקה
זו נעשתה ע"י חברות האשראי במהלך ביצוע בקשה לאישור .במידה וכתוצאה של בעיית UCAF/CAVV
תגרום לחברת האשראי לדחות את העסקה ,יוחזר אחד מקודי השגיאה המקובלים במערכת (למשל
-114סירוב)
(.)6
שדה Xהינו השדה האחרון!
( )7במקרה שהאות " "Cחוזרת על עצמה בנתוני העסקה אשר מועברים לאשראית ( ,) INT_INמוחזרת שגיאה
– 117סכום שגוי.
התיקון נובע ממצב בו הקמעונאי מזין אות " " Cגדולה בשדה של מספר אישור (אישור לבקשה בגין
כרטיסי תייר עשוי להכיל אותיות).
במקרה זה המפיץ צריך לדאוג לכל האותיות המוקלדות בשדה זה לאותיות קטנות.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 29 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
( )8לצורך הכנסת סוג מטבע מיוחד לנתוני קלט של אשראית התווסף שדה המתחיל מ "$" -אשר מכיל סוג
מטבע . ISOבמקרה כזה סוג מטבע בשדה " " Dהישן אמור להיות " "4לדוגמה:
B4580000000000000C1234D011051T0708$872E12345
בעסקה שלדוגמא קוד המטבע הינו . 872שדה " "$יכול להיות בכל מקום בתוך נתוני הקלט
(אך יש לזכור ששדה " " Xאם ישנו הינו שדה אחרון).
( ) 6ניתן לעבוד עם קורא כרטיסים מצפין לצורך מניעת זליגה נתונים הרגישים.
במקרה זה יחד עם נתוני פס מגנטי ( )Track 2ה"מנוון" (ללא נתונים רגישים)
מועבר חלק מוצפן אשר מכיל את הנתונים הרגישים בצורה מוצפנת ,לדוגמה:
*…4580000000000000=13101207777777777*C2592495A8
אורך בלוק המוצפן (בין "*" ) הינו 38בית ,דהיינו אורך הכולל – .)37+38+2( 77
השינוי אצל מפיץ אינו גדול .ה INT_IN-יראה כך (לדוגמה) :
…A4580000000000000=13101207777777777*A7F5D2…*C12800D011100
למעשה השתנה רק תוכן שדה "."A
באופציה "עדכון פרמטרים" ב"-פרמטרים נוספים" מופיע פרמטר " האם מחובר קורא
המצפין" .ניתן (ורצוי) לסמן אותו כאשר מחברים את הקורא.
יחד עם זה אם לא סומן הפרמטר תוכנה אשראית בודקת האם מחוברת קורא המצפין
על-פי מספר מאפיינים ,כגון שביעיות בפס מגנטי ,ומסמנת את הפרמטר אוטומטי.
אם יש תקלה בקבלת נתונים מוצפנים מהקורא יתקבל קוד שגיאה – 211תקלה בקבלת
נתונים מוצפנים
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 26 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
14קובץ הפלט INT_OT
הערות
שם השדה
תווים
מקום
יחסי
סטטוס
הוראות תצוגה
לכרטיס נטען
3
1
1
4
מספר כרטיס
מותג
15
1
9
24
– 1כרטיס פרטי של חברה מנפיקה () PL
סולק
1
29
– 1מסטרכרד – 2ויזה – 3מאסטרו
מספר חברה הסולקת את העסקה.
קוד שרות
3
26
פרמטר
תאריך תוקף
1
25
4
31
()MMYY
1
34
הערות – 1 :לא הוכנס
1
39
ראה נספח קודי סטטוס
כיום בכרטיסי טעינה השדה יכול להכיל את הערכים הבאים:
– 1אין דרישה (ברירת מחדל).
– 1נדרש להקרין ולהדפיס המסר בפתקית בש"ח.
– 2נדרשת הקרנת המסר בלבד בש"ח.
– 3נדרש להדפיס את המסר רק בפתקית בש"ח.
– 4נדרש להדפיס בפתקית ולהקרין במסך מטבע דולר.
– 9נדרש להדפיס בפתקית ולהקרין במסך מטבע יורו.
- 6נדרש להקרין ולהדפיס את המסר בפתקית במט"ח.
- 7נדרש להקרין את המסר במט"ח.
- 8נדרש להדפיס את המסר רק בפתקית במט"ח.
J
תשובת חב'
האשראי – ת"ז
תשובת חב'
אפסים מובילים.
-9מותג ישראכרט
– 1ישראכרט – 2,ויזה כ.א.ל – 3,דיינרס – 4 ,אמריקן אקספרס– 6 ,
לאומיקארד
החל מגירסה 9.87נעשה שימוש נוסף בשדה קוד שרות:
בכרטיסי מועדון חברת האשראי תעביר את מס' המועדון בתשובה
לשאילתא בשדה ( ADD-ON-DATAשדה .)Z
תוכנת אשראית תקבל את הנתון ותעביר למסוף בשדה קוד שרות את 3
הפוזיציות של קוד המועדון.
– 1הוכנס ותקין
– 2לא תקין
– 3לא נבדק
כנ"ל
האשראי – CVV
סכום באגורות
מידע נוסף
8
8
36
44
סכום בכוכבים
קוד חב' אשראי
8
1
92
61
העברת מידע נוסף ע"י חברת האשראי בתוך תשובה לשאילתא.
לדוגמא :יתרת האשראי של מחזיק הכרטיס .השדה הנו אלפא נומרי.
(ראה טופס פיתקית ללקוח)
כיום רלוונטי בכרטיסי טעינה/מתנה.
– 1ישראכרט
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 27 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
שם השדה
תווים
מקום
יחסי
2
61
סוג אשראי
1
63
UCAF/CAVV
1
64
)(1
סוג מטבע
1
69
)(1
קוד עסקה
2
66
)(1
קוד מועדון
1
68
כפי שנקבע בין חברות האשראי ורשתות השיווק.
סיבת התקשרות
1
65
מקור האישור
1
71
מספר אישור
סכום תשלום
ראשון
סכום תשלום
קבוע
מספר תשלומים
מספר קובץ
מספר קופה
מספר סודר
בקופה
שם כרטיס
ציון לכרטיס
חו"ל
7
8
71
78
"רווח" – לא בוצעה התקשרות
- 1אקראי
- 2תקרה
- 3מספר סודי
- 4קוד שרות בפס מגנטי
- 9בקשה לאישור ללא עסקה
- 6חסום לא חד משמעי
( Z.F.L - 7תקרת ) 1
- 8בקשה לאישור יזומה
- 5טעינה
- Aפריקה
- 1אושר ע"י שב"א
- 2אושר ע"י חברת האשראי
- 3אושר ע"י המענה הקולי
- 1עסקה ללא אישור
8
86
2
2
3
3
54
56
58
111
19
1
119
115
(חב' מנפיקה)
סוג עסקה
)(1
)(2
הערות
– 2ויזה כ.א.ל
– 3דיינרס
– 4אמריקן אקספרס
JCB – 9
– 6לאומיקארד
– 11כרטיס חסום
– 11עסקת חובה רגילה
– 12עסקת חובה מאושרת
– 13עסקה מאולצת
– 91עסקת זכות
– 92עסקת ביטול
– 93עסקת זכות מאושרת
תוצאת בדיקה של ערך UCAF/CAVVבמהלך ביצוע בקשה לאישור.
111-555
111-555
– 1כרטיס ישראלי – 1כרטיס תייר – 2כרטיס דלק – 3כרטיס חיוב
מיידי -4כרטיס מתנה/נטען (פרט לכרטיס מתנה/נטען שמונפק ע"י
חברת ויזה כא"ל בשלב זה )
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 28 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
שם השדה
תווים
מקום
יחסי
נתוני משתמש
סיומת
15
2
121
135
הערות
CR/LF
הערות:
( )1ראה מבנה קובץ INT_INלגבי הערכים האפשריים של השדות.
( )1ראה נספח . 2
כל השדות הינם נומריים למעט השדות הבאים:
.1
שדות המוגדרים תווים ריקים.
.2
שדה קוד מועדון.
.3
שדה סיבת התקשרות.
.4
שדה מספר אישור.
.9
שדה שם כרטיס.
.6
.7
שדה מידע נוסף.
שדה נתוני משתמש.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 25 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
11אופציות מיוחדות לשימוש בתוכנית הממשק ()INTRFACE
.1
.2
.3
קביעת פרמטרים למיקום קבצים.
שימוש בתוכנית הממשק כ.TSR -
העברת קבצי INT_IN , INT_OT ,דרך הזיכרון.
הפרמטרים לשימוש עבור האופציות המיוחדות
הפרמטרים /D / R / U / B /Oהינם אופציונליים אך במידה ומשתמשים בהם אזי חייבים להיות
ראשונים.
/D
רושם לקובץ LOGאת כל הניסיונות לפתוח קובץ בציון שם הקובץ והודעת שגיאה.
/R
להעלות תוכנית כ.TSR -
/U
להוריד מהזיכרון תכנית .TSR
/B
כתובת בזיכרון של .INT_IN
/O
כתובת בזיכרון של .INT_OT
פרמטרים להגדרות קבצים
במידה וקבצי מערכת (כולם או בחלקם) אינם נמצאים ב CURRENT DIRECTORY -אפשר להשתמש בפרמטרים
הבאים.
\< IREQ = < PATHמסלול גישה לקבצי חסומים ופרמטרים מערכתיים (לא קשורים לפרמטרים של מסוף
ספציפי).
\< IRDI = < PATHמסלול גישה לקבצי פרמטרים של המסוף.
\< IWRI = < PATHמסלול גישה לקבצי תנועות .
\> DATA=<PATHקובץ ניהול שידורים -מסלול בלעדי לקובץ ( . DATAבמידה ולא מוגדר אזי הקובץ נמצא
במסלול בפרמטר ) IWRI
\> ASHSTART = <PATHקובץ עם הגדרת תחנת עבודה (מס'מסוף וכו' ) -מסלול בלעדי לקובץ .START
(במידה ולא מוגדר אזי הקובץ נמצא במסלול בפרמטר ) IRDI
\> - ASHRAIT=<PATHמסלול לספריה אשר מציינת באיזה מקום נמצאת תוכנת אשראית.
[שם קובץ קלט] - \ >INT_IN = <PATHמסלול גישה ו/או שם לקובץ קלט.
[שם קובץ פלט]\ > - INT_OT = <PATHמסלול גישה ו/או גישה לקובץ פלט.
[שם קובץ הפתקית]\ > - NOTE = <PATHמסלול גישה ו/או גישה לקובץ הפתקית.
הערות:
.1
מיקום קבצים לא ב CURRENT DIRECTORYאפשרי אך לא רצוי ומונע את היכולת של
שב"א לבצע שדרוג מרחוק ( )Downloadמוצלח.
.2
במידה ולא מצוין ה PATH -אזי ברירת המחדל לחיפוש הקובץ ,הינה הספרייה הנוכחית.
.3
יש לזכור שהפרמטרים הנ"ל רלוונטיים אך ורק לביצוע עסקאות ,דהיינו שידור תנועות
מתבצע תמיד מהסיפריה הנוכחית.
.4
ניתן להגדיר את מיקום הקבצים באחת מהאפשרויות הבאות:
א .ע"י השימוש בפקודת . SET
דוגמא. SET IREQ = < PATH > \ :
ב .ע"י הפעלת INTRFACEעם פרמטרים הנ"ל.
דוגמא. INTRFACE IREQ= < PATH > \ :
ג .ע"י יצירת קובץ בשם ENVIRONאשר מכיל את הפרמטרים הנ"ל IREQ( .וכו') ונמצא
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 31 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
בסיפריה הנוכחית.
הקובץ לא יכיל יותר מ 11 -שורות ,כאשר אורך כל שורה מקסימום 81בתים.
לדוגמא:
\IREQ=C:\ASHRAIT
\IRDI=C:\ASH1
\IWRI=C:\ASH1
.9
במידה ומשתמשים ב INTR32.DLL -ניתן גם להעביר את הפרמטרים הנ"ל כפרמטר שלישי
בקריאה לפונקציה INTR2000כאשר יש להפריד בין הפרמטרים על ידי הסימן נקודה פסיק
לדוגמאIRDI=C:\ASH1\; IWRI=C:\ASH1\ :
(;).
11.1שימוש בתוכנית הממשק כ DOS( TSR -בלבד)
להעלות תוכנת INTRFACEכ:TSR -
.1
.2
העלאת התוכנה כ.INTRFACE / R :TSR -
השימוש כ TSR -יכול להתבצע ע"י אחת האופציות הבאות:
ע"י צירוף מקשים הנקבע בכלים לעזרה (ברירת מחדל ALTו.)" . "-
.2.1
מתוך תוכנית המשתמש ,אזי יש לבצע את הפעולות הבאות:
.2.2
א.
לרשום בכתובת HEX 244ערך .FF
ב.
הפעלת HEX INTERRUPT 51כאשר .AX = 0
ג.
להמתין עד שערך בכתובת HEX244יהיה שונה מ FF-הווה אומר
שה INTRFACE -סיים את עבודתו.
.3
הורדת תוכנית כ: TSR -
INTRFACE /U
.3.1
ע"י צירוף מקשים שנקבע בכלים לעזרה (ברירת מחדל ALT.ו.) " A " -
.3.2
הפעלת HEX INTERRUPT 51כאשר .AX = 2
.3.3
הפעלת INTRFACE /Uמ.COMMAND LINE -
11.1העברת קבצי INT_IN , INT_OTדרך הזיכרון ( DOSבלבד)
יש להפעיל INTRFACEעם פרמטרים
> . / O < SEG : OFF > , / B < SEG : OFF
בכתובת > < SEG : OFFעד > < SEG : OFF+2מופיע הערך .ABS
בכתובת > < SEG : OFF+3עד > < SEG : OFF+5מופיע אורך הקובץ.
בכתובת < > SEG : OFF+6עד < > SEG : OFF+6+LEN-1מופיע הקובץ.
הערות:
ספרות הכתובת בזיכרון הינן עשרוניות.
.1
- LENהינו אורך הקובץ.
.2
פרמטר המתחיל ב "B" -מתייחס לקובץ .INT_IN
.3
פרמטר " "Oמתייחס לקובץ .INT_OT
11.2הסבר לשיטת רישום של קובץ TRANע"י INTRFACE
לפני רישום לקובץ TRANמתבצעת בדיקת קיום קובץ .INT_LOCK
אם קובץ INT_LOCKאינו קיים אזי תוכנית INTRFACEיוצרת אותו ורושמת רשומה בקובץ . TRAN
אחרת מחכה שניה אחת ומנסה שוב וזאת עד מקסימום 11פעמים .במידה וקובץ INT_LOCKעדיין
קיים נרשמת רשומה בקובץ TRANבכל זאת.
לאחר רישום מוצלח ה INTRFACE -מוחק את קובץ .INT_LOCK
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 31 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
. ניתנת להפעלה באותו זמן מתחנות שונות ברשתINTRFACE-הודות לפעולות הנ"ל תוכנית ה
ללא אפליקצית משתמשINTRFACE העברת עסקאות דרך תוכנית11.4
יוקרן מסך המאפשר ביצוע עסקאות ע"י/INPUT תופעל עם פרמטרINTRFACE במידה ותוכנית
.' מספר כרטיס סכום וכו:הקלדת נתונים בסיסים כגון
דוגמאות למיקום קבצים11.4
\
INTRFACE
IREQ = \ASHRAIT\ IRDI = \ASHRAIT\ IWRI = \ASHRAIT\ INT_IN =
ASHRAIT \INT_IN.001 INT_OT =\ASHRAIT\ INT_OT.001
.\ כולל קובץ תנועותASHRAIT כל הקבצים נמצאים בספרית
SET IREQ = \ASHRAIT\
SET IRDI = \ASHRAIT\
SET IWRI = \ASHRAIT\
SET INT_IN = \ASHRAIT\INT_IN.001
SET INT_OT = \ASHRAIT\INT_OT.001
. כולל קובץ תנועותASHRAIT\ כל הקבצים נמצאים בספרית
SET IREQ=\ASHRAIT\
SET IRDI=\ASHRAIT\
TRAN, DATA, INT_IN, INT_OT
\ לא יכללו קבציASHRAIT -כל הקבצים לקריאה נמצאים ב
: INTR32.DLL מתוךINTRFACE - וINTR99 ‘ להפעלת פונקציותC’ להלן דוגמא של תוכנית בשפת
BOOL
#include <windows.h>
BOOL PASCAL _export intrface (void);
PASCAL _export intr99 (char *,char *,char *[]);
int PASCAL WinMain (HINSTANCE hInstance, HINSTANCE hPrevInstance,
LPSTR lpszCmdParam, int nCmdShow)
{
char in[200],out[200];
char *MyEnv[20];
int res;
char buf[10];
MyEnv[0] ="IREQ=C:\\ash500\\";
MyEnv[1] ="IWRI=C:\\ash500\\";
MyEnv[2] ="IRDI=C:\\ash500\\";
MyEnv[3] = 0;
strcpy(in,"B10000003C10D011150T0101");
// Call to function intr99 with parameters :
// in - pointer to INT_IN - input up to 152 char
// out - pointer to INT_OUT - output - 140 char
// MyEnv - array of pointers to environment
res = intr99(in,out,MyEnv);
res = intr99(in,out,NULL);
//Call to function intrface without parameters
--------------------------------------------------------------------------------------------------------------------------------------------------07/13 V9.58
- 32 -
mefizim598.doc
מחלקת תוכנה
----------------------------------------------------------------------------------------------------------------------------------------------------res = intrface();
return 1;
}
INTR32.DLL קריאת פונקציות מתוך11
INTR32.LIB ערכת התוכניות מכילה קובץ, 9.11 גרסהBORLAND שלC פונקציות כתובות בשפת
אך לא בסביבת עבודה שלBORLAND -שניתן להעזר בו אם משתמשים בסביבת עבודה של
MICROSOFT
.1
.)PASCAL - (פונקציות מוגדרות כintr2000 , intr99, intrface יש לקרא לפונקציות הנ"ל לפי שמות
.2
VISUAL C++ קריאה מתוך סביבת
.3
. GetProcAddress - וLoad Library יש להשתמש בפונקציות
#include <string.h>
#include <windows.h>
int PASCAL WinMain( HINSTANCE hInstance, HINSTANCE hPrevInstance,
LPSTR lpCmdLine, int nCmdShow )
{
H_Intr99; HINSTANCE
H_Intr99=NULL;
typedef long (__stdcall * INTR99)(char *,char*,char *[]);
INTR99 intr99;
H_Intr99=LoadLibrary("INTR32.DLL");
if (H_Intr99==NULL)
{
//
MessageBox
}
intr99=(INTR99)GetProcAddress(H_Intr99,"intr99");
if (intr99 == NULL)
{
//
MessageBox
}
char int_ot[160];
memset(int_ot,'0',150);
//ערך של הפרמטר הראשון ניתן כדוגמא בלבד
intr99("B10000003C1200D011150T0101",int_ot,0);
FreeLibrary(H_Intr99);
return 1;
}
VISUAL BASIC בקריאה מתוך סביבת
.
--------------------------------------------------------------------------------------------------------------------------------------------------07/13 V9.58
- 33 -
mefizim598.doc
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
11.1א ראשונה
יש להוסיף ע"י אופציה Project -> Add Moduleהגדרה הבאה :
_ Declare Function intr99 LIB "intr32” (ByVal IntIn As String , IntOt As Byte,
ByVal MyEnv As Long) As Long
בקריאה לפונקציה יש לכתוב :
Dim IntIn As String *150
Dim IntOt (150) As Byte
Dim Res As Long
---------------------------------------Private Sub …..
< נתוני עסקה אחת בלבד במבנה קובץ IntIn => IntIn
) Res= intr99 ( IntIn , IntOt (0), 0
11.1שניה
יש להוסיף ע"י אופציה Project -> Add Moduleהגדרה הבאה :
_ Declare Function intr99 LIB "intr32” (ByVal IntIn As String , ByVal IntOt As String,
ByVal MyEnv As Sstring) As Long
בקריאה לפונקציה יש לכתוב :
Dim IntIn As String *150
Dim IntOt As Sring * 150
Dim Res As Long
---------------------------------------Private Sub …..
< נתוני עסקה אחת בלבד במבנה קובץ IntIn => IntIn
)“ “ IntOt = string (150,
) Res= intr99 ( IntIn , IntOt, vbNullString
כנ"ל מוגדרת ונקראת גם פונקציה intrfaceאך ללא פרמטרים.
שים לב !!!
א.
לא הצלחנו לעביר ב Visual Basic -מערך של מחרוזות ( , )stringesדהיינו הגדרות של מיקום קבצים יש
לעשות (במידה והם לא נמצאים בסביבת העבודה) או ע"י פקודות SETשל מערכת ההפעלה או ע"י
קובץ ( ENVIRONראה מסמך "ממשק אשראית – PCקביעת מיקום קבצי מערכת") .או ע"י שימוש
בפונקציה intr2000אשר הפרמטר השלישי הינו stringאשר מכיל את מיקום קובצי המערכת בשורה
אחת כאשר הסימן " ; " (נקודה פסיק) מפריש בניהם.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 34 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
12קריאה ל Intr32.dll-ממג'יק
12.1כללי
INTR99הוא DLLשמחזיר ערך LONGלמג'יק ומעדכן את הפרמטר ,שמייצג את ,int_otשנשלח לפונקציה.
לא ניתן להשתמש ב Calldll()-היות ופונקציה זו אינה מחזירה ערכים מעודכנים של פרמטרים שנשלחו אליה.
12.1אופן הקריאה ממג'יק
יש לקרוא ל DLL-ע"י הפקודה .Call UDP :יש לציין את שם הפונקציה ( INTR32.INTR99ואת הפרמטרים הנשלחים
לפונקציה.
רשימת הפרמטרים הנשלחים לפונקציה:
.1
’ 4 -‘AA4מציין את הערך המוחזר מהפונקציה.
– AAמציינים את מחרוזות הקלט והפלט שנשלחים לפונקציה
.2
מחרוזת קלט -משתנה מחרוזת באורך 161
.3
מחרוזת פלט -משתנה מחרוזת באורך 161
להלן הדפסת מסכים של תוכנית לדוגמא שקוראת לפונקציה:
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 39 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
--------------------------------------------------------------------------------------------------------------------------------------------------07/13 V9.58
- 36 -
mefizim598.doc
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
14רשימת תוכניות -מערכת אשראית 66
תפריט ראשי
ASH.EXE
ASHלWINDOWS -
תוכנת
עדכון נתוני מסוף
ASH95.EXE
BUILD.EXE
תוכנת BUILDלWINDOWS -
BUILD95.EXE
בדיקת התאמה בן קבצי קלט ,פלט ותנועות
CHKFILE.EXE
בדיקת קובץ תנועות
CHKTRAN.EXE
בדיקת קובץ תנועות ל – WINDOWS
CHKTRAN95.EXE
שינוי תפריטים לטיפול בעסקאות
CHPARM.EXE
תוכנית ממשק ל WINDOW95 -מתוך DLL
INTR32.DLL
תוכנית ממשק לבדיקת נתוני עסקה
INTRFACE.EXE
תוכנית ממשק ל-
כתיבת לוגו לפתקית
הקרנת קובץ הפלט
תוכנית מדמה אפליקציה של משתמש (יצירת קלט,
הפעלת , INTRFACEהצגת פלט)
INTR95.EXE
WINDOW95
RECEIPT.EXE
SHOW_OUT.EXE
SIMUL.EXE
הקרנת סיכומים לשידור
STATIST.EXE
STATISלWINDOWS -
תוכנית
תוכנית המיועדת לשחזור נתונים הסטורים
תוכן קבצי התנועות
שידור (לקבצים מעל 5111תנועות)
TRANMAX.EXE
TRANMAXלWINDOWS -
TRMAX95.EXE
STAT95.EXE
STATFIX.EXE
TRANFILE.EXE
תוכנית
שידור +הדפסה /הקרנה דוח תקשורת
תוכנית
TRANSMIT.EXE
TRANSMITלWINDOWS -
TRANS95.EXE
תוכנית המפענחת קובץ תנועות מוצפן
כלים לעזרה
CONVTRAN.EXE
UTILS.EXE
תוכנית UTILSלWINDOWS -
UTILS95.EXE
הקרנת דוחות תקשורת לWINDOWS -
DUMP95.EXE
מס' גרסה (הקובץ מכיל נתונים בלבד ואינו ניתן
להרצה )
VERSION.EXE
כמו תוכנית INTRFACEאך ללא אפשרות להדפיס
פתקית ,עבודה כ TSR -ויצירת תפריטים להקלדת
נתוני העסקה ולכן גודלה קטן פי 2מגודל תוכנית
.INTRFACE
INTRMIN.EXE
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 37 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
14רשימת קבצים -מערכת אשראית 66
EVREX
פקודות אתחול למודמים הנ"ל במקרה של עבודה במהירות . 2411
MI2- I2במידה ומודם עובד במהירות יותר מ 2411 -הגדר MODEMב"עדכון נתוני
מסוף" (ראה תפריט ראשי).
MICROCOM
MOTOROLA
BIOS34.BAT
קבצי אתחול לתקשורת ע"י .INTERRUPT14
BIOS34.DEB
במידה ומודם נמצא על COM3או , COM4לחלק מהמחשבים צריך להריץ
BIOS34.BATלפני ביצוע התקשורת.
TESTDLL.EXE
תוכנית דוגמה להפעלת פונקציה () intrfaceמתוך . INTR32.DLL
SOURCESשל תוכנית . MIN32.EXE
TESTDLL.C
TESTDLL.DEF
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 38 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
16
מבנה קובץ JENR
שם השדה
מס' תווים
מקום יחסי
דור חסומים בטנדם
4
4
11
19
3
6
1
15
12
18
דור חסומים
דור וקטורים
תאריך פרמטרים
מצב חסומים
PC
הערות
YY\MM\DD
– 1תקין
- 1ניתוק בקבלת קובץ מלא.
- 2ניתוק בקבלת ביטולים.
- 3ניתוק בקבלת תוספות.
- 4קובץ חסומים לא תקין.
17מבנה קובץ DATA
הערות
שם השדה
תאריך תנועה ראשונה
תאריך שידור תנועות אחרון
תאריך עדכון חסומים
מספר קובץ
מס' תווים
6
6
6
2
מקום יחסי
11
17
13
15
הרשאה לשידור קודם
הפרש בדורות חסומים
חסימת מסוף
1
4
1
21
22
26
קוד סיום שידור
1
27
– 1תקין
– 1לא התחבר
– 2ניתוק בפרמטרים
– 3ניתוק בתנועות
– 4ניתוק בחסומים
– 9ניתוק בעדכון תוכנה
פרמטרים
תנועות
חסומים
ביצוע תקשורת
1
1
1
1
28
25
31
31
– Aתקין – מוצלח
– 1לא היה צורך בביצוע השלב כל היתר -
ניתוקים.
גרסת קכ"ח
ציון תאריך יום שבו התבקשה
גרסת קכ"ח
3
1
32
39
FILLER
9
36
משתנה מ 11-55 -בכל שידור מוצלח של תנועות.
לא רלוונטי
ראה הערה () 1
– 1מסוף פעיל
– 1תנועות ישנות
– 2הפרש בימים בעדכון חסומים
– 3הפרש בדורות
– 1תחילת התקשרות
– 1סיום התקשרות
הערה:
במקרה של ניתוק בקבלת חסומים ,מראה את ההפרש בין דורות של קובץ חסומים במסוף לבין המחשב
()1
המרכזי של שב"א.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 35 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
18מבנה קובץ STATIS
שם השדה
תאריך וזמן
מס' אסמכתא
מספר קובץ
תאריך תנועה ראשונה בקובץ
שם קובץ גיבוי
דולר
מס' תווים
14
8
2
6
12
1
מקום יחסי
111
119
123
129
131
143
FILLER
35
6
12
6
12
6
12
6
12
44
183
185
111
117
115
129
137
143
6
155
12
6
12
6
12
6
12
6
12
161
173
175
151
157
215
219
227
233
6
12
6
12
6
12
1
1
249
291
263
265
281
287
255
311
( )1מס' תנועות בחובה
סה"כ חובה
מס' תנועות בזכות
סה"כ בזכות
( )2מס' תנועות בחובה
סה"כ חובה
מס' תנועות בזכות
סה"כ בזכות
( )3מס' תנועות בחובה
סה"כ בחובה
מס' תנועות בזכות
סה"כ בזכות
( )4מס' תנועות בחובה
סה"כ בחובה
מס' תנועות בזכות
סה"כ בזכות
( )9מס' תנועות בחובה
סה"כ בחובה
מס' תנועות בזכות
סה"כ בזכות
( )6מס' תנועות בחובה
סה"כ בחובה
מס' תנועות בזכות
סה"כ בזכות
CR
LF
הערות
YYYYMMDDHHMMSS
" - "1נתונים דולרים" ,רווח" – נתונים שקליים
סה"כ לכל חברות האשראי
ישראכרט
כ.א.ל
דיינרס
אמריקן אקספרס
לאומי קארד
קובץ TOTALמכיל נתונים של שידור אחרון באותו מבנה.
כל שידור מוצלח של עסקאות יצור שתי רשומות בקובץ STATISוהן בקובץ – TOTALרשומה ראשונה שיקלית (שדה
"דולר" מכיל "רווח" ) ורשומה שניה דולרית (שדה דולר מכיל ".)"1
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 41 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
16קבצי DUMPוDUMPALL -
קובץ DUMPמכיל דו"ח תקשורת אחרון.
קובץ DUMPALLמכיל דו"ח תקשורת מצטבר אשר מורכב מדוחות שנמצאו בקבצי .DUMP
דוחות בקובץ DUMPALLמופרדים ע"י סימן .)ASCII 12( FF
להלן מבנה קובץ DUMPלמקרה של שידור תנועות:
נתון
שורה
פוזיציות
1
2
1-19
1-7
שם מסוף (שם בית העסק)
מספר המסוף
3
1-11
תאריך שידור במבנה DD/MM/YYYY
4
1-9
זמן שידור במבנה HH:MM
9
6
6-13
5-11
מספר אסמכתא
מספר קובץ (מונה אשר גדל באחד בכל שידור)
שידור תנועות.
7
7
8,5,11
1-4
9-14
סה"כ תנועות חובה בשקל
סה"כ סכום חובה בשקל
כנ"ל לגבי עסקאות דולריות ועסקאות זכות
בשקל ובדולר ,במידה וקיימות.
שורות הבאות מכילות סה"כ סכומים ותנועות באותם פוזיציות לחברות אשראי ובתוך החברות מופיע פירוט
תנועות וסכומים באותם פוזיציות לפי סוגי כרטיסים וסוגי אשראי שונים במידה וקיימים.
הערה:
כל שורה הינה 42בית כאשר 2בתים האחרונים הינם )ASCII 13) CRו. (ASCII 10) LF -
שים לב!
החל משורה ,9מס' השורות יכול להשתנות עקב הופעת הנתונים הבאים בדו"ח התקשורת:
מספרי ספק ,הודעת מערכת וכו'.
לכן במידה ורוצים להוציא מקובץ DUMPאו DUMPALLנתונים כלשהם בצורה ממוחשבת ,יש לחפש
שורה בקובץ אשר מכילה את אותם הנתונים לא לפי מספר השורה .אלא לפי המילים המופיעות בה.
לדוגמא:
"סה"כ"" ,שקל"" ,חובה" ,וכו'.
מומלץ להשתמש בקובץ STATISכקובץ בעל מבנה קבוע.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 41 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
14
מבנה קובץ ISO 95
(ראה נספח – 4עבודה במט"ח)
שם קובץ על הדיסקISO59 :
מספר כניסות בוקטור61 :
אורך ווקטור(בבתים) 611= 61x11 :בתים
מטרת הווקטור:
הגדרת קודי מטבעות ב ISOושמותיהם
מפתח לווקטור:
קוד המטבע הנומרי ב ISO
הווקטור ממוין בסדר עולה.
כניסות שאינן בשימוש יאופסו.
שם שדה
תאור שדה
Iso-curr
קוד מטבע ( ISOנומרי)
אורךשדה
פורמט
הערות
(בתים)
3
n
על פי טבלה ISO 4217
Curr-nameשם קוד מטבע אלפה
3
c
על פי טבלה ISO 4217
filler
4
X
דוגמאות לשימוש -קוד מטבע יורו:
קוד מטבע נומרי 578 :
שם מטבע
EUR :
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 42 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
11רב ספק /רב מוטב
בית עסק מוגדר כרב ספק או רב מוטב במידה ועקב חיוב לקוחותיו יזוכו חשבונות שונים -
באם חשבונות אלה שייכים לאותו בית עסק או באם מדובר על זיכוי חשבונות של בתי עסק שונים.
על מנת לעבוד כרב ספק/רב מוטב יש לבצע תיאומים מראש עם חברת שב"א וחברות האשראי.
.1
רב מוטב
במידה ובית העסק רשאי ומוכן לקבל מחברות האשראי כסף עבור חיובים אשר הוא ביצע למען בתי
עסק אחרים ולהתחשבן עם בתי העסק בכוחות עצמו -הוא מוגדר כרב מוטב.
אופי עבודתו אינו שונה מהרגיל פרט לדבר אחד :רשומה בקובץ INT_INאשר מכיל נתוני עסקה כוללת
פרמטר " "Vעם מספר ספק של בית העסק אשר עבורו בוצע חיוב .הנתון הזה יועבר לחברת האשראי
כנתון אינפורמטיבי בלבד.
.1
רב ספק
במקרה זה חברות אשראי מזכות באופן ישיר את בית העסק אשר עבורו התבצע חיוב.
מפני שמספרי הספק לזיכוי מזוהים עפ"י מספר המסוף אשר קיבל בית העסק בחברת שב"א ,יש לפתוח
מספר מסופים בהתאם למספר ספקים ועוד מסוף אחד (להלן -מסוף מרכזי) עבור בית העסק אשר
מבצע את החיובים.
1.1
הקמת מסופים לרב ספק
א.
ב.
יש להקים מסוף מרכזי( .מסוף אשר שייך לנקודת המכירה שממנה מבצעים את
החיובים עבור כל הספקים).
ליצור ספריות למסופים של בתי העסק אשר יזוכו ע"י חברות האשראי ולהקימם.
לצורך זה יש להפעיל מכל ספריה את תוכנית BUILD/ 1או BUILD95/1ולהכניס את הנתונים
הדרושים.
ניתן לבצע זאת בעבור המסוף המרכזי ולאחר מכן להעתיק את קובץ STARTשנוצר לכל
הסיפריות ולאחר מכן לשנות רק את מס' המסוף בכל סיפריה וסיפריה על ידי שימוש בתוכנית
BUILDאו BUILD95עם פרמטר /1עבור . WINDOWS
ג.
בספריה של המסוף המרכזי יש ליצור קובץ בשם
אשר יכיל מסלולי גישה לכל הספריות הנ"ל לדוגמא:
- C:\ASHRAIT
TRANPTR
מרכזי
- C:\ASH1
מזוכה ראשון
- C:\ASH2
מזוכה משני
ד.
יש לוודא בשב"א שכל המסופים הוגדרו כ" -רב ספק".
ה.
יש לבצע התקשרות מהמסוף המרכזי (להפעיל תוכנית TRANSMITאו תוכנית TRANS95ל-
)WINDOWSבמידה וההתקשרות תסתיים בהצלחה (קבצי DUMPעם דוחות התקשורת
שנוצרו בכל הספריות לא יכילו הודעות על ניתוקים) המסופים הוקמו ,לצורך בדיקה
ממוחשבת ניתן לנתח קבצי DATAשל כל ספק – במקרה של הצלחה שדה "קוד סיום שידור"
מכיל "."1
שים לב! במצב הזה קובץ חסומים ) (NEGנמצא רק במסוף המרכזי.
הערה :במידה וקובץ התנועות לספק כלשהו עלול להכיל 11,111רשומות ומעלה יש להפעיל
תוכנית TRANMAXבמקום TRANSMITאו תוכנית TRMAX95ל ,WINDOWS-וליצור קובץ
אשר מכיל מסלולי גישה בכל הספריות בשם .MAXPTRשיטה זו גורמת לניתוק בתקשורת בין
כל ספק וספק (צריכה להיות הצדקה לשימוש בתוכנית זו).
החל מגירסת תוכנה 9.74אין צורך ביצירת – MAXPTRגם לקבצי TRANמעל 11,111תנועות
יוצרים קובץ TRANPTRומפעילים תוכנית TRANSMITאו . TRANS95
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 43 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
1.1
ביצוע חיובים
א.
ב.
בקובץ INT_INיש לכלול פרמטר ” “Sעם מספר מסוף המרכזי.
לצורך העברת עסקה לספק מסוים יש להיכנס לספרית המסוף של הספק ולהפעיל מתוך
הספרייה תוכנית INTRFACEאו INTR95.EXEאו להשתמש ב.)INTR32.DLL -
מכיוון שקובץ החסומים של רב ספק מתעדכן רק בסיפריה של המסוף המרכזי יש להגדיר את
מיקומו ע"י מילת מפתח . ASHNEG
לדוגמא ASHNEG=C:\ASHRAIT :בקובץ .ENVIRON
או ע"י ) Environment Variablesבדומה לשימוש מילות מפתח כגון IREQ , IWRI :וכו').
ג.
במידה וקיימים מספר קבצי INT_INבספריות שונות של רב ספק ,ניתן לבדוק אותם בריצה
אחת של . INTRFACEלצורך זה יש ליצור קובץ INTPTRבספריה של המסוף המרכזי.
(זהה לקובץ )TRANPTRאשר מכיל שמות ספריות שבהם נמצאים קבצי
1.2
INT_IN
העברת חיובים
יש להפעיל תוכנית TRANSMITאו TRANS95בספריה של המסוף המרכזי.
התנועות תשודרנה מכל הספריות אשר מופיעות בקובץ TRANPTRועדכונים לקובץ חסומים יתקבלו
רק במסוף המרכזי.
הערה :
בכדי לוודא ששידור עבר בהצלחה ניתן לבדוק קוד סיום שידור בקובצי DATAשל כל הספריות
הנמצאות בקובץ . TRANPTRקוד של הצלחה הינו ' , '1ניתן גם לבדוק נוכחות של קבצי ( TRANקבצי
החיובים) בכל ספריה וספריה ,במקרה שלספק מסוים שודר קובץ החיובים בהצלחה אזי המערכת
משנה את שם הקובץ TRANבאותה ספריה לשם אחר (.) TRANBXXX
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 44 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
11טופס פתקית ללקוח
פתקית נוצרת ע"י תוכנית ( INTRFACEעפ"י אופציה "להדפיס פתקית ללקוח" בעדכון נתוני מסוף).
בתוכנית ישנה אפשרות להדפיס ו /או לרשום פתקית בקובץ . NOTE / NOTECL
מבנה טופס פתקית ללקוח
xxxxxxxxxxxxxxx .1
.2מסוף ( ABS-XXX-4S 9999999מגירסה ABS-XXX-6S 6.95
מספר עסק
9999999
hh:mm
dd/mm/yy
.3שם כרטיסxxxx xxxx xxxx xxx :
3.1מספר כרטיס zzzz zzzz zzzz zzzz zzz
בתוקף עד mm/yy
.4מספר שובר
FFCCCSSS
.6סוג עיסקה
6.1סיבת התקשרות
6.2גורם מאשר
.5אופן ביצוע
.7מטבע
.8סוגי אשראי
.9עסקת כוכבים/נקודות
.11עסקת תשלומים zzz, zzz.zz
.11תשלום ראשון zzz, zzz.zz
ועוד
zz
תשלומים נוספים
תשלום נוסף zzz, zzz.zz
No Refund-No Cancellation .12
חתימת הלקוח _____________________
_____________________
טלפון
_______________
טלפון
_______________
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 49 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
הדגשות:
בעסקאות מגנטיות עם כרטיסי תייר בשדה אופן ביצוע יש להדפיס " MSRבמקום "רגיל"
בכרטיסי ויזה תייר בסוף הפתקית יש להדפיסNo Refund-No Cancellation :
שם הכרטיס מתקבל מקובץ הממשק ( )INT_OTאו נמצא בקובץ . NOTE
סוג האשראי נערך/מתורגם על פי קוד סוג האשראי .
יש להדפיס רק 4ספרות אחרונות (ימניות) של מספר הכרטיס בעותק שנמסר ללקוח( .בעותק שנשאר
בבית העסק יש להדפיס את כל המספר) .מפיץ אשר מדפיס פתקית בכוחות עצמו צריך להיערך לכך.
אין להדפיס את תוקף הכרטיס.
במידה ומפיץ מדפיס פתקית מקובץ ( NOTEהמהווה עותק לבית העסק) הוא חייב לערוך את ההדפסה
בהתאם או להשתמש בקובץ חדש NOTECLאשר מתווסף לקובץ NOTEהחל מגרסה 9.71אם
באופציה "עדכון פרמטרים" בשורה "להדפיס פתקית" מוגדר "קובץ כפול" .הקובץ החדש מהווה
עותק פתקית ללקוח ותואם לדרישה( .ראה פירוט האופציות בעמ' ) 12
אם המפיץ מגדיר את השם ו/או מסלול של קובץ NOTEבעצמו אזי אותו טיפול אמור להינתן גם עבור
קובץ החדש אם ברצונך להשתמש בו.
הקרנת ו/או הדפסת נתונים המועברים מהמנפיק למסוף (כולל יתרה)
ברשומת INT_OTבפוזיציה 44מוגדר שדה בשם dsp-detailsבאורך 8תוים ,בו אשראית יכולה
להחזיר יתרה לכרטיס המיועדת להקרנה והדפסה על הפתקית( .כיום רלוונטי מאוד בכרטיס טעינה)
בנוסף קיים ברשומת INT_OTבפוזיציה 4שדה בשם add-dsp-detailsבן תו אחד הכולל הוראות
הצגה ו/או הדפסה של תוכן השדה הנ"ל.
השדה יכול להכיל את הערכים הבאים:
דרישה להקרנת מסר נוסף
Add-dsp-details
1
אין דרישה (ברירת מחדל)
1
נדרש להקרין ולהדפיס המסר בפתקית ,במטבע ש"ח
2
נדרשת הקרנת המסר בלבד במטבע ש"ח
3
נדרש להדפיס את המסר רק בפתקית במטבע ש"ח
4
נדרש להדפיס בפתקית ולהקרין במסך מטבע דולר
9
נדרש להדפיס בפתקית ולהקרין במסך מטבע יורו
6
נדרש להקרין ולהדפיס את המסר בפתקית במט"ח
7
נדרש להקרין את המסר במט"ח
8
נדרש להדפיס את המסר רק בפתקית במט"ח
אופן הקרנת/הדפסת תוכן השדה dsp-details
כאשר יש בשדה add-dsp-detailsהנחיה להקרין ו/או להדפיס ,יש להציג ו/או להדפיס את תוכן
השדה dsp-detailsבתוספת המלל הבא:
"יתרך המעודכנת בכרטיס <תוכן השדה > dsp-detailsש"ח ט.ל.ח"
בעסקאות שהתבצעו במט"ח יופיע סכום העסקה במט"ח .שם המטבע יילקח מקובץ ISO 95
ראה מבנה בפרק . 21
"יתרך המעודכנת בכרטיס <תוכן השדה < > dsp-detailsשם המטבע> ט.ל.ח"
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 46 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
.1
שם המסוף
.1
ראה קובץ ( PARMNEWפוזיציה 46באורך 19תווים).
מסוף
7ספרות מקובץ ( .STARTמפוזיציה 1באורך ) 7
מספר מסוף -
מהדורת תוכנה -
.VERSION.EXE
8
תווים במבנה
ABS – XXX –6S
,התווים 3 - XXXתווים ראשונים מקובץ
מספר עסק בחברת האשראי 7 -ספרות (מקובץ ) PARMNEW
ישראכרט -JCB,פוזיציה 111
כ.א.ל - .פוזיציה 136
דיינרס -פוזיציה 171
אמקס - .פוזיציה 216
לאומיקארד -פוזיציה 241
.2
3.1
מקובץ INT_OT
שם כרטיס
פוזיציה 114אורך 19תווים.
מקובץ INT_OT
מספר כרטיס
פוזיציה 9אורך עד 15תווים.
בעותק שנשאר בבית העסק יש להדפיס את כל המספר.
בעותק שנמסר ללקוח יש להדפיס רק 4ספרות אחרונות (ימניות) של מספר הכרטיס ,בכל הכרטיסים
כולל כרטיסי תייר.
בשני העותקים אין להדפיס תוקף.
.4
מספר שובר
מספר קובץ
מספר קופה
מספר סודר
מקובץ INT_OT
(פוזיציה 56אורך 2תווים)
(פוזיציה 58אורך 3תווים)
(פוזיציה 111אורך 3תווים)
FF
CCC
SSS
4
.
סוג עסקה
חיוב
מאושרת
מקובץ INT_OT
)(a
XXXXXXX
)(b
X
)(c
XXXX
מאולצת
זיכוי
זכות מאושרת
- A
- B
)(a
XXXXXXX
)(b
X
)(c
XXXX
מספר אישור (פוזיציה 7 , 71תווים).
סיבת הבקשה לאישור (מקובץ INT_OTפוזיציה 65
,תו: ) 1
אקראי= א
1
1
=
ת
-
תקרה
2
=
מ
-
מספר סודי
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 47 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
4
=
ש
-
קוד שירות (בפס המגנטי)
6
=
ח
-
חסום לא חד משמעי
7
8
6
=
=
=
=
4
י
ט
פ
-
Z.F.L
A
c
.6
-
בקשה לאישור יזומה
טעינה
פריקה
שב”א
גורם מאשר (מקובץ INT_OTפוזיציה :) 71
-1
-2
חברה
-3
ידני
מקובץ ( INT_OTפוזיציה ) 66
אופן ביצוע
וJCB -
ישראכרט כולל אמקס
- 11רגיל
- 11שירות עצמי
- 12שירות עצמי בתחנות דלק
- 91עסקה טלפונית
- 91חתימה בלבד
כ.א.ל כולל דיינרס
- 11רגיל
- 11שירות עצמי
- 12תחנות דלק
- 91עסקה טלפונית
- 91חתימה בלבד
לאומיקארד
- 11
- 11
- 12
- 91
- 91
.7
4
1
רגיל
שירות עצמי
שירות עצמי בתחנות דלק
עסקה טלפונית
חתימה בלבד
מטבע מקובץ ( INT_OTפוזיציה 64תו ) 1
מטבעבהתאם לקוד מטבע ISOשנרשם ב INT_IN
מיוחד
שקל הדפס ש"ח לכרטיס ישראלי NIS :לכרטיס תייר-
1
-
דולר
4
8
-
צמוד דולר -
צמוד מדד -
הדפס USD
כרטיסתייר
יוןכרטיס
ציין
תייר נלקח מקובץ INT-OTפוזיציה 115תו .1
הערה :צ
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 48 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
.8
סוג אשראי
ישראכרט
כ.א.ל.
דיינרס
.5
אמקס
1
2
3
4
9
6
8
-
רגיל
ישראקרדיט
חיוב מיידי
מועדון
סופר קרדיט
קרדיט בתשלומים
תשלומים
5
-
מועדון בתשלומים
לאומיקארד
1
2
3
4
6
-
(1
8
-
תשלומים
רגיל
עדיף31+/
חיוב מיידי
מועדון
1
2
3
4
9
-
רגיל
עדיף31+/
חיוב מיידי
מועדון
סופר קרדיט
6
8
-
קרדיט
תשלומים
קרדיט
בעסקת כוכבים יודפסו שתי שורות עבור הסכום:
סכום חיוב בש"ח (הסכום נטו):
סכום בש"ח שהומר לכוכבים:
לפני חתימת הלקוח תודפס הערה "ידוע לי כי באם לא תהיה לזכותי כמות הכוכבים שציינתי יחויב חשבוני
במחיר היחסי בהתאם לכמות הכוכבים בחשבוני".
המושג "כוכבים" בישראכרט מקביל למושגים מיילים באמריקן אקספרס ונקודות בכ.א.ל.
הערות.1 :
.2
.14
1
2
4
9
6
8
5
-
רגיל
אמקס קרדיט
מועדון
סופר קרדיט
קרדיט בתשלומים
תשלומים
מועדון בתשלומים
דיינרס ולאומיקארד.
עסקת כוכבים מתבצעת רק בכרטיסים ישראליים ובש"ח.
שלוש השורות הן למקרה של עסקה בתשלומים.
במקרה של קרדיט (וכו') תופיע רק שורה אחת.
() 1
(מספר תשלומים.)ZZ :
כרטיסי דיינרס:
קידומת - 3דיינרס קרדיט
קידומת - 6קרדיט
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 45 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
12מערכת אשראית -עבודה ברשת
12.1תוכנית ממשק INTRFACE.EXE -
לתוכנית הממשק קיימות שתי צורות לעבודה ברשת:
כל תחנה (קופה) בעלת מחיצה נפרדת
1.1
במחיצה זאת תוכנית המשתמש בונה קובץ , INT_INהמכיל נתוני עסקאות אשר נקלטו באותה
תחנה ,מפעילה תוכנית הממשק ,ומקבלת ממנה קובץ INT_OTעם תוצאות הבדיקה.
כל יתר קבצי המערכת כגון :קובץ TRANאשר מכיל נתוני עסקאות שעברו בדיקה ומיועדים
לשידור לחברות אשראי .קובץ NEGשל כרטיסים חסומים וכו' ,נמצאים במחיצה משותפת של
הרשת.
כדי להצביע לתוכנית הממשק למחיצה הזאת ,יש להגדיר את המשתנים הבאים ע"י פקודת
. SET-DOSלדוגמא:
\SET IREQ=F:\ASHRAIT
\SET IRDI=F:\ASHRAIT
\SET IWRI=F:\ASHRAIT
כאן - ASHRAITשם מחיצה משותפת בדיסק .F:
כל האותיות גדולות אין רווחים פרט לאחר המילה .SET
את הגדרות הנ"ל ניתן לשים בקובץ
AUTOEXEC.BAT .
לבדיקה האם ההגדרות אכן קיימות במערכת ההפעלה ,מספיק להקליד פקודה SETומערכת
ההפעלה מקרינה את ההגדרות הקיימות.
הערות:
א.
נעילת קובץ , TRANהמשותף לכל תחנות ,מתבצעת ע"י תוכנית הממשק ,כל עת
שהתוכנית רושמת בו נתוני עסקה.
למען זה תוכנית הממשק יוצרת בתחילת הכתיבה יוצרת קובץ ריק בשם
ובסוף הכתיבה מוחקת אותו.
תוכנית הממשק ,אשר הופעלה בו זמנית מתחנה אחרת ,תמתין עד שקובץ
INT_LOCKימחק ,ואז תרשום את הנתונים שלה.
INT_LOCK
ב.
במידה וקובץ INT_LOCKלא ימחק תוך 11שניות תוכנית הממשק הבאה בתור,
תרשום את הנתונים ותמחוק אותו בכל זאת.
במידה ומודם נמצא רק באחת מהתחנות ותוך כדי בדיקה יכול להיווצר מצב
שתוכנית הממשק צריכה ליצור קשר עם מחשב של חברת אשראי לצורך קבלת
האישור ,יש להגדיר באופציה "עדכון נתוני מסוף" של תפריט ראשי
"תקשורת באמצעות - INTERRUPT 14כן" .
תוכנית INTRFACEפונה למודם באמצעות . INTERRUPT 14
אפשרות זו מאפשרת לתוכניות מיוחדות של הרשת (לרשת NOVELLתוכנית כזאת
נקראת , )MODEM.ASSISTלהפנות את הפניה לתחנה עם מודם.
במידה ויש צורך להכניס לפתיחת/סגירת PORTברשת פקודות מיוחדות ( MODEM
ASSISTלמשל דורש את זה),יש ליצור קבצים בשם INT14_ ON.BAT :ו-
INT14_OF.BATאשר יכילו פקודות פתיחה /סגירה.
אזי לפני פניית INTRFACE.EXEלמודם תופעלנה פקודות מקובץ , INT14_ON.BAT
לאחר שהתקשורת הסתיימה יופעלו פקודות מקובץ . INT14_OF.BAT
ג.
שיטה אחרת למודם מרוחק ,המתבססת על תוכנית המשתמש אשר רצה בלולאה אין
סופית .המחשב המצויד במודם מחכה לאיתות מתחנת העבודה( .לדוגמא לצורך
העברה מתחנת העבודה את קובץ ) INT_INאזי התוכנית הנ"ל מפעילה את ה-
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 91 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
INTRFACEבאותו מחשב המצויד במודם .בשיטה הזו המודם למרות שהינו יחיד
ברשת ,מפסיק להיות מרוחק הרי ה INTRFACE-הורץ על המחשב עם המודם !
כמובן תוכנית המשתמש צריכה לדעת לנהל תור מקבצי עסקאות אשר מגיעים
מתחנות העבודה .במידה ויש כמות עסקאות גדולה ולא רצוי לעצור את מהלך
העבודה ,כל עוד המחשב עסוק בתקשורת אפשר לפצל את ביצוע העסקאות לשני
חלקים :בתחנת קצה מופעל INTRFACEעל INT_INעם שדה ( J1לא להתקשר) אזי
רק עסקאות שיחזירו ב INT_OT -סטטוס ( 41-47חייב להתקשר) יועברו למחשב עם
מודם עם שדה ( J4להתקשר אוטומטית).
ד.
1.1
כדי להבטיח שכל רשומה בקובץ TRANתהיה בעלת מספר ייחודי ,יש להכניס לכל
תחנה בקובץ INT_INמספר משלה ("שדה " Iבקובץ .)INT_IN
כל התחנות פועלות באותה מחיצה
צורה זאת משמשת כעקרון כאשר אין לתחנה דיסק קשיח משלה.
כל הדברים שנאמרו לעיל נכונים גם לגבי צורה זאת בנוסף ,יש לדאוג שקבצים
INT_IN
ו INT_OT -אשר נוצרים תוך כדי עבודה מתחנות שונות לא יעלו אחד על השני.
לצורך כך הוסף לכל תחנה את ההגדרות הבאות:
< שם קובץ קלט>
< שם קובץ פלט >
\SET INT_IN=F:\ASHRAIT
\SET INT_OT=F:\ASHRAIT
< שם קובץ הפתקית >
\SET NOTE=F:\ASHRAIT
לכל תחנה שמות של קבצים קלט ופלט המוגדרים ע"י SETצריכים להיות שונים.
לדוגמא:
, INT_IN1ו , INT_OT1-ו INT_IN2 , NOTE1 -ו , INT_OT2 -ו NOTE2 -וכו'.
הערה:
באם מחיצה שממנה תוכנית המשתמש מפעילה את תוכנית הממשק הינה אותה מחיצה
המכילה את קבצי המערכת (בדוגמא שלנו שמה , )ASHRAIT
אזי אין צורך בהגדרת משתנים IREQ, IRDI, IWRIוניתן לרשום את ההגדרה האחרונה בצורה
מקוצרת:
SET INT_IN=INT_IN1
SET INT_OT=INT_OT1
SET NOTE=NOTE1
12.1תוכנית עצמאית
תוכנית עצמאית אינה דורשת תוכנית נוספת לקליטת נתוני עסקה ויצירת קובץ .INT_IN
להפעלת התוכנית הקלד:
INTRFACE / INPUT
הפקודה הנ"ל מבוצעת גם בהקשת ENTERבאופציה "טיפול בעסקאות" של התפריט הראשי.
כל הדברים שנאמרו לעיל נכונים גם לגבי תוכנית עצמאית .בנוסף ,לכל תחנה אשר משתמשת בתוכנית
<מספר ייחודי של התחנה < =SET CASH
עצמאית ,יש להגדיר
וזאת מפני שלמשתמש אין אפשרות להכניס מספר תחנה דרך קובץ . INT_IN
12.2העברת עסקאות לחברות האשראי
יש להפעיל תוכנית TRANSMIT.EXEממחיצה המכילה את קבצי המערכת ( NEG, TRANוכו').
שים לב!
התוכנית לא מתייחסת להגדרות משתנים IREQ, IRDI, IWRIהמפורטים לעיל.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 91 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
14שרת אשראית
14.1כללי
שרת אשראית נועד לספק שירותים ללקוחות המעונינים להפעיל את המערכת אשראית בשרת ולא בתחנות הקצה.
השרת מופעל כתוכנית ( AshServ.exeעבור WINDOWS 98ומעלה( ו( Service-תוכנית אשר רצה באופן קבוע ברקע) –
( AService.exeעבור WINDOWS NTומעלה).
שימוש במערכת מיועד למערכות שאמורות לספק שירותים למספר פניות במקביל כאשר יש רק מחשב PCאחד עם
מערכת ההפעלה חלונות (לדוגמה תחנת דלק ,כאשר PCאחד תומך במספר משאבות או חנות ווירטואלי ב Internet-וכד').
אין הבדלים משמעותיים בין תוכנית רגילה ( )AshServ.exeלבין ,.) AService.exe( Serviceשהוא תוכניות אשר מופעלות
אוטומטית בהפעלת מחשב ללא ביצוע Logonונושאות
ממשק משתמש מובנה ( ) Services - Manage –My computerהמאפשר שינוי אופן הפעלה ,נתמכים על-ידי מערכות ההפעלה
.) Windows NT/2000/XP
הסברים בהמשך מתייחסים גם לתוכנית וגם ל( Service-להלן נקראים שניהם שרת אשראית או שרת) ,אלא אם צוין
אחרת.
יש לזכור שצורת העבודה זו שבה תחנת הקצה איננה עצמאית אלא תלויה בשרת ,מיצרת מצב שבו נפילת השרת גוררת
הפסקת עבודה.
14.1מהלך עבודה.
כרשר השרת פועל במחשב מסוים ברשת הוא מאזין לפורט TCP-IPלפי בחירתו של המשתמש (ברירת מחדל – .)7777
ברגע שנשלחות לכתובת זו נתוני עסקאות לבדיקה מתחנות קצה כלשהן ברשת ,השרת מקבל אותן ומפעיל מהלך בדיקות
רגיל על כל עסקה מבלי לחכות לסיום של מהלך הבדיקות של עסקאות הקודמות (כולל ביצוע בקשה לאישור במידת
הצורך – בקו .) TCPIP
למעשה השרת מפעיל את תוכנית ( Intr95.exeמספר פעמים במקביל) ומעביר לה נתוני עסקה לבדיקה.
כאשר מסתיימות הבדיקות על עסקה כלשהי מחזיר השרת את תוצאות הבדיקה לתחנת הקצה שיזמה את העסקה.
נתוני עסקה לבדיקה והתשובה מועברות בפרוטוקול TCP-IPלכתובת ברשת של המחשב בו רץ שרת אשראית ,לפורט
שמוגדר כפורט האזנה של שרת אשראית ,במבנה מסורתי של שב"א (מבנה קבצי INT_INו ,(INT_OT-כאשר בסוף נתוני
עסקה לבדיקה ) ) INT_INמופיע ASCII 31 - Carriage Returnו ASCII 31 – Line Feed-כסימני סוף נתונים של העסקה וכך
גם בסוף תשובה (במבנה
של ) INT_OTששרת מחזיר.
14.2תצורות עבודה
ניתן להשתמש בשתי צורות העבודה העיקריות:
.1כל העסקאות המגיעות לשרת שייכות לאותו מסוף (ישנה ספרית אשראית אחת )
.2מוגדרים כמה מסופים בספריות שונות של מחשב שרץ בו שרת ,וצריך לשייך כל עסקה לספריה מסוימת (למשל
תצורה של רב ספק ,למרות שיכול להיות גם מספר מסופים (ספריות) בלתי תלויים באותו מחשב ).
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 92 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
14.2.1ניהול מסוף בודד בשרת.
במידה ומדובר בספריה משותפת ,צריך רק להגדיר לשרת את המסלול באחד מהשיטות המקובלות באשראית:
.1לגרום לכך שספרית המסוף תהיה ספרית העבודה ( )Current Directoryשל השרת.
לשם כך בד"כ באותה ספריה שמים גם תוכניות של מערכת האשראית כולל תוכנית AshServ.exeומפעילים
אותם משם.
.2ניתן לשים בספרית העבודה של AshServגם את קובץ Environעם שורות המצביעות
למיקומה של ספרית המסוף לדוגמה:
\( IREQ=C:\ASHRAIT\MAINמסלול קבצי חסומים ופרמטרים כלליים)
\( IWRI=C:\ASHRAIT\MAINמסלול קובץ תנועות TRAN-וקובץ )DATA
\( IRDI=C:\ASHRAIT\MAINמסלול קבצי פרמטרים ספציפיים)
.3על-ידי פקודה SETבקובץ : Autoexec.bat
\SET IREQ=C:\ASHRAIT\MAIN
\SET IWRI=C:\ASHRAIT\MAIN
\SET IRDI=C:\ASHRAIT\MAIN
.4במערכות כמו XPניתן להגדיר משתנים הללו ( )IRDI,IWRI,IREQעל-ידי אופציה :
My Computer-Properties-Advanced-Environment Variables-System Variables
שיטה 4מומלצת במקרה שרוצים להשתמש ב AService-מכיוון ששאלה של ספרית העבודה
עבור Servicesהנה בעייתית.
אין לשכוח סימני "\" בסוף כל מסלול.
הפקת פתקיות :
במידה ויש צורך להפיק פתקית עבור העסקה יש לדאוג שקבצי הפתקיות ( NOTEעבור פתקית של בית העסק ו-
NOTECLעבור פתקית של לקוח) ,לא יתנגשו בגלל יכולת העבודה במקביל של השרת .לצורך כך על כל תחנת
הקצה אשר שולחת עסקה לשרת לשים בתוך המסר של נתוני העסקה בין סימני "@" את שמות הייחודים עבור
אותה קופה לקבצי פתקיות ,למשל:
@B10000003C12345D011151I002T0405X1234@NOTE=NOTE1 NOTECL=NOTECL1
כמובן שיש לבחור את האופציה – "קובץ כפול" בין פרמטרים של אשראית ,המוגדרים על-ידי תוכנית
.Build95.exe
לאחר שעסקה בוצעה ותשובה אשר התקבלה בתחנת הקצה הנה חיובית ניתן לבקש את הפתקית על-ידי שליחת
מילה NOTEו/או ( NOTECLבהתאם לשם שמועבר בנתוני העסקה) לשרת ,לדוגמה:
GETFILE:NOTECL1
כרגיל בסוף המסר יש לשים Carriage Returnו .Line Feed -קידומת של שם הקובץ חייבת להיות .NOTE
במידה ורוצים לקבל מספר קבצים ,אזי נשלחים מספר מסרים עם שמות קבצים.
בסוף נתוני קובץ אשר מחזיר שרת נשלח תו .) ASCI12 ( End of file
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 93 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
כל תחנת קצה אשר שולחת עסקאות לשרת חייבת לשים בנתוני העסקה שדה “( ”Iמספר קופה) ייחודי לאותה
קופה (מחשב).
גם תחנת קצה בודדת יכולה לשלוח מספר עסקאות לשרת מבלי לחכות לתוצאות בדיקה של עסקאות הקודמות
ועסקאות יטופלו על-ידי השרת במקביל .בתרחיש כזה תחנה הבודדת יכולה לפתוח מספר Socketsלשרת וכל
פעם לשלוח עסקה דרך Socketאשר התפנה.
במידה והשרת לא יכול לטפל בעסקאות נוספות עד לשחרור משאבים מטיפול בעסקאות הקודמות בגלל עומס
גדול מדי ,מוחזרת הודעה מיוחדת לתחנת קצה (ראה להלן רשימת קודי שגיאה).
14.2.1ניהול מספר מסופים בשרת.
במקרה שמדובר במספר מסופים (בספריות שונות) ,אשר קיימות בשרת ,ויש צורך לשייך כל עסקה למסוף
מסוים ,המסלול של אותו מסוף מופיע בין סימני "@" בנתוני עסקה למשל:
@B10000003C12345D011151T0405X1234@C: \ashrait\sapak1
אין צורך להגדיר שמות שונים לקבצי פתקיות כי ההנחה שלא תשלח עסקה החדשה מאותו מסוף מבלי לקבל
תשובה לעסקה הקודמת ,אך אם מאחורי ספק מסוים עומדת רשת של קופות ניתן גם להכניס את השמות
הייחודיות לפתקית עבור כל קופה ,לדוגמה:
;
@B10000003C12345D011151T0405X1234@C: \ashrait\sapak1 NOTE=NOTE1 NOTECL=NOTECL1
במידה ומדובר ברב ספק ,כאשר קובץ החסומים נמצא בספריה משותפת (מסוף הראשי) ,ניתן להגדיר את
מיקומו של מסוף הראשי על-ידי שיטות 1-4שפורטו לעיל ,כאשר מילת מפתח היחידה שמוגדרת הנה ,IREQ
לדוגמה:
\IREQ=C:\ASHRAIT\MAIN
דרך נוספת להעביר את מיקומו של מסוף מסוים -זה ליצור בספרית עבודה של AshServקובץ בשם
SAPAKPTRאשר מכיל מספרי מסוף ומסלולי ספריות שלהם ,לדוגמה:
1234567,C:\ASHRAIT\SAPAK1
1212121,C:\ASHRAIT\SAPAK2וכו'.
אזי קריאה יכולה להיראות כך:
@B10000003C12345D011151T0405X1234@1234567
או
;
@B10000003C12345D011151T0405I003X1234@1234567 NOTE=NOTE2 NOTECL=NOTECL2
ניתן גם להעביר את המסלול של קובץ SAPAKPTRכפרמטר .AshServ /SapakPtr:C:\ashrait :
רישום מסלול של הקובץ במקרה שימוש שרת אשראית כ Service -נעשה ב( Registry-ראה סעיף .)4
חשוב !
על-פי כללי מערכת ההפעלה Serviceלא מכיר מיפויים (למשל , L:\SHVAכאשר Lמיפוי לדיסק ברשת .לכן
במקום מיפוי יש להשתמש בכתובת TCPIPשל השרת הרצוי ,לדוגמה
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 94 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
.//11.248.241.16/shva
במידה ומשתמש רוצה לקבל פתקית של מסוף מסוים הוא יכול לשלוח מסר כמו:
@ ,GETFILE:NOTECL2@C:\ASHRAIT\SAPAK2כאן מוגדר מסלול בשרת של מסוף או
@ ,GETFILE:NOTECL2@1234567כאן מוגדר מספר מסוף ( )1234967שלפיו שרת ימצא
מסלול מתאים בקובץ .SAPAKPTR
14.4התקנה והפעלה שרת אשראית.
ללקוח יסופק קובץ ASHSERV.ZIPאשר יכיל ערכת ההתקנה של שרת אשראית .ההתקנה מתבצעת על-ידי
הפעלת תוכנית .SETUP.EXEכתוצאה של ההתקנה נוצרת ספרית ASHSERVבתוך ,Program files folderאשר
מכילה מספר תוכניות הקשורות לנושא:
- AshServ.exeתוכנית של שרת אשראית.
א.
Service – Aservice.exeשל שרת אשראית.
ב.
– CallServ.dllשגרות עזר לפניה לשרת (ראה להלן).
ג.
– TestServ.exeתוכנית הקדמה לעבודה עם שרת
ד.
– AshServ.docתיעוד זה.
ה.
אפשרי שיהיו קבצים נוספים.
ו.
ניתן להעביר קבצים הללו לספריות אחרות ולהפעילם משם.
הפעלת תוכנית AshServ.exeמתבצעת עם שני פרמטרים :
AshServ /p:xxxxx /s:yy
כאן – xxxxxמספר פורט להאזנה (ברירת מחדל – yy ,) 7777מספר עסקאות אשר ניתן לבדוק במקביל (ברירת
מחדל וערך מקסימלי – על-פי רשיון ).
לשימוש AServiceיש להפעילו בפעם הראשונה בצורה
AService.exe -Service
זה מתקין את ה Service-למחשב NTבמצב הפעלה ידנית.
לאחר מכך הוא מופיע ברשימת Servicesשל מחשב וניתן להגדירו כמופעל אוטומטי בהפעלת
המחשב ( .) Services – Menage –My computer
הסרת ה Servece-מתבצעת על-ידי פקודה
AService.exe -UnregServer
שינוי אפשרי של , Portמספר עסקאות מקביליות עבור Serviceומסלול עבור קובץ ( SapakPtrאם יש צורך בכך)
ייעשה ב:Registry-
HKEY_USERS\.DEFAULT\Software\VB and VBA Program Settings\AService\StartUp
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 99 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
במשתנים Portו NumSocket-ניתן להכניס נתונים מתאימים.
במשתנה SapakPtrבאותו מקום ניתן להכניס מסלול לקובץ SAPAKPTRלדוגמה.C:\Ashrait :
הכניסה הזו ל Registry-נוצרת לאחר התקנת AServiceבפעם הראשונה.
כל המשתנים מסוג “ .”stringלאחר שינוי נתונים ב Registry -יש לעצור ולהפעיל מחדש .AService
14.4.1כמות קישורים במקביל.
הגבלה למספר פניות מקביליות לשרת (נדגיש שמדובר בפניות ולא בחיבורים – מספר חיבורים לא מוגבל) ,נעשה
בשב"א ותלויה ברשיון של הלקוח ,וזאת בנוסף להגבלה שבפרמנטר ההתקנה.
במקרה ונעברו מספר פניות מקביליות המותרות על-פי רשיון או פרמטר הנ"ל (הקטן ביניהם) ,מתקבלת קוד
שגיאה .211המצב קורא בד"כ שתשובות לשאילתות מתעכבות בגלל תקלה כלשהי (למרות ש 58%של שאילתות
מסתיימות תוך שניה-שתיים ) ואז מצטבר מספר פניות מקביליות).
אם התקבל קוד 211בפניה ראשונה לשרת אשראית ,יש לפנות לשב"א לבדיקת פרמטר המגדיר את הקמות.
14.4הערות כלליות.
.1
בכדי שרת יוכל למצוא Intr95.exeיש להפעילו מספריה שבה Intr95.exeנמצאת או לשים מסלול של
Intr95.exeלתוך משתנה גלובלי Pathשל מערכת ההפעלה ב Autoexec.bat-או (במחשבי ( XPבאופציה
My Computer-Properties-Advanced-Environment Variables-System Variables
.2
במידה ומועברים עם נתוני עסקה מסלולים אשר מכילים סימן "=" (כגון =IREQאו )=NOTEצריך
להימנע משימוש במסלולים ארוכים (אורך של נתונים הללו לא יעלה על 81בית) וכן מהמסלולים
המכילים רווחים.
.3
תוכנית Intr95.exeהמורצת על-ידי השרת ,פותחת חלון שבו מתארת את שלבי השאילתא ("ממתין
לתשובה" וכו') .במקרה של שאילתאות מקביליים פתיחתו וסגירתו של החלון לוקחות זמן ומשאבים
כאשר מדובר על השרת ולא על תחנת העבודה .במידת הצורך ניתן לבטל את החלון על-ידי שינוי
אופציה "להקרין שלבי התקשרות" במקש "עידכון פרמטרים" של תוכנית ( Ash95.exeאו להריץ
תוכנית .)Build95.exe
.4
בדיקת זמינות של השרת יכולה להתבצע על-ידי שליחת מסר “ ”TESTשמסתיים ב ”Carriage Return-ו-
“ . ”Line Feedאזי שרת עונה “.”OK
.9
לצורך לקבל קובץ TEXTכלשהו משרת תשלח תחנת קצה מסר בפורמט:
><<Carrige Return><Line Feedשם קובץ< .GETFILE:החל מגירסה לגרסה 1.1מטעמי אבטחת מידע
מתאפשרת רק קבלת קובץ עם קידומת ( NOTEפתקית).
לדוגמה :
( GETFILE:NOTECLקובץ פתקית) .בסוף הנתונים של הקובץ יישלח סימן .)12 ASCII( File Feed
.6
בעתיות בעבודה Server –Clientבאה לידי ביטוי בין היתר בכך ,שנפילת רשת ו/או שרת מעמידה
בסימן שאלה את גורלן של עסקאות שנשלחו לשרת מתחנות קצה ותוצאתן טרם התקבלו.
הגדרת פרמטר "בדיקת עסקאות כפולות" באשראית פותרת את הבעיה ,כאשר עסקאות אשר נרשמו
בקובץ החיובים לא ניתן לבצע פעם נוספת .בדיקת הכפילות מתבססת על מספר כרטיס,סכום ,סוג
אשראי ופרמטר נוסף אשר מוגדר כמספר ייחודי לעסקה על-ידי לקוח (שדה .) X
שימוש בשדה “ ( ”Xמספר ייחודי ) מומלץ מאוד בכדי לוודא שתשובה שהתקבלה שייכת לעסקה
המתאימה ,במיוחד כשתחנת קצה שולחת מספר עסקאות ללא המתנה והתשובות חוזרות לא בהכרח
באותו סדר.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 96 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
.7
שימוש בשדה “( ”Iמספר קופה) מומלץ כאשר משתמש פותח מספר ה SOCKET‘s-ל .Server-אזי שימוש
במספר קופה ייחודי לכל SOCKETמפתיח את האי-כפילות במספר שובר (מספר קופה +מספר סודר
בקופה) עבור כל עסקה.
.8
במהלך העבודה נוצר קובץ AshServ.logהמכיל את הנתונים הבאים:
א.
ב.
ג.
ד.
ה.
ו.
זמני התחלה וסוף ביצוע עסקה
מספר סידורי של תחנת קצה בשרת (לפי סדר התחברותן).
מספר בדיקות המתבצעות במקביל מאותה תחנת קצה.
תוצאת בדיקה
נתוני עסקה במבנה INT_IN
תוצאת בדיקה במבנה INT_OT
14.6שידור תנועות.
שידור תנועות (תוכנית ) Trans95.exeמופעלת על-ידי תהליך שלא קשור לשרת האשראית.
אפשר להמליץ על כמה דרכים לעשות זאת:
א .אם מדובר בספריה בודדת – להפעיל , Trans95כאשר ספרית הנ"ל הינה ספרית העבודה.
ב .אם מדובר על מספר ספריות (מסופים) מומלץ להגדיר אותם כמסופי רב ספק,
ליצור בספריה של מסוף מרכזי (ראה פרק עבודה כרב ספק) קובץ TRANPTRאשר יכיל מסלולים של כל
המסופים המיועדים לשידור +מסלול של מסוף מרכזי כמסלול ראשון ברשימה .אזי הפעלה חד-פעמית של
תוכנית Trans95.exeמתוך ספריה של מסוף המרכזי תגרום לשידור באותו Sessionמכל המסופים שמסלולם
מופיעים בקובץ .TRANPTR
יש להתחשב בעובדה שקובץ חסומים יתעדכן רק בספריה של מסוף המרכזי ולכן בשביל שרת אשראית
נדרשת הגדרה <מסלול מסוף המרכזי> =.IREQ
הערה:
כל עוד שתוכנית Trans95פועלת קיים קובץ TRANLOCKבספריה שממנה Trans95הופעל.
תהליך אשר מפעיל תוכנית זו יכול להסתמך על כך בכדי לדעת האם תוכנית כבר הסתימה.
14.7קודי שגיאה המוחזרים על-ידי שרת אשראית.
להלן קודי שגיאה המועברים לתחנת קצה במקרים מיוחדים (בנוסף לקודים רגילים של
תוצאות בדיקה ) .גם קודים האלה מועברים במבנה של קובץ INT_OTאך רק שדה סטטוס ושדה "מספר ייחודי"
בו מכילים נתונים (שדה "מספר ייחודי מכיל נתונים אם בנתוני עסקה היה שדה "."X
במקומם יתר שדות ישנם רווחים.
השדה "סטטוס" יכול להכיל אחד מערכים הבאים:
– 211עומס יתר (פרמטר הקובע מספר מקסימלי של פניות מקביליות – מוגדר בשב"א)
– 211תקלה בהעברה נתוני עסקה לבדיקה .אם בנתוני עסקה מועבר מסלול של מסוף
יש לבדוק את תקינותו.
– 212תקלה בקבלת תוצאות בדיקה.
– 213תקלה
בהפעלת מהלך בדיקה .יש לבדוק האם שרת יכול למצוא את INTR59.EXE
( ראה סעיף .) 9.1
– 214תקלה במהלך התחברות תחנת הקצה לשרת (רשום רק ב.) AshServ.log-
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 97 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
– 219תקלה במהלך קליטת נתוני עסקה לבדיקה.
– 216תקלה בעבודה עם קבצים.
– 217תקלה בהגדרות של מסלול מסוף (בד"כ אין סימן "@" הסופי).
– 218תקלה בגישה לקובץ .SAPAKPTR
.Timeout – 215בדיקה לא הסתיימה תוך זמן מוקצה (כ 61-שניות).
– 221קובץ ,אשר התבקש באופציה GETFILEאינו זמין.
לצורך בדיקת תפקוד של AshServמצורפת תוכנית ההדמיה של פעילות .TestServ –Clientעל-ידי הפעלתה
משתמש יכול לשלוח שאילתא לשרת ולקבל תגובה.
CallServ.dll 14.8
כללי:
במידה ומשתמש לא רוצה לעבוד עם TCPIPמתוך האפליקציה שלו ניתן להשתמש ב. CallServ.dll-
dllזה מכיל פונקציות עזר לפניה לתוכנית AshServ.exeהמופעלת ב – .server
קוד ה – dllכתוב בשפת .C
פונקציה
פרמטרים
ערך חזרה
OpenSocket
(char *) Port
)(long
פתיחת socket
כתובת מחשב )* (char
ערך המתאר Socket
הערות:
– Portהנו פורט האזנה של AshServ
כתובת – הנו כתובת TcpIpשל שרת
- sock
שנפתח .יש רק להעביר אותו
כערך longרגיל לפונקציות
הבאות.
( )-1כשלון
שעליו רץ AshServ
SendRecv
שליחת השאילתה
)char *( -Buffer1רשומת נתוני עסקה
לבדיקה (מסתיימת ב 1-בינרי( במבנה
.Int_In
(char *) - Buffer2לקבלת תשובה לשאילתה
) – (Int_Otלפחות 211בית
)long( – sockערך שהתקבל מ-
)(long
1ויותר -הצלחה של פונקציה
יש לנתח ) Int_Ot( Buffer2
לקבלת תוצאות בדיקה
( )-1כשלון בפעולת Send
)-2( OpenSocketכשלון בקבלת תשובה
)(Receive
CloseSocket
)long( –sockערך שהתקבל מ-
OpenSocket
)(long
– 1הצלחה
( )-1כשלון
סגירת ה socket -
הדרכה לשימוש בפונקציות:
יש להגדיר את הפונקציות לפני הפנייה אליהם בראש התוכנית.
תחילה יש לפתוח את ה – socketע"י קריאה ל – .OpenSocket
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 98 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
.SendRecv- אח"כ ניתן לשלוח מספר שאילתאות ע"י קריאה ל
.CloseSocket ע"יsocket – בסוף העבודה יש לסגור את ה
. של מערכת אשראיתReadMe.doc וכו' ניתן למצא במסמךVC++,VB מסביבות שונותDLL הנחיות להפעלת
-ידי קריאה ל- שלו עלSocket פותחThread כאשר כלMulti Threding גם בסביבהDLL-ניתן להשתמש ב
.OpenSocket
.Visual Basic מתוךDLL-להלן דוגמת שימוש ב
Public Declare Function OpenSocket Lib "CallServ.dll" (ByVal tcpPort As String_ ,
ByVal tcpip_address As String) As Long
Public Declare Function CloseSocket Lib "CallServ.dll" (ByVal sock As Long) As Long
Public Declare Function SendRecv Lib "CallServ.dll" (ByVal buf As String, _
ByVal RecvBuf As String, ByVal sock As Long) As Long
Public Sub main)(
Dim res As Integer ,sock As Long , s As String * 200
sock = OpenSocket("7777", "194.194.194.25")
res = SendRecv("B4580270100804797T0504C00006400D011150I000J4X003777" , s, sock)
res = CloseSocket(sock(
End Sub
:הערה
.int32- יש להשתמש בlong בכל ההגדרות במקום.NET מתבצעת מסביבהCallServ.Dll-במידה וקריאה ל
s = Space(200)- וDim s As String - יש להחליף לDim s As String * 200 את המשפט
--------------------------------------------------------------------------------------------------------------------------------------------------07/13 V9.58
- 95 -
mefizim598.doc
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
14אשראית WEB
14.1כללי.
אשראית Webהינה גרסה חדשה של אשראית PCשפועלת בטכנולוגיה של Web Serviceומאפשרת
לבצע את כל הפעולות של אשראית ללא צורך בהתקנה כלשהיא של מרכיבי אשראית אצל הלקוח
או המפיץ.
המערכת מספקת מספר שירותים עיקריים:
קבלת פרטי העסקה ,בדיקתה (כולל יציאה לשאילתא מול חברת האשראי) והחזרת תשובה
(מקביל לפעילות של Intr95.exeאו .)Intr32.dll
קבלת שידור עסקאות מאושרות לצורך הפקדה לחברות האשראי (מקביל לפעילות של
.)trans95.exe
בשידור בודד ניתן להעביר עד 9999עסקאות ,אך מומלץ לא לעבור
את .0555
יש להימנע משידורים רבים במהלך יום אחד מכיוון שזה מקשה על
אפשרות של שיחזור מידע.
אפשרות לקבל מידע על הפקדות (שידורים) של עסקאות לחברות האשראי.
המערכת כתובה ב C#-בסביבת VisualStudio.NET 3552גרסת .Framework v1.1.4322
כתובת האתר היא:
https://www.shva-online.co.il/ash/abscheck/absrequest.asmx
כתובת של אתר טסט היא:
https://www.shva-online.co.il/ash/test/abscheck/absrequest.asmx
חשוב !
תנועות תועברנה לחברות האשראי לצורך חיוב /זיכוי אך ורק כאשר הן משודרות תחת מסוף ייצור ולא
תחת מסוף טסט( .מסוף שמספרו פחות ממיליון הינו מסוף טסט) ,זה לא תלוי בכתובת.
בכתובת השנייה בד"כ נמצאת גרסת תוכנה הכוללת שינויים אחרונים לפני שיוכנסו לשימוש כלל
הלקוחות.
שימו לב שקונפיגורציה של שרת שלנו דורשת השמת SOAPActionב content header -ולא ב-
.URL
יש להגדיר באפן מפורש ב“text/xml” content type -
להלן דוגמה עבור פונקציה ( ChangePasswordמספיק להיכנס לאחת מהכתובות לעיל ולעשות
קליק
על שם פונקציה רצויה):
POST /ash/abscheck/absrequest.asmx HTTP/1.1
Host: localhost
Content-Type: text/xml; charset=utf-8
Content-Length: length
"SOAPAction: "http://shva.co.il/xmlwebservices/ChangePassword
>?"<?xml version="1.0" encoding="utf-8
"<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance
"xmlns:xsd="http://www.w3.org/2001/XMLSchema
>"xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/
><soap:Body
>"<ChangePassword xmlns="http://shva.co.il/xmlwebservices/
><MerchantNumber>string</MerchantNumber
><UserName>string</UserName
><Password>string</Password
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 61 -
07/13 V9.58
מחלקת תוכנה
----------------------------------------------------------------------------------------------------------------------------------------------------><NewPassword>string</NewPassword
></ChangePassword
></soap:Body
></soap:Envelope
שימו לב במיוחד על XMLפונקציות שמחזירות חלק מהפרמטרים ( AuthCredCardFullלדוגמה)!
14.1אבטחת מידע.
שימוש בכתובת IPקבועה כאמצעי אבטחה למניעת חיבור לא רצוי
התקשורת בין שרת שב"א לבין משתמש הנה ( httpsהצפנת .) SSL
המשתמש נדרש לבצע רישום לשרות בו הוא מקבל משב"א שלושה נתונים לזיהוי :שם,
סיסמא ומספר מסוף.
oהסיסמא היא ראשונית ,והפעולה היחידה הניתנת בה היא החלפתה לסיסמא
אחרת.
oלאחר הפעולה הנ"ל ,הסיסמא נשמרת במסד נתונים של שב"א מוצפנת באופן
שאינו מאפשר פענוח אלא רק אימות.
oלכן במקרה שכיחה או אובדן הסיסמא על ידי משתמש יש לחזור על תהליך הרשום
לצורך מתן סיסמא ראשונית חדשה.
שרת העבודה שמכיל את מסד נתונים של המערכת אינו חשוף ל Internet-ומוגן על ידי
.Firewall
כל הנתונים הרגישים במסד נתונים מוצפנים.
14.2שרידות
המערכת תופעל על שרתי ,Clusterכך שנפילה של שרת אחת לא גורמת להפסקת השרות.
מסד הנתונים של המערכת מגובה ,On-Lineאחרי כל שינוי שמתרחש בו ,במחשב אחר.
אתר שב"א מחובר ל Internet-באמצעות יותר מ ISPאחד ,כך שנפילתו של ספק Internet
אחד לא תגרום להפסקת שרות.
שב"א משתמשת בשיטות שונות לזיהוי ומניעת מצבי .Denial Of Service
14.4פונקציות ה.Web Service -
AuthCreditCardFull 14.4.1
פונקציה שמשמשת לבדיקת עסקאות תשלום בכרטיסי האשראי.
הפונקציה מקבלת נתוני עסקה ומחזירה את תוצאות הבדיקה ורשומת העסקה במקרה של
תשובה חיובית.
רשומת העסקה צריכה להישמר אצל המשתמש עד להפקדתה על-ידי פונקציה
.DepositTransaction
להלן פרטי הפונקציה:
הגדרת הפונקציה ב.C#-
(public int AuthCreditCardFull
string MerchantNumber,
string UserName,
string Password,
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 61 -
07/13 V9.58
מחלקת תוכנה
----------------------------------------------------------------------------------------------------------------------------------------------------string TransactionDate_yyyyMMdd,
string TransactionTime_HHmm,
string UniqueTransactionNumber_SixDigits,
string Track2,
string CardNum,
string ExpDate_YYMM,
string Amount,
string CochavAmount,
string TransactionType,
string CreditTerms,
string Currency,
string AuthNum,
string Code,
string FirstAmount,
string NonFirstAmount,
string NumOfPayment,
string SapakMutav,
string SapakMutavNo,
string UniqNum,
string ClubCode,
string ParamJ,
string AddData,
string Eci,
string Cvv2,
string Id,
string CavvUcaf,
string Last4Digits,
string TransactionCurrency,
string TransactionAmount,
out string TransactionRecord,
out string ResultRecord)
נתוני הקלט
) ספרות מתקבל משב"א05( מספר מסוף- MerchantNumber
– מתקבל משב"אUserName
6 (להלן) מינימוםChangePassword – כפי שנקבע על ידי המשתמש בפונקציהPassword
.) תווים (אלפאנומרי ללא תווים מיוחדים35 מקסימום
."35505006" לדוגמה. – תאריך ביצוע עסקהTransactionDate_yyyyMMdd
."0101" לדוגמה. זמן ביצוע עסקהTransactionTime_HHmm
--------------------------------------------------------------------------------------------------------------------------------------------------07/13 V9.58
- 62 -
mefizim598.doc
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
- UniqueTransactionNumber_SixDigitsמספר בן שש ספרות ,אשר חייב להיות ייחודי
לפחות ברמה של תאריך ביצוע עסקה ( .)TransactionDate_yyyymmddמספר זה ותאריך העסקה
משמשים לבירורים מול שב"א ומול חברות האשראי.
הערה :המשתמש יכול לשלוח פרמטר זה ריק ("") ואז המספר הייחודי יינתן אוטומטי
ויוחזר למשתמש בתוך , ResultRecordבשדות מס' קופה 2ראשונות ,ומס' סודר 2
אחרונות.
– Track2פס מגנטי של כרטיס האשראי או ריק ("") במקרה של עסקה טלפונית.
– CardNumמספר כרטיס או ריק ("") במקרה של עסקה עם פס מגנטי.
- ExpDate_YYMMתאריך תוקף של הכרטיס לדוגמה " "5003דצמבר .3550
– Amountסכום עסקה באגורות ללא נקודה עשרונית לדוגמה 20 ₪ 032 = 03220אג'.
- CochavAmountסכום הנחה שתמורתה לקוח יחויב בכוכבים/נקודות או ריק ("").
- TransactionTypeסוג עסקה .להלן סוגי עסקאות האפשריים:
" - "50עסקת חובה
" – "00עסקת זכות
- CreditTermsסוגי אשראי .להלן סוגי אשראי האפשריים:
" - "0אשראי רגיל
" - "3ישראקרדיט ,אמקס' קרדיט,ויזה עדיף ,25+ /דיינרס
עדיף. 25+ /
" - "2חיוב מיידי
" - "2אשראי מועדון
" - "0סופר קרדיט
" - "6קרדיט/קרדיט בתשלומים קבועים.
" - "1תשלומים
" - "9עסקת מועדון בתשלומים.
- Currency
סוגי מטבע.
" - " 5מטבע מיוחד
" - " 0ש "ח
" - "3דולר
" - "2עסקת תשלומים צמודה ל ( $ -עסקה בש"ח התשלומים
צמודים ל.)$ -
" - "1עסקת תשלומים צמודה למדד
- AuthNumמספר אישור אשר הוסג מראש או ריק ("") אם לא קיים .עד 0תווים
אלפאנומריים.
- Codeקוד עסקה .להלן קודים אפשריים:
" - "55עסקה רגילה
" - "50שרות עצמי
" - "53שרות עצמי בתחנות דלק
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 63 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
" - "05עסקה טלפונית
" - "00עסקת חתימה בלבד
הערה :מנקודה זו והלאה כל הפרמטרים הם רשות .במידה ואינם נחוצים ,מועברים כריקים
("").
- FirstAmountסכום התשלום הראשון (ראה הערה .)0
- NonFirstAmountסכום התשלום הקבוע (ראה הערה .)0
- NumOfPaymentמספר תשלומים (ראה הערה .)0
– SapakMutavאינדיקטור עבודה ברב ספק( .ראה הערה )3
" – "5עבור מסוף רגיל.
" – "0עבור רב ספק.
" – "3עבור רב מוטב.
– SapakMutavNoבמקרה שמשתמשים בתצורה של רב ספק ,מזינים בשדה זה את מספר
המסוף המרכזי (7ספרות בלבד)שנקבע לרב ספק .במקרה שמשתמשים בתצורה
של רב מוטב ,מזינים בשדה זה את מספר הספק של המוטב שעבורו נעשית עסקה.
- UniqNumנתון שמכניס משתמש לפי שיקול דעתו .עד 09תווים אלפאנומריים הנתון נרשם
ב( ResultRecord -בשדה שנקרא נתוני משתמש) אך לא מועבר לחברת האשראי.
- ClubCodeקוד מועדון לאשראי מועדון (קודים אפשריים שונים עבור חברות אשראי שונות):
ישראכרט ואמריקן-אקספרס :מ "0"-עד ""6
כ.א.ל ודיינרס :מ "0"-עד "."9
לאומיקארד :מ "0"-עד ""6
- ParamJאופן הפעלה :
“"1
ההוראה למסוף היא לא לצאת לשאילתא.
אם אין צורך בשאילתא הכרטיס נבדק ברמת ה ,WS -והיה והכרטיס נמצא
תקין ,נוצר חיוב) . TransactionRecordאם יש צורך לצאת לשאילתא במקרים
של מעל תקרה וכו' ,נוצר רק .ResultRecord
“"2
בדיקה בלבד של נתוני העסקה.
הבדיקה מתבצעת ברמת ה WS -ללא אפשרות יציאה לשאילתא .נוצר רק
.ResultRecord
הערה :כאשר הפרמטר הינו J1או J2וישנה סיבה להתקשרות אזי במקום להתקשר
מציינת התוכנית את סיבת ההתקשרות (ראה קוד סטטוס 520 - 520המפורטים
בנספח , 0שהם סטטוסי התראה ולא שגיאה) ולכן בהפעלה עם J2אין צורך
להתייחס אליהם כאל סיבה לפסול עסקה .
""3
בדיקה בלבד של נתוני העסקה +החזרת סכום.
כמו 3Jובנוסף מחזיר בשדה "סכום" את סכום התקרה נטו (סכום התקרה
פחות סכום העסקה הנוכחית)
“ "4או "" 5
מתבצעת שאילתא באופן אוטומטי בהתאם לדרישות המסוף.
תחילה מתבצעת בדיקה ברמת ה – , WSבמידה והבדיקה עברה בהצלחה
ויש צורך בבקשה לאישור לדוגמא :בגלל סכום חריג או על-פי ההגדרות של
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 64 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
מסוף ,מתבצעת בקשה כזאת מול חברת האשראי המתאימה.
במידה ומתקבל אישור נוצר חיוב ()TransactionRecord
""5
בקשה לאישור ללא עסקה.
אופציה זו נועדה לעסקים כגון :חברות להשכרת רכב ,בתי מלון וכד' .בשלב
הראשון מבצעים שאילתא לצורך בדיקת תקפות הכרטיס והעסקה מול
חברת האשראי וקבלת מס' אישור .העסקה תבוצע בשלב מאוחר יותר
כאשר יודעים סכום העסקה המדויק .גם במקרים שהתשובה לבקשה הינה
חיובית ,לא נוצר חיוב ()TransactionRecord
הערה :נדרשת הרשאה של חברות האשראי לביצוע בקשה לאישור ללא
עסקה.
""6
בקשה לאישור ביוזמת הקמעונאי.
זאת אופציה נוספת שבה המשתמש יכול ליזום התקשרות לחברות האשראי
לצורך קבלת מס' אישור .נוצר חיוב ()TransactionRecord
- AddDataנתונים נוספים -נתונים אלו יירשמו לקובץ התנועות ויועברו לחברות האשראי.
שימוש בשדה זה מותנה בפרמטר מתאים במסוף.
שדה זה נומרי עד שמונה תווים ,לדוגמה ""03220601
שימוש אפשרי הוא העברת אסמכתא לצורך התאמות מול חברות האשראי.
– ECIשדה לקליטת נתוני האימות של מחזיק הכרטיס (שמנוי לשירות עסקה בטוחה)
ולהעבירו לחברת האשראי בשאילתא .אורך שדה – בית אחד לדוגמה "."0
להלן ערכים אפשריים של .ECI
תיאור
רמת אבטחה
9
עסקה מאובטחת בשיטת SETאו 3D-Secureברמת בית העסק ומחזיק
הכרטיס.
6
עסקה בה נעשה שימוש באבטחת מידע ( ,)SSLבית העסק תומך ב SET
אבל העסקה אינה מאובטחת באחד מהפרוטוקולים של ויזה SETאו
3D-Secureבאופן מלא.
7
עסקה בה נעשה שימוש באבטחת מידע ( )SSLאך לא בשיטת 3D Secure
או SET
8
עסקת אינטרנט שאינה מאובטחת כלל.
5
עסקה שאינה מאובטחת בעוד שלבית העסק קיימת אפשרות לתמוך ב
.SET
2 - Cvv2או 2ספרות ימניות אחרונות שכתובות בצידו האחורי של הכרטיס.
החובה לספק שדה זה מותנית בפרמטר מתאים במסוף( .ראה הערה )2
- Idמספר תעודת הזהות .עד 9ספרות לדוגמה "(."032206019ראה הערה )2
- CavvUcafשדה לקליטת נתוני האימות של מחזיק הכרטיס (שמנוי לשירות עסקה בטוחה)
ולהעבירו לחברת האשראי בשאילתא.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 69 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
- Last4Digitsארבע ספרות האחרונות של מספר הכרטיס כפי שהן מובלטות על-גבי
הכרטיס .החובה לספק שדה זה מותנית בפרמטר מתאים במסוף.
- TransactionCurrencyסוג מטבע - ISOעד 2ספרות עבור מטבע( .סוגי מטבע אשר
נמצאים בטבלת .) ISO
שים לב :רק כאשר החברה הסולקת היא ויזה כ.א.ל או דיינרס אזי ערך פרמטר
חייב להיות " = "3דולר שאתו תיעשה הבקשה לאישור .בעסקה לעומת זאת ירשם מטבע
של ISOעם סכום אשר מוגדר ב.TransactionAmount-
Currency
– TransactionAmountסכום עסקה במטבע .ISOשמונה ספרות ללא נקודה.
TransactionCurrencyו TransactionAmount -מופיעים רק אם רוצים לעשות עסקה בסוג מטבע
שונה משקל ודולר וזאת אך ורק לפי הסכם עם חברות האשראי.
נתוני פלט
– TransactionRecordנתוני עסקה מוצפנים להפקדה .מוחזר במקרה של עסקה תקינה
ופרמטר ParamJהינו "" או " "5או " "0או " "2או " ."6הגודל המקסימלי של
TransactionRercordהינו עד , byte 255
במקרים האחרים מוחזר ריק ("").
- ResultRecordתוצאות בדיקה .ערך בו מוחזר תמיד.
המבנה (אשר זהה למבנה הידוע למשתמשי אשראית כמבנה של )Int_Otמפורט בסעיף
36.0בהמשך הפרק.
Return Code
מסוג , Integerשערכו מהווה את הסטטוס בדיקה (ראה נספח .)0
הערות:
(.)0
סכומי תשלום ראשון וקבוע מופיעים רק בעסקת תשלומים (סוג אשראי =
1או .) 9
הסכומים באגורות .אין לרשום נקודה עשרונית.
השדה "מספר תשלומים" מופיע בעסקאות תשלומים (סוגי
אשראי 1או 9ומכיל מספר תשלומים קבועים) ,ובאשראי מיוחד
(סוגי אשראי = 0או 6ומכיל מספר תשלומים כולל).
לעסקה בתשלומים צריך להתקיים התנאי הבא :סכום עסקה
שווה לתשלום ראשון ועוד תשלום קבוע כפול מספר תשלומים,
למשל ₪ 055ב 2-תשלומים:
סכום עסקה ₪ 055( 05555 :באגורות)
תשלום ראשון)₪ 22.22( 2222 :
תשלום קבוע )₪ 22.22( 2222 :
מספר תשלומים – )!!( 3 :מדובר בתשלומים קבועים בלבד !!.
(.)3
רב ספק/רב מוטב.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 66 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
א.
שימוש באופציה דורש הסכם מיוחד עם חברות האשראי.
ב.
חובה להשתמש בפרמטר במידה ולבית העסק
קיים יותר ממספר ספק אחד באותה חברת
אשראי(.מצב של רב ספק)
ג.
במידה ובית העסק יתחשבן עם כל אחד מספקיו
בכוחות עצמו יש להשתמש במצב של רב מוטב.
(.)2
דרישה להקלדת CVV2ו/או תעודת הזהות.
בדיקת CVV3ו/או נתוני תעודת זהות בעסקאות טלפוניות ועסקאות בהן
הלקוח לא נוכח.
הבדיקה תבוצע לכל סוגי הכרטיסים (כולל אמקס ,דיינרס ו ) PLעל פי
דרישה של חברת אשראי
(כפוף לפרמטר מתאים במסוף) .הבדיקה מהווה נידבך נוסף
לאמצעי הביטחון ,והאבטחה שמבצע העסקה אכן מחזיק בידיו
את הכרטיס.
אשראית מחזירה קוד תשובה ב .ResultRecord-על סמך קוד
תשובה זה ,ובהתייחס לפרוט קוד תשובת חברת האשראי –
ת"ז ,CVV3-יחליט המסוף האם להנחות את המשתמש להקליד
את הפרטים בשנית.
יתכן מצב ש CVV3 -לא קריא או לא מודפס על הכרטיס ,ולכן
מאפשרים לבית העסק להזין ערך מיוחד במקום הערך של ה
CVV2כמפורט להלן:
– 5בית העסק בחר לא להקליד .CVV3
CVV3 – 3לא קריא.
CVV3 – 9לא קיים על הכרטיס.
AuthCreditCardGas 14.4.1
פונקציה שמשמשת לבדיקת עסקאות דלק בתשלום בכרטיסי האשראי.
הפונקציה מקבלת נתוני עסקה ומחזירה את תוצאות הבדיקה ורשומת העסקה במקרה של
תשובה חיובית.
רשומת העסקה צריכה להישמר אצל המשתמש עד להפקדתה על-ידי פונקציה
.DepositTransaction
להלן פרטי הפונקציה:
הגדרת הפונקציה ב.C#-
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 67 -
07/13 V9.58
מחלקת תוכנה
----------------------------------------------------------------------------------------------------------------------------------------------------public int AuthCreditCardGas(
string MerchantNumber,
string UserName,
string Password,
string TransactionDate_yyyyMMdd,
string TransactionTime_HHmm,
string UniqueTransactionNumber_SixDigits,
string Track2,
string CardNum,
string ExpDate_YYMM,
string Amount,
string CochavAmount,
string TransactionType,
string CreditTerms,
string Currency,
string AuthNum,
string Code,
string GasolinType,
string GasolinLiter,
string OilLiter,
string OilAmount,
string Speedometer,
string CarNo,
string UniqNum,
string ClubCode,
string ParamJ,
string AddData,
string Eci,
string Cvv2,
string Id,
string CavvUcaf,
string Last4Digits,
out string TransactionRecord,
out string ResultRecord)
: למעט השדות הבאיםAuthCreditCardFull נתוני קלט זהים לנתוני הקלט בפונקציה
GasolinType, GasolinLiter, OilLiter, OilAmount, Speedometer, CarNo,
: המחליפים את השדות
NonFirstAmount, NumOfPayment, SapakMutav, SapakMutavNo, FirstAmount,
--------------------------------------------------------------------------------------------------------------------------------------------------07/13 V9.58
- 68 -
mefizim598.doc
מחלקת תוכנה
----------------------------------------------------------------------------------------------------------------------------------------------------GasolinType
קוד דלק ,להלן סוגי הדלק האפשריים:
– 0אוקטן 90
– 3אוקטן 93
– 2אוקטן – 90נטול עופרת
– 2סולר
– 0אופנועים
– 6בנזין צבאי
– 0סולר צבאי
– 1נפט
– 9סוגי דלק אחרים
– 05אוקטן – 90נטול עופרת
– 00אוקטו 91
– 03אוקטן – 91נטול עופרת
– 02סולר דל גופרית
– 26גז פחמימי
– GasolinLiterכמות דלק במאיות ליטרים
– OilLiterכמות שמן במאיות ליטרים
– OilAmountשמן (סכום)
– Speedometerמד מרחק > 5
– CarNoמספר רכב > 5
DepositTransactions 14.4.2
הפונקציה משמשת להפקדת עסקאות בחברות האשראי לצורך חיוב מחזיקי כרטיס וזיכוי של בית
העסק (קבלת אישור על העסקה אינו מהווה את החיוב אלה רק אישור לביצועו).
הגדרת הפונקציה ב.C#-
( public int DepositTransactions
string MerchantNumber,
string UserName,
string Password,
)string[] TransArr
נתוני קלט.
- Password , UserName ,MerchantNumberכמו בפונקציה
AuthCreditCardFull
– TransArrמערך שורות שהוא למעשה אוסף של TransactionRecordsשהוחזרו מפונקציה
AuthCreditCardFullואוכסנו על-ידי משתמש עד להפקדה.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 65 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
בהפקדה בודדת ניתן להעביר עד 9999עסקאות ,אך מומלץ לא
לעבור את ה 0555 -עסקאות.
יש להימנע מתצורת עבודה של שידור /הפקדה של כל עסקה .צריך לצבור את רשומת
העסקאות ולבצע שידור של כל העסקאות בהפקדה אחת או שתיים לפי הצורך ,מכיוון
שזה מקשה מאוד על אפשרות של שיחזור מידע.
Return Code
מסוג Integerאשר ערכו:
– 5תקין
– 305בעיה בזיהוי
אחרת – תקלה בהפקדה – יש לפנות לשב"א.
DepositTransactionsEx 14.4.4
הפונקציה מורחבת לפונקציה .DepositTransactions
לפונקציה זו התווספו עוד 2פרמטרים המשמשים להחזרת מידע למשתמש אודות ההפקדה
שבוצעה .
הגדרת הפונקציה ב.C#-
( public int DepositTransactionsEx
string MerchantNumber,
string UserName,
string Password,
string[] TransArr,
out int ReferenceNumber,
out int TotalDebit,
out int TotalCredit,
)out int TotalNumber
נתוני פלט.
– ReferenceNumberמספר אסמכתא עבור ההפקדה.
- TotalDebitסה"כ סכום עסקאות חובה בהפקדה.
- TotalCreditסה"כ סכום עסקאות זכות בהפקדה.
- TotalNumberסה"כ מספר עסקאות בהפקדה (גם חובה וגם זכות).
GetDepositInformation 14.4.4
הפונקציה משמשת להחזרת מידע למשתמש על הפקדות שבוצעו.
הגדרת הפונקציה ב.C#-
(public int GetDepositInformation
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 71 -
07/13 V9.58
מחלקת תוכנה
----------------------------------------------------------------------------------------------------------------------------------------------------string MerchantNumber,
string UserName,
string Password,
string TransmitDate_yyyyMMdd,
ref int SequenceNumberOfDepositForDate,
out int ReferenceNumber,
out int TotalDebit,
out int TotalCredit,
)out int TotalNumber
נתוני קלט.
- Password , UserName ,MerchantNumberכמו בפונקציה
AuthCreditCardFull
– TransmitDate_yyyymmddתאריך הפקדה ,לדוגמה 6 - 35500056לנובמבר .3550
נתוני קלט/פלט
SequenceNumberOfDepositForDateאם הפרמטר מכיל ,5אזי מתקבל מידע על הפקדה
האחרונה של אותו יום .לאחר הקריאה לפונקציה ,הפרמטר מכיל ערך שמציג את מספר
ההפקדות שנעשו באותו יום (שהרי פונקציה DepositTransactionיכולה להיות מופעלת יותר
מפעם ביום).
אם המשתמש טען ערך אחר בפרמטר אזי יוצג המידע עבור מספר ההפקדה המבוקש
באותו יום.
נתוני פלט.
– ReferenceNumberמספר אסמכתא עבור הפקדה ספציפית.
- TotalDebitסה"כ סכום עסקאות חובה בהפקדה ספציפית.
- TotalCreditסה"כ סכום עסקאות זכות בהפקדה ספציפית.
- TotalNumberסה"כ מספר עסקאות בהפקדה (גם חובה וגם זכות).
ReturnCode
מסוג Integer
עם הערכים האפשריים.:
– 5תקין.
– 305בעיה בזיהוי.
– 300לא נמצא מידע נדרש.
אחרת – לפנות לשב"א
ChangePassword 14.4.6
הפונקציה משמשת להחלפת הסיסמה הראשונית שהוקצתה למשתמש על ידי שב"א .לא ניתן
לבצע פעולות במערכת עם הסיסמה הזמנית פרט לפעולת החלפת הסיסמה לצורך קביעת
סיסמת עבודה הידוע רק לו.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 71 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
על הסיסמה להיות בת מינימום 6מקסימום 35תווים (אלפאנומרי ללא תווים מיוחדים) ושונה
מהישנה.
הגדרת הפונקציה ב.C#-
public int ChangePassword(string MerchantNumber,
string UserName,
string Password,
)string NewPassword
נתוני קלט.
- Password , UserName ,MerchantNumberכמו בפונקציה
AuthCreditCardFull
– NewPasswordסיסמא החדשה שנקבע על-ידי משתמש.
ReturnCode
מסוג Integer
עם הערכים האפשריים.:
– 5תקין.
– 305בעיה בזיהוי או סיסמא חדשה בניגוד לכללים.
אחרת – לפנות לשב"א
14.4מבנה של Int_Ot
שם השדה
תווים
מקום
יחסי
הערות
סטטוס
2
0
ראה נספח - 0קודי סטטוס
הוראות תצוגה
לכרטיס נטען
0
2
כיום בכרטיסי טעינה השדה יכול להכיל את הערכים הבאים:
מספר כרטיס
09
0
אפסים מובילים.
מותג
0
32
– 5כרטיס פרטי של חברה מנפיקה () PL
סולק
0
30
– 5אין דרישה (ברירת מחדל).
– 0נדרש להקרין ולהדפיס המסר בפתקית בש"ח.
– 3נדרשת הקרנת המסר בלבד בש"ח.
– 2נדרש להדפיס את המסר רק בפתקית בש"ח.
– 2נדרש להדפיס בפתקית ולהקרין במסך מטבע דולר.
– 0נדרש להדפיס בפתקית ולהקרין במסך מטבע יורו.
– 0מסטרכרד
– 3ויזה
– 2מאסטרו
מספר חברה הסולקת את העסקה.
– 0ישראכרט – 3,ויזה כ.א.ל – 2,דיינרס – 2 ,אמריקן אקספרס6 ,
– לאומיקארד
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 72 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
תווים
שם השדה
מקום
יחסי
הערות
קוד שרות
2
36
J
0
39
תאריך תוקף
2
25
()MMYY
תשובת חב'
האשראי – ת"ז
0
22
הערות – 5 :לא הוכנס
0
20
פרמטר
תשובת חב'
האשראי –
– 0הוכנס ותקין
– 3לא תקין
– 2לא נבדק
כנ"ל
CVV
סכום באגורות
1
26
מידע נוסף
1
22
סכום בכוכבים
1
03
קוד חב' אשראי
(חב' מנפיקה)
0
65
סוג עסקה
3
60
סוג אשראי
0
62
0
62
סוג מטבע
0
60
קוד עסקה
3
66
העברת מידע נוסף ע"י חברת האשראי בתוך תשובה לשאילתא.
לדוגמא :יתרת האשראי של מחזיק הכרטיס .השדה הנו אלפא נומרי.
(ראה טופס פתקית ללקוח)
כיום רלוונטי בכרטיסי טעינה/מתנה.
– 0ישראכרט
– 3ויזה כ.א.ל
– 2דיינרס
– 2אמריקן אקספרס
0
– JCB
– 6לאומיקארד
– 55כרטיס חסום
– 50עסקת חובה רגילה
– 53עסקת חובה מאושרת
– 52עסקה מאולצת
– 00עסקת זכות
– 03עסקת ביטול
– 02עסקת זכות מאושרת
UCAF/CAVV
תוצאת בדיקה של ערך UCAF/CAVVבמהלך ביצוע בקשה לאישור.
ראה נספח 3
קוד מועדון
0
61
כפי שנקבע בין חברות האשראי ורשתות השיווק.
סיבת
התקשרות
0
69
"רווח" – לא בוצעה התקשרות
- 0אקראי
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 73 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
שם השדה
תווים
מקום
יחסי
הערות
- 3תקרה
- 2מספר סודי
- 2קוד שרות בפס מגנטי
- 0בקשה לאישור ללא עסקה
- 6חסום לא חד משמעי
( Z.F.L - 0תקרת ) 5
- 1בקשה לאישור יזומה
- 0אושר ע"י שב"א
מקור האישור
0
05
מספר אישור
0
00
סכום תשלום
ראשון
1
01
סכום תשלום
קבוע
1
16
מספר
תשלומים
3
92
מספר קובץ
3
96
מספר קופה
2
91
550-999
מספר סודר
בקופה
2
050
550-999
שם הכרטיס
00
052
ציון לכרטיס
חו"ל
0
009
נתוני משתמש
09
035
- 3אושר ע"י חברת האשראי
- 2אושר ע"י המענה הקולי
- 5עסקה ללא אישור
– 5כרטיס ישראלי – 0כרטיס חו"ל – 3כרטיס דלק
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 74 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
14.6קודי שגיאה המוחזרים על-ידי אשראית .WEB
בנוסף לקודי השגיאה הרגילים (ראה נספח )0שיכולים להתקבל להלן קודי השגיאה המיוחדים עבור
:Web Service
– 305בעיית זיהוי (שם משתמש ,סיסמא ,מספר מסוף לא תקינים).
– 300תקלה כללית – לפנות לשב"א
– 306מספר עסקה ( – )TransactionNumberאינו ייחודי עבור תאריך עסקה (.) TransactionDate
– 300לא נמצא מידע נדרש.
– 365אחד או יותר מפרמטרים המועברים לפונקציה לא תקין (בד"כ ערכים לא נומריים איפה שצריך
נומרי).
– 315בד"כ ,time-outדהיינו לקח יותר מדקה לחזור למשתמש .במידה וחוזר לעצמו יש לפנות לשב"א.
– 391נסיון לעבוד עם מסוף ייצור דרך אתר טסט.
כל הקודים אחרים מחייבים פניה לשב"א.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 79 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
16מערכת אשראית -התקשרות
התקשורת במערכת מיועדת לשלוש מטרות:
הקמת מסוף חדש.
1.
קבלת אישור של חברת האשראי לעסקאות ע"פ מאפייני המסוף וסכום העסקה או עפ”י
.2
רצון הקמעונאי.
קבלת פרמטרים ,שידור קובץ העסקאות לחברת שב"א וקבלת קובץ חסומים ,קבלת עדכון תוכנה.
.3
כל שלב מבוצע רק במידת הצורך .לדוגמא :באם לא חל שינוי בפרמטרים של המסוף תוכנית התקשורת לא
מבצעת את השלב.
התקשורת מתבצעת ע"י מודם המחובר למחשב אישי בקו טלפון רגיל או בקו נ.ל.נ .או ב. TCP-IP -
החל מגירסה 4.76ישנה אפשרות להתחברות דרך האינטרנט .זה כרוך בשימוש במוצר נוסף ששמו
. STUNNEL
תפקידו להזדהות מול שרת שב"א ,להעביר מסרים מכתובת הנ"ל לקוח לכתובת של שרת
STUNNELוה-
שב"א באינטרנט כאשר הם מוצפנים ב . SSL -לצורך קבלת
CERTIFICATEאשר משמש לצורך זיהוי ייחודי של לקוח באינטרנט ,יש לפנות לשב"א.
לשם כך נוספה אופציה חדשה בחלון "עידכון פרמטרים"" -פרמטרים נוספים"-
"תקשורת באמצעות "INTERNETבמידה ואופציה מוגדרת ,אזי גם אופציה "תקשורת
באמצעות " TCPIPפעילה והכתובת שיש להגדיר בה היא 117.4.4.1פורט . 444
החל מגירסה 4.77נוספה האפשרות להגדיר קו גיבוי כקו .TCPIP
הקמת מסוף מתבצעת ע"י תוכנית ASHעם הפרמטר / INITאשר מפעילה את תוכנית ,TRANSMITאך לפני כן
מוחקת את כל קבצי הנתונים של המערכת (אופציונלי).
תקשורת לקבלת אישור מופעלת ע"י תוכנית INTRFACEאשר בודקת נתוני עסקה ומבקשת אישור מחברת
אשראי במידה ויש צורך.
תקשורת להעברת עסקאות וקבלת חסומים ופרמטרים מופעלת ע"י תוכנית .TRANSMIT
כל התוכניות הנ"ל הינן תוכניות DOSעם סיומת EXEוניתן להפעיל אותן מ COMMAND LINE -או מאפליקציית
המשתמש.
בנוסף לכך תוכנית TRANSMITמופעלת מתפריט ראשי של מערכת אשראית (תוכנית ASHבאופציות "שידור"
ו"-שידור באמצעות טלפון חד פעמי") .כמו כן יכולה תוכנית TRANSMITלהיות מופעלת ,אוטומטית ,בזמן
מסוים שהינו אחד מהפרמטרים במסוף( ,בתנאי שהמסך מקרין תפריט ראשי -ע"י תוכנית ASHללא
פרמטרים).
התקשורת מבוססת על מספר פרמטרים ,כגון:
ערוץ ( ,) PORTמהירות ,מספר טלפון להקמה ,סוג מודם ,כתובת בזיכרון ו.IRQ -
הפרמטרים הנ"ל ניתנים להצגה ותיקון ע"י תוכנית ( BUILDתפריט ראשי ,אופציה "עדכון נתוני מסוף") ,או
בזמן הקמת מסוף.
חשוב!!!
החל מגירסה 9.74אין צורך בהפעלת תוכנית TRANMAXכדי לחלק קובץ TRANשמכיל יותר מ11,111 -
רשומות .תוכנית השידור TRANSMITאו TRANS95מבצעת את חלוקת הקובץ במידת הצורך ומשדרת את
הקבצים באופן אוטומטי אחד אחרי השני.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 76 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
16.1להלן הסבר לגבי כל אחד מהפרמטרים:
ערוץ:
קובע כתובת בזיכרון של המחשב אשר משמש לקבלת מידע מהמודם ,ו( IRQ-הודעה מהמודם על קבלת
מידע).
להלן טבלת הגדרות סטנדרטיות לערוצים
COM1 - COM4
ערוץ
COM1
COM2
COM3
COM4
כתובת
3F8
2F8
3E8
2E8
IRQ
4
3
4
3
במידה ואף הגדרה אינה מתאימה למודם (לדוגמא ,) 9 = IRQיש להגדיר ערוץ COM0ולהכניס בפרמטרים
"כתובת" ו IRQ -ערכים מתאימים.
כאשר הגדרת הערוץ הינה בתחום , COM1 - COM4פרמטרים "כתובת" ו IRQ -מוגדרים אוטומטית ע"י
התוכנית.
מהירות:
מגדירה את מהירות העברת הנתונים מהמסוף למודם (ובכיוון ההפוך).
מהירות העברת המידע בין שני המודמים (מודם המשתמש והמודם של חברת שב"א) נקבעת ע"י הגדרות
המודמים עצמם.
במידה ומהירות המודם הינה 14,411ניתן להגדיר מהירות 5611או יותר.
במידה ולמסוף יש מודם במהירות 1211הוא יעבוד מול מודם בעל מהירות של 2411בשב"א.
סוג מודם:
ניתן לבחור את סוג המודם מתוך מבחר הסוגים שהמערכת מכירה ,כאשר לכל סוג יש קובץ עם אותו שם ,אשר
מכיל פקודות אתחול מתאימות.
במידה ואין קובץ מתאים למודם של המסוף ניתן להקים קובץ ” “MODEMוזאת ע"י שימוש באופציה "כלים
לעזרה -עריכת קובץ מודם".
במידה והמודם אינו דורש אתחול (מודמים מהירים כעיקרון אינם דורשים פקודות אתחול) .יש
א.
להגדיר קובץ " "MODEMריק.
ב.
במידה והמודם דורש אתחול מיוחד ניתן להכניס אותו לקובץ MODEMע”י מעבד תמלילים או
מתפריט ראשי (אופציה "כלים לעזרה -עריכת קובץ מודם”).
מספר טלפון להקמה:
מספר טלפון אליו מחייג המודם בעת הקמת המסוף.
לאחר שהמסוף הוקם ,תוכנית התקשורת משתמשת במספרי הטלפון מקובץ פרמטרים אשר שודרו למסוף
מהמחשב המרכזי .באם משתמשים באופציה "שידור באמצעות טלפון חד פעמי" ,אזי מוכנס לקובץ
הפרמטרים מספר הטלפון שהוקלד הנשאר שם עד התקשורת המוצלחת הבאה.
כתובת בזיכרון ו: IRQ -
ראה "ערוץ" לעיל.
16.1כיצד מזהים באם התקשורת הסתיימה בהצלחה?
לאחר כל ניסיון התקשרות ,תוכנית TRANSMITמקרינה ו/או מדפיסה דו"ח תקשורת .זאת (במידה והאפשרות
לא בוטלה ע"י ציון האופציה ב" -עדכון נתוני מסוף" " -להקרין/להדפיס סיכום שידור אחרון").
דו"ח תקשורת במקרה של הצלחה מכיל שורה ,דור חסומים . XXXX -
במידה ושודרו תנועות דו"ח התקשורת יכיל גם מס' אסמכתא ופירוט סכומים.
וקובץ TRANיגובה בשם TRANB002 , TRANB001 :וכו'.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 77 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
תוכנית TRANSMITמחזירה 1 RETURN CODEבמקרה של תקשורת מוצלחת.
במקרה של ניתוק יוחזרו הערכים:
.1לא הצליח להתחבר
.2ניתוק בפרמטרים
.3ניתוק בתנועות
.4ניתוק בחסומים
.9ניתוק בעדכון תוכנה
את התשובה שהתוכנית TRANSMITמחזירה ניתן לראות גם בקובץ DATAבשדה קוד סיום שידור פוזיציה 27
כיצד מזהים באם התקשורת הסתיימה?
בתחילת הפעלת תוכנית TRANSMITהמערכת יוצרת קובץ בשם TRANLOCKובסיום התקשורת
(מוצלחת או לא מוצלחת) המערכת מוחקת אותו ,ולכן העדר קובץ TRANLOCKמעידה על סיום
התקשורת.
16.2בדיקת תוצאות שידור
תוכנית TRANSMIT.EXEאשר מבצעת תקשורת לשב"א לצורך העברת תנועות לחברות האשראי ,מחזירה 1
RETURN CODEבמידה והתקשורת הסתיימה בהצלחה.
ניתן לבדוק את הקוד שהתקבל ,זאת ע"י פקודה IF ERRORLEVELשל DOSבמידה והפעלת תוכנית
TRANSMIT.EXEמתבצעת מ.BATCH FILE -
דוגמא של BATCH FILEאשר מפעיל TRANSMIT.EXEעד ל 8 -פעמים:
TRANSMIT.EXE
IF NOT ERRORLEVEL 1 GOTO SUCCESS
TRANSMIT.EXE
IF NOT ERRORLEVEL 1 GOTO SUCCESS
TRANSMIT.EXE
: SUCCESS
במידה והפעלת תוכנית TRANSMIT.EXEמתבצעת מתוכנית המשתמש ,יש לבדוק את הקוד ע”י פקודות שפת
תכנות של אותה תוכנית.
16.4
תקלות בתקשורת.
להלן פירוט מקרי תקלות אופיינים:
תוכנית TRANSMITמסיימת את עבודתה מיד לאחר שהתחילה ,ללא ניסיון חיוג וללא שום הודעה או עם
הודעה . NULL POINTER ASSIGMENT
א.
קובץ STARTאינו קיים.
קובץ - STARTהינו קובץ אשר מכיל מספר מסוף ופרמטרים של התקשרות .במידה ואינו קיים אזי
יש ליצור אותו ע"י אופציה "עדכון נתוני מסוף"( .הקלד מספר מסוף ואת הנתונים הנוספים במסך).
ב.
קיים קובץ בשם TRANPTRאשר מכיל מסלול גישה לקבצי המערכת.
כעקרון יש צורך במסלול זה בסביבת עבודה כרב ספק.
וודא כי המסלול נכון.
במידה והקובץ מיותר או אינו מכיל שום נתון -בטל אותו.
הערה:
אם הינך בטוח שכל ההגדרות שלך נכונות ,יש לכבות ולהדליק את המחשב (במידה והמודם פנימי) וכן
ואת המחשב ואת המודם (במידה והמודם חיצוני) ,נסה להתקשר שנית.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 78 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
מתקבלת הודעה "מודם סגור" :
א.
מודם חיצוני אינו דלוק ,או לא מחובר למחשב.
בדוק האם דלוקות נורות על המודם החיצוני ואת החיבורים.
במידה והמודם מחובר דרך מתג בדוק באם המתג במצב הנכון.
ב.
הגדרת ערוץ אינה נכונה .כיום כל מודם פנימי נמכר עם תוכנית אשר בודקת לאיזה PORTהוא מחובר.
מודם חיצוני כעיקרון יכול להיות מחובר רק ל COM1 -או .COM2
ג.
מודם נמצא במצב "שתיקה" ואינו עונה לפקודות האתחול ,למרות זאת הוא מוכן לעבודה ,או IRQלא
נכון .הגדר באופציית "סוג מודם" "MODEM” -כאשר קובץ MODEMאינו קיים או לא מכיל פקודות
אתחול.
במקרה זה התוכנית מנסה לחייג ללא המתנה לתשובה מהמודם .שה IRQ -לא נכון (ראה גם בדף
הבא).
ד.
במידה והמהירות שמוגדרת היא 14,411או 28,811שנה ל 15,211 -ונסה שנית.
מתקבלת הודעה "טלפון אינו מחובר":
בדוק את חיבור המודם לקו הטלפון ואת תקינות הקו עצמו.
לצורך זה יש לחבר מכשיר טלפון לשקע הטלפון (בדיקת קו) או ליציאה "PHONE” -של המודם
(בדיקת קו וחיבור מודם).
כמו כן יש לבדוק אם יש שותף לקו הטלפון של המודם.
לא שומעים צליל חיוג למרות שעל המסך מופיעה הודעה :מתקשר לשב"א:
ישנם מודמים אשר אינם משמיעים צליל חיוג .במקרה זה יש להמתין 31-41שניות.
במידה ומופיעה על המסך הודעה "זיהוי" ההתחברות התבצעה.
אם עברו 91שניות והודעת "זיהוי" לא מופיעה הקש “ ”ESCובדוק את הגדרת הערוץ (מונה שניות
מופיע בצד שמאל של המסך).
במידה והמהירות שמוגדרת היא 14,411או 28,811שנה ל 15,211 -ונסה שנית.
זכור!
במידה ופקודות האתחול אינן קיימות (מוגדר סוג מודם ”MODEM” -וקובץ MODEMריק או לא
קיים) אזי לא תופיע הודעה "מודם סגור" גם אם הגדרת הערוץ אינה נכונה.
קיים צליל חיוג וצליל התחברות אך ההתחברות אינה מתבצעת (המילה "זיהוי" אינה
מופיעה תוך 44שניות):
א.
IRQמוגדר לא נכון – בדוק האם IRQאשר מופיע ב" -עדכון נתוני מסוף" אכן הינו
ה IRQ -בו משתמש המודם.
ב.
מודם משתמש באותו IRQעם ציוד אחר (לדוגמא – עכבר)
הגדר במודם IRQייחודי ,ע"י כפתורי המודם והגדר אותו IRQב" -עדכון נתוני מסוף".
ג.
BUSY
הגדר בסוג מודם SUPERMOD -ונסה שנית.
,NO ANSWER,שומעים קולות של "בזק" או אנשים לאחר ההתחברות:
בדוק שאיזור החיוג מוגדר נכון -קידומת 13לנמצאים מחוץ לת"א).
במידה ויש מרכזיה בדוק האם הוגדרה ונסה שנית.
במידה והמקרה חוזר על עצמו פנה לשב"א.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 75 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
ניתוק בפרמטרים:
א.
להתחברות בטוחה מודם שב"א ומודם המשתמש צריכים לעבוד באותה מהירות.
למודמים מהירים מספרי הטלפון הינם 9119973 :או . 9281549
בדוק שבזמן החיוג מופיעים על גבי המסך הטלפונים הנ"ל במידה והעבודה מתבצעת במודם
שמהירותו 5611ומעלה.
ב.
באם מודם עובד עם XON/XOFF CONTROLאזי יש לבטל זאת ע"י פקודות אתחול
מתאימות( .לרוב המודמים הפקודה מתאימה הינה .) AT&F&C1&D2X4&K0
זכור!
טלפון להקמה אשר מופיע ב" -עדכון נתוני מסוף" מיועד רק להקמה .לאחר שהתבצעה
הקמה ,המערכת עוברת למספרי טלפון אחרים אשר הוגדרו למסוף בשב"א .לכן לאחר ביצוע
ההקמה ,חשוב לבדוק שבתקשורת רגילה אין בעיות.
ג.
מסוף לא פתוח בשב"א או נסגר מחוסר פעילות לאחר שלשה חודשים שלא שודרו עסקאות -
פנה לשב"א ,וודא שאכן המסוף פתוח.
ניתוק בתנועות:
א.
ב.
במידה וניתוק מתבצע תמיד באותו מקום (ראה מספר בלוק על המסך תוך כדי שידור) יש
לבדוק קובץ תנועות לפני שידור ע"י אופציה מתאימה בתפריט ראשי ונסה שנית.
אם הניתוק מתבצע באותו מקום יכולה להיות בעיית CONTROL XON/XOFFאזי יש לבטל
זאת ע"י פקודות אתחול מתאימות (לרוב המודמים הפקודה מתאימה הינה
.)AT&F&C1&D2X4&K0
לפני פנייה לשב"א ,נא ברר עם איזה סוג מודם הינך עובד!
ניתוק בחסומים:
א.
ב.
אם ניתוק מתבצע באותו מקום יכולה להיות בעיית
.CONTROL
אם הניתוקים הינם אקראיים ,יתכן ויש הפרעות בקו הטלפון – שיחה ממתינה ,רעשים וכו'.
במקרה זה ,אם המצב נמשך זמן רב רצוי להוריד מהירות שידור ל 2411 -ולבצע שידור
באמצעות טלפון חד פעמי למספר טלפון .9293162
XON/XOFF
במידה והמודם לא התחבר עם הטלפון הזה ,יש להגדיר סוג מודם ( ”MODEM“ -באם מוגדר
אחרת) ולהכניס לקובץ MODEMפקודות ( AT\N1ביטול תיקון שגיאות).
באם לאחר שידור לא נוצר דו"ח תקשורת
כנס לאופציה "הקרן/הדפס דו"ח תקשורת" בחר "להקרין" ו" -מצטבר" וודא שהדו"ח אכן אינו קיים.
במידה ולא היו תנועות ניתן לבצע שידור בשנית.
במידה והיו תנועות כנס לאופציה "הקרנת סיכומים לשידור" ובדוק באם התנועות שודרו.
באם כן -אין להתייחס לחוסר דו"ח התקשורת.
במידה וגם באופציה הנ"ל לא רואים נתונים על השידור הבעייתי כנס לאופציה "תוכן קבצים" ובדוק
האם מופיע קובץ המוגדר כקובץ "טרם שודר".
במידה וכן בצע שידור נוסף אחרת ,פנה לשב"א.
חשוב!
במקרה של פניה לשב"א עקב בעיית תקשורת יש למסור את מספר המסוף וכן את
מהירות שידור המודם שברשותך.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 81 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
נספח 1קודי סטטוס .
111
001
112
113
114
119
116
117
118
115
111
111
112
- 113
- 114
119
- 116
117
115
121
121
122
123
124
129
126
127
128
125
131
131
132
133
134
139
136
137
138
135
141
141
142
143
144
149
146
147
191
192
- 193
- 197
- 198
- 195
–
–
-
עסקה תקינה.
חסום .
גנוב .
התקשר לחברת האשראי.
סירוב.
מזויף .
ת.ז .או CVVשגויים.
ECIאו UCAF/CAVVשגויים.
תקלה בבניית מפתח גישה לקובץ חסומים.
לא הצליח להתקשר ,התקשר לחברת האשראי.
תוכנית הופסקה עפ"י הוראת המפעיל ) (ESCאו COM PORTלא ניתן לפתיחה (.)WINDOWS
אין אישור סולק למטבע ISO
אין אישור למותג למטבע ISO
אין אישור לעסקת פריקה/טעינה.
כרטיס לא נתמך.
אין התאמה בין המספר שהוקלד לפס המגנטי.
נתונים נוספים אינם או ישנם בניגוד להגדרות המסוף.
לא הוקלדו 4ספרות האחרונות.
רשומה בקובץ INT_INקצרה מ 16 -תווים.
קובץ קלט ( )INT_INלא קיים.
קובץ חסומים ( )NEGלא קיים או לא מעודכן -בצע שידור או בקשה לאישור עבור כל עסקה.
אחד מקבצי פרמטרים או ווקטורים לא קיים.
קובץ תאריכים ( )DATAלא קיים.
קובץ אתחול ( )STARTלא קיים.
הפרש בימים בקליטת חסומים גדול מדי -בצע שידור או בקשה לאישור עבור כל עסקה.
הפרש דורות בקליטת חסומים גדול מידי – בצע שידור או בקשה לאישור עבור כל עסקה.
כאשר לא הוכנס פס מגנטי כולו הגדר עסקה כעסקה טלפונית או כעסקת חתימה בלבד.
מספר מסוף מרכזי לא הוכנס למסוף המוגדר לעבודה כרב ספק.
מספר מוטב לא הוכנס למסוף המוגדר לעבודה כרב מוטב.
מסוף שאינו מעודכן כרב ספק/רב מוטב והוקלד מס' ספק/מס' מוטב.
מסוף מעודכן כרב ספק והוקלד גם מס' מוטב.
תנועות ישנות בצע שידור או בקשה לאישור עבור כל עסקה.
כרטיס לא תקין.
כרטיס לא רשאי לבצע במסוף זה או אין אישור לעסקה כזאת.
כרטיס לא רשאי לבצע עסקה עם סוג אשראי זה.
פג תוקף.
שגיאה בתשלומים -סכום עסקה צריך להיות שווה תשלום ראשון ( +תשלום קבוע כפול מס'
תשלומים)
לא ניתן לבצע עסקה מעל תקרה לכרטיס לאשראי חיוב מיידי.
סיפרת בקורת לא תקינה.
מסוף שמוגדר כרב מוטב הוקלד מס' ספק.
מעל תקרה ,אך קובץ הקלט מכיל הוראה לא לבצע שאילתא () J1,J2,J3
חסום בספק ,אך קובץ הקלט מכיל הוראה לא לבצע שאילתא () J1,J2,J3
אקראית ,אך קובץ הקלט מכיל הוראה לא לבצע שאילתא () J1,J2,J3
מסוף לא רשאי לבקש אישור ללא עסקה ,אך קובץ הקלט מכיל (.)J9
מסוף לא רשאי לבקש אישור ביוזמתו ,אך קובץ הקלט מכיל (.)J6
יש לבקש אישור ,אך קובץ הקלט מכיל הוראה לא לבצע שאילתא () J1,J2,J3
יש לבקש אישור בשל בעיה הקשורה לקכ"ח אך קובץ הקלט מכיל הוראה לא לבצע שאילתא.
מספר רכב לא תקין.
מד מרחק לא הוקלד.
מסוף לא מוגדר כתחנת דלק( .הועבר כרטיס דלק או קוד עסקה לא מתאים)
לא הוקלד מספר תעודת זהות.
לא הוקלד . CVV2
לא הוקלדו מספר תעודת הזהות וה. CVV2 -
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 81 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
-
161
161
162
163
164
169
166
167
168
165
171
171
172
173
174
179
176
177
- 175
181
- 151
- 151
- 152
155
111
116
117
118
115
111
111
112
113
114
119
116
117
118
115
121
121
122
- 123
124
- 129
126
127
128
- 125
131
131
- 132
133
134
139
136
-
137
-
-
-
צרוף ABSלא נמצא בהתחלת נתוני קלט בזיכרון.
מספר כרטיס לא נמצא או נמצא פעמיים.
סוג עסקה לא תקין.
קוד עסקה לא תקין.
סוג אשראי לא תקין.
מטבע לא תקין.
קיים תשלום ראשון ו/או תשלום קבוע לסוג אשראי שונה מתשלומים.
קיים מספר תשלומים לסוג אשראי שאינו דורש זה.
לא ניתן להצמיד לדולר או למדד לסוג אשראי שונה מתשלומים.
אורך הפס המגנטי קצר מידי.
לא מוגדר מכשיר להקשת מספר סודי.
חובה להקליד מספר סודי.
קכ"ח לא זמין – העבר בקורא מגנטי.
הכרטיס נושא שבב ויש להעבירו דרך הקכ"ח.
דחייה – כרטיס נעול.
דחייה – פעולה עם קכ"ח לא הסתיימה בזמן הראוי.
דחייה – נתונים אשר התקבלו מקכ"ח אינם מוגדרים במערכת.
הוקש מספר סודי שגוי
מטבע לא קיים בווקטור . 95
הוכנס "קוד מועדון" לסוג אשראי לא מתאים.
עסקת ביטול אסורה בכרטיס .יש לבצע עסקת טעינה.
עסקת ביטול אסורה בכרטיס .יש לבצע עסקת פריקה.
עסקת ביטול אסורה בכרטיס .יש לבצע עסקת זיכוי.
לא מצליח לקרוא /לכתוב /לפתוח קובץ .TRAN
אין אישור מחברת אשראי לעבודה.
למסוף אין אישור לביצוע שאילתא לאשראי חיוב מיידי.
סכום העסקה גדול מידי – חלק למספר העסקאות.
למסוף אין אישור לבצע עסקאות מאולצות.
למסוף אין אישור לכרטיס עם קוד השרות 987.
למסוף אין אישור לכרטיס חיוב מיידי.
למסוף אין אישור לעסקה בתשלומים.
למסוף אין אישור לעסקה טלפון /חתימה בלבד בתשלומים.
למסוף אין אישור לעסקה טלפונית.
למסוף אין אישור לעסקה "חתימה בלבד".
למסוף אין אישור לעסקאות במטבע זר או עסקה לא מאושרת.
למסוף אין אישור לעסקת מועדון.
למסוף אין אישור לעסקת כוכבים/נקודות/מיילים.
למסוף אין אישור לאשראי ישראקרדיט.
למסוף אין אישור לאשראי אמקס קרדיט.
למסוף אין אישור להצמדה לדולר.
למסוף אין אישור להצמדה למדד.
למסוף אין אישור להצמדה למדד לכרטיסי חו"ל.
למסוף אין אישור לעסקת כוכבים/נקודות/מיילים לסוג אשראי זה.
למסוף אין אישור לאשראי קרדיט בתשלומים לכרטיסי ישראכרט
למסוף איו אישור לאשראי קרדיט בתשלומים לכרטיסי אמקס
למסוף אין אישור לקוד מועדון זה.
למסוף אין אישור לעסקת חיוב מיידי פרט לכרטיסי חיוב מיידי.
למסוף אין אישור לקבל כרטיסי ויזה אשר מתחילים ב 3. -
למסוף אין אישור לבצע עסקת זכות מעל תקרה.
כרטיס לא רשאי לבצע עסקת מועדון.
כרטיס לא רשאי לבצע עסקת כוכבים/נקודות/מיילים.
כרטיס לא רשאי לבצע עסקאות בדולרים (רגילות או טלפוניות).
כרטיס לא תקף על פי רשימת כרטיסים תקפים של ישראכרט.
כרטיס לא תקין עפ”י הגדרת המערכת ( VECTOR1של ישראכרט) -מס' הספרות בכרטיס -שגוי.
כרטיס לא רשאי לבצע עסקאות דולריות עפ”י הגדרת המערכת ( VECTOR1של ישראכרט).
הכרטיס שייך לקבוצת כרטיסים אשר אינה רשאית לבצע עסקאות עפ”י הגדרת המערכת (
VECTOR20של ויזה).
קידומת הכרטיס ( 7ספרות) לא תקפה עפ”י הגדרת המערכת ( VECTOR21של דיינרס).
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 82 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
138
135
141
141
142
143
144
149
146
147
148
145
191
191
192
193
-
194
199
196
197
198
195
161
161
162
163
164
169
166
167
168
165
171
171
172
173
174
179
176
177
178
175
181
211
211
-
כרטיס לא רשאי לבצע עסקאות בתשלומים על פי רשימת כרטיסים תקפים של ישראכרט.
מספר תשלומים גדול מידי על פי רשימת כרטיסים תקפים של ישראכרט.
כרטיסי ויזה ודיינרס לא רשאים לבצע עסקאות מועדון בתשלומים.
סידרת כרטיסים לא תקפה עפ”י הגדרת המערכת VECTOR5( .של ישראכרט).
קוד שרות לא תקף עפ”י הגדרת המערכת ( VECTOR6של ישראכרט).
קידומת הכרטיס ( 2ספרות) לא תקפה עפ”י הגדרת המערכת VECTOR7( .של ישראכרט).
קוד שרות לא תקף עפ”י הגדרת המערכת VECTOR12( .של ויזה).
קוד שרות לא תקף עפ”י הגדרת המערכת VECTOR13( .של ויזה).
לכרטיס חיוב מיידי אסור לבצע עסקת זכות.
כרטיס לא רשאי לבצע עסקאות בתשלומים עפ"י וקטור 31של לאומיקארד.
כרטיס לא רשאי לבצע עסקאות טלפוניות וחתימה בלבד עפ"י ווקטור 31של לאומיקארד.
כרטיס אינו רשאי לבצע עסקאות טלפוניות עפ"י וקטור 31של לאומיקארד.
אשראי לא מאושר לכרטיסי חיוב מיידי.
אשראי לא מאושר לכרטיסי חו"ל.
קוד מועדון לא תקין.
כרטיס לא רשאי לבצע עסקאות אשראי גמיש (עדיף )/31+עפ"י הגדרת המערכת VECTOR21( .של
דיינרס).
כרטיס לא רשאי לבצע עסקאות חיוב מיידי עפ"י הגדרת המערכת VECTOR21( .של דיינרס).
סכום המינמלי לתשלום בעסקת קרדיט קטן מידי.
מספר תשלומים לעסקת קרדיט לא תקין.
תקרה 1לסוג כרטיס זה בעסקה עם אשראי רגיל או קרדיט.
תקרה 1לסוג כרטיס זה בעסקה עם אשראי חיוב מיידי.
תקרה 1לסוג כרטיס זה בעסקת חיוב מיידי בדולרים.
תקרה 1לסוג כרטיס זה בעסקה טלפונית.
תקרה 1לסוג כרטיס זה בעסקת זכות.
תקרה 1לסוג כרטיס זה בעסקת תשלומים.
כרטיס אמריקן אקספרס אשר הונפק בחו"ל לא רשאי לבצע עסקאות בתשלומים.
כרטיסי JCBרשאי לבצע עסקאות רק באשראי רגיל.
סכום בכוכבים/נקודות/מיילים גדול מסכום העסקה.
כרטיס מועדון לא בתחום של המסוף.
לא ניתן לבצע עסקת כוכבים/נקודות/מיילים בדולרים.
למסוף אין אישור לעסקה דולרית עם סוג אשראי זה.
לא ניתן לבצע עסקת זכות עם אשראי שונה מהרגיל
סכום הנחה בכוכבים/נקודות/מיילים גדול מהמותר.
לא ניתן לבצע עסקה מאולצת לכרטיס/אשראי חיוב מיידי.
לא ניתן לבטל עסקה קודמת (עסקת זכות או מספר כרטיס אינו זהה).
עסקה כפולה.
למסוף אין אישור להצמדה למדד לאשראי זה.
למסוף אין אישור להצמדה לדולר לאשראי זה.
כרטיס אינו תקף עפ”י הגדרת ה מערכת (וקטור 1של ישראכרט).
בתחנות דלק לא ניתן לבצע "שרות עצמי" אלא "שרות עצמי בתחנות דלק".
אסור לבצע עסקת זכות בכוכבים/נקודות/מיילים.
אסור לבצע עסקת זכות בדולר בכרטיס תייר.
בכרטיס מועדון לא ניתן לבצע עסקה טלפונית.
שגיאה יישומית.
תקלה בקבלת נתונים מוצפנים.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 83 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
UCAF/CAVV תוצאות בדיקת- 1 נספח
UCAF/CAVV להלן הערכים האפשריים של תוצאת בדיקה
Value
Description
Blank
CAVV not present in authorization message
0
CAVV authentication results invalid
1
CAVV failed validation- authentication
2
CAVV passed validation- authentication
3
CAVV passed validation- attempt (CAVV generated by issuer's ACS)
4
CAVV failed validation- attempt (CAVV generated by issuer's ACS)
5
Not used (reserved for future use)
6
CAVV not validated, issuer not participating in CAVV validation
7
CAVV failed validation- attempt (CAVV generated by Visa)
8
CAVV passed validation- attempt (CAVV generated by Visa)
9
CAVV failed validation- attempt (CAVV generated by Visa – Issuer ACS Unavailable)
A
CAVV passed validation- attempt (CAVV generated by Visa – Issuer ACS Unavailable)
B
CAVV passed validation- information only, no liability shift (ECI = 7 and CAVV is present,
the CAVV will be validated but no liability shift will occur. Visa will generate this value for
card or transaction types that are not eligible for the 3-D Secure service).
C
CAVV was not validated – attempt (Issuer didn't return CAVV results code in the
authorization response).
D
CAVV was not validated – authentication (Issuer didn't return CAVV results code in the
authorization response).
תגרום לחברת האשראי לדחות את העסקהUCAF/CAVV במידה וכתוצאה של בעיית
.) – סירוב4 יוחזר אחד מקודי השגיאה המקובלים במערכת (למשל
--------------------------------------------------------------------------------------------------------------------------------------------------07/13 V9.58
- 84 -
mefizim598.doc
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
להלן הערכים האפשריים של : ECI
רמת אבטחה
תיאור
1
ברירת מחדל-עסקה שאיננה עסקת אינטרנט
1
עסקת אינטרנט בכרטיס מסטרכרד ,ללא ucafבהתאם לערך פוציזיה 3
בשדה pds42
2
עסקת אינטרנט בכרטיס מסטרכרד ,עם ucafבהתאם לערך פוציזיה 3
בשדה pds42
9
עסקה מאובטחת בשיטת SETאו 3D-Secureברמת בית העסק ומחזיק
הכרטיס.
6
עסקה בה נעשה שימוש באבטחת מידע ( ,)SSLבית העסק תומך ב SET
אבל העסקה אינה מאובטחת באחד מהפרוטוקולים של ויזה SETאו
3D-Secureבאופן מלא.
7
עסקה בה נעשה שימוש באבטחת מידע ( )SSLאך לא בשיטת 3D Secure
או SET
8
עסקת אינטרנט שאינה מאובטחת כלל.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 89 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
נספח – 2הנחיות למפיצים לשילוב כרטיסים נטענים/מתנה
.1כללי
חברות האשראי מרחיבות את השימוש בכרטיסי ( pre-paidכרטיסים נטענים) ,לרבות כרטיסי מתנה
הנמכרים לצרכנים לשימוש בבתי עסק שונים.
לצורך כך יש צורך לייצר פונקציות תפעוליות בקופות בתי העסק שיתמכו בשימוש השוטף בכרטיסים
נטענים ובטיפול בעסקאות המיועדות לטעינת כרטיסים אלו.
מטרת מסמך זה ,להציג את פירוט הדרישות של חברת האשראי ,ברמת הקופה וברמת תוכנת
אשראית.
הגדרות
•
כרטיס נטען ( :)prepaidכרטיס אשראי שניתן לטעון אותו בסכום כסף בחברת האשראי או
בבית העסק והנו רשאי לבצע עסקאות חובה עד גובה היתרה בכרטיס .סכום היתרה מתעדכן
באופן מקוון לאחר כל פעולה בכרטיס.
•
עסקת טעינה :עסקת זיכוי עם סימון מיוחד ,שאינה מקושרת לעסקת חובה קודמת בכרטיס
ומעדכנת את יתרת הכרטיס באופן מקוון.
.1אפיון פונקציונלי
זיהוי סוגי הכרטיסים
1.1
תוכנת אשראית PCבגרסה 9.81ומעלה מותאמת לזיהוי הכרטיסים הנטענים.
1.1
2.2.1
כללי התמיכה בכרטיס (לידיעה בלבד)
כרטיס נטען רשאי לבצע עסקאות חובה עד גובה יתרת הכרטיס בחברת האשראי.
לכן ,בצוע כל עסקה מותנה באישור מקוון של חברת האשראי המנפיקה.
2.2.2כרטיס נטען רשאי לבצע עסקאות בסוג אשראי רגיל (עם או בלי הנחה בנקודות) .תוכנת אשראית
חוסמת את האפשרות לבצע עסקאות בסוג אשראי אחר.
PC
2.2.3לא ניתן לאלץ עסקה בכרטיס נטען .
2.2.4תוכנת אשראית PCחוסמת אפשרות לקבל קוד אישור מראש שהוקלד ידנית במסוף/הקופה בעסקה
שמשולמת עם כרטיס נטען.
2.2.9תוכנת אשראית PCחוסמת אפשרות לביטול עסקה בכרטיס נטען .במקום זאת ניתן לבצע עסקת
זיכוי.
2.2.6בכל פעולה בכרטיס נטען ,כולל בקשה לאישור ללא עסקה ,תחזיר חברת האשראי במסר התשובה
לבקשה לאישור את יתרת הכרטיס המעודכנת לאחר הפעולה .הנחיות להצגה בקופה והדפסה בפתקית
כמפורט בסעיף .3.1
2.2.7ניתן לבצע בקשה לבירור יתרה (ללא עסקה) כמתואר בסעיף .4.1.2
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 86 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
2.2.8ניתן ל"טעון" את הכרטיס ע"י ביצוע "עסקת טעינה" – כמתואר בסעיף .3.2
2.2.5כיון שעסקת טעינה הינה עסקת זכות ,בהתאם לכללי אשראית אין לאפשר את ביטולה גם אם עסקת
הטעינה היתה עסקה אחרונה.
במקום זאת הקופאית יכולה לבצע עסקת חובה בכרטיס (או שהנושא יטופל טלפונית בין בית העסק
וחברת האשראי).
.2
שימוש בכלים שמספקת תוכנת אשראית PC
תוכנת אשראית PCבגרסה 9.75תומכת בדרישת חברות האשראי לטיפול בכרטיסים נטענים.
2.1
הקרנת ו/או הדפסת נתונים המועברים מהמנפיק למסוף (כולל יתרה)
ברשומת INT_OTבפוזיציה 44מוגדר שדה בשם dsp-detailsבאורך 8תוים ,בו אשראית יכולה
להחזיר יתרה לכרטיס המיועדת להקרנה והדפסה על הפתקית.
בנוסף קיים ברשומת INT_OTבפוזיציה 4שדה בשם add-dsp-detailsבן תו אחד הכולל הוראות
הצגה ו/או הדפסה של תוכן השדה הנ"ל.
השדה יכול להכיל את הערכים הבאים:
דרישה
מסר נוסף
להקרנת
Add-dsp-details
1
אין דרישה (ברירת מחדל)
1
נדרש להקרין ולהדפיס המסר בפתקית בש"ח
2
נדרשת הקרנת המסר בלבד בש"ח
3
נדרש להדפיס את המסר רק בפתקית בש"ח
4
נדרש להדפיס בפתקית ולהקרין במסך מטבע דולר
9
נדרש להדפיס בפתקית ולהקרין במסך מטבע יורו
אופן הקרנת/הדפסת תוכן השדה dsp-details
כאשר יש בשדה add-dsp-detailsהנחיה להקרין ו/או להדפיס ,יש להציג ו/או להדפיס את תוכן
השדה dsp-detailsבתוספת המלל הבא:
"יתרך המעודכנת בכרטיס <תוכן השדה ₪ > dsp-detailsט.ל.ח"
סכום היתרה יועבר באגורות ,ללא נקודה עשרונית .על המפיץ להציג את הסכום עם נקודה
עשרונית.
הדפסת היתרה תתבצע בעותק הלקוח בלבד.
הפתקית שנוצרת על ידי אשראית כבר מכילה את התיקון הנדרש.
שים לב :במידה ואין תקשורת -אין להציג יתרה כלל
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 87 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
2.1
תמיכה בעסקאות טעינה
עסקת טעינה הינה עסקת זיכוי מיוחדת מקוונת ,המוגבלת לקבוצת הכרטיסים הנטענים בלבד .תוכנת
אשראית מותאמת לרישום קוד מיוחד ברשומת העסקה בקובץ .TRAN
3.2.1
עסקת טעינה מתבצעת בסוג מטבע ₪בלבד .
3.2.2
יש להכין בקופה מקש מיוחד או קוד פעולה מיוחד לביצוע עסקת טעינה
3.2.3
לצורך דיווח עסקת טעינה יש לרשום בפרמטר Dערך ( 91עסקת זכות) וגם לציין בפרמטר J
ערך .7
.4
4.1
תמיכה בקופה
להלן הנחיות כלליות למימוש התמיכה בכרטיסים נטענים .הנחיות מדויקות יקבעו בתהליך אפיון בין
חברת האשראי ובית העסק.
ברירות מחדל לכרטיסים נטענים כאמצעי תשלום
4.1.1
הצגת יתרה לאחר פעולת טעינת כרטיס או קניה באמצעות הכרטיס:
חברת האשראי תחזיר במסר התשובה את יתרת הכרטיס הנטען .המפיץ יטפל בהצגת היתרה
כמתואר בסעיף .3.1
מומלץ להציג את היתרה במסך שיקפוץ מיידית לקופאי ,ללא הקשה על כפתור נוסף.
4.1.2
בקשה לבירור יתרה
יש לבצע בקשה לאישור ללא עסקה ( )J5בגובה .₪ 1חברת האשראי תחזיר במסר התשובה
את יתרת הכרטיס .המפיץ יטפל בהצגת היתרה כמתואר בסעיף .3.1
.4.1
מכירת כרטיס נטען – טעינה בקופת בית העסק
.1תהליך מכירת כרטיס נטען הינו החלפת אמצעי תשלום עבור הלקוח.
.2להלן פירוט התהליך:
א .צרכן מבקש לקנות כרטיס נטען בסכום מסוים.
ב .בית העסק בוחר בפונקצית מכירה של כרטיס נטען.
ג .הקופאי/ת מזרים את סכום הטעינה המבוקש.
ד .הקופאי/ת מבקש מהלקוח אמצעי לתשלום בגין רכישת הכרטיס.
ה .לאחר גמר גביית התשלום תבקש הקופה להעביר את הכרטיס הנטען
בקורא הכרטיסים.
ו .בגמר התהליך תצא קבלה על קניית הכרטיס וקבלה על פעולת הטעינה
ללא הוצאה של חשבונית בגין העסקה.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 88 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
4.2
פיצול התשלום בגין עסקת חובה בכרטיס prepaid
.1אם סכום עסקת החובה גבוה מיתרת הכרטיס ,חברת האשראי תדחה את
העסקה ותחזיר את ערך יתרת הכרטיס.
.2בשלב זה הקופה תאפשר להמשיך בביצוע התשלום בגין הרכישה ע"י
אחת מהאפשרויות הבאות:
א .ביצוע עסקה בכרטיס הנטען עד סכום היתרה שהוצג ,והיתר באמצעי
תשלום אחר .המצב הרצוי הוא שתוכנת המפיץ תכין אוטומטית עסקה
חדשה עד גובה היתרה שהוחזרה .הקופאי/ת יכולים להקטין את הסכום
שבעסקה או לא לשגר אותה.
ב .ביצוע העסקה בכל אמצעי תשלום אחר על פי בחירת הלקוח.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 85 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
נספח – 4הנחיות למפיצים לשילוב תמיכה בסליקה רב מטבעית.
.9כללי
חברות האשראי מרחיבות את השימוש באשראית לקודי מטבע נוספים שבהם ניתן לבצע עסקאות
מט"ח.
לצורך כך נוספו באשראית PCיכולות חדשות שיאפשרו ליצרני הקופות לבצע את הפונקציות
התפעוליות לביצוע עסקאות במגוון מטבעות זרים נוספים.
מטרת מסמך זה ,להציג את פירוט היכולות החדשות באשראית PCואת דרך המימוש של דרישות
חברות האשראי ברמת הקופה.
.6הגדרות
.6.1עסקה במט"ח :עסקה שאינה מתבצעת בשקלים או בדולר (שממשיך להיתמך בשיטה הישנה) ,ובה
מוגדר סוג המטבע = 1קוד מטבע מיוחד ב .ISO
.6.1מסוף מורשה עסקאות מט"ח :מסוף בו הסולק תומך בעסקאות חובה/זיכוי במטבע מיוחד.
.7אפיון התמיכה של אשראית PC
.7.1
זיהוי סוגי הכרטיסים
תוכנת אשראית PCבגרסה 9.84ומעלה מותאמת לביצוע עסקאות במטבע מיוחד לכרטיסי המותגים
ויזה ומסטרקארד .כמפורט להלן:
.7.1
תמיכה בעסקאות מטבע מיוחד (לידיעה בלבד)
.7.2.1
מסופים בסליקת תיייר על ידי כאל הותאמו באופן שונה ואין לשנות את מה שכבר הותאם
(ראה פירוט בהמשך).
.7.2.2
כל עסקה במטבע מיוחד מתבצעת בסוג אשראי רגיל בלבד וחייבת לקבל אישור מחברת
האשראי.
.7.2.3
תוכנת אשראית PCחוסמת אפשרות לביטול עסקה במטבע מיוחד .תוכנת אשראית PCתוציא
קוד שגיאה מתאים .במקום זאת ניתן לבצע עסקה הפוכה (זיכוי במקום חיוב ולהפך) או
שהנושא יטופל טלפונית בין בית העסק וחברת האשראי.
.7.2.4
אין אפשרות לאלץ עסקה במטבע מיוחד.
.7.2.9
ניתן להקליד ידנית מספר אישור למסוף/קופה בעסקת מטבע מיוחד (למעט עסקאות טעינה
במטבע מיוחד – שלא רלוונטיות בשלב זה) .
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 51 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
שימוש בכלים שמספקת תוכנת אשראית PC
.8
תוכנת אשראית PCבגרסה 9.84תומכת בדרישת חברות האשראי לביצוע עסקאות חובה/זכות רגילות
במגוון מטבעות נוספים מעבר למה שהיה קיים עד כה.
.8.1
שימוש בקוד מטבע ISO
בחירת מטבע העסקה
.8.1.1
וקטור ( 95ראה סעיף 7להלן) מכיל את קודי המטבע הנוספים איתם ניתן לבצע עסקאות חובה/זכות
במסוף.
אפשר להשתמש בקובץ ISO59להצגה למשתמש של קוד המטבע המבוקש.
.8.1.1
זיהוי סליקת המסוף
בעסקת מטבע מיוחד יש לזהות על ידי J2מי סולק את העסקה במסוף.
אם הסליקה היא על ידי כ.א.ל או דיינרס :
יש לבצע תחילה שאילתא ב J5 -בסוג מטבע דולר ,לצורך קבלת מס' אישור.
בשלב השני להפעיל אשראית לצורך ביצוע העסקה עם המטבע המקורי ( )ISOומס' האישור
שהתקבל.
אם הסליקה היא ע"י חברה אחרת יש לפעול כמפורט בסעיפים הבאים.
.8.1.2
שימוש באשראית
לפירוט קוד המטבע ISOבו מבוצעת העסקה נוסף ב INT_INפרמטר חדש . $ -
ברשומת INT_INבפרמטר Dיש לשים ערך 1במקום של סוג מטבע .ובפרמטר $להציב את ערך קוד
.ISOהקוד לא מוחזר ב .INT_OT
.8.1
קודי שגיאה נוספים.
-11אין אישור סולק למטבע ISO.
- 12אין אישור למותג למטבע ISO.
- 14כרטיס לא נתמך.
- 75מטבע לא קיים בוקטור .95
- 52עסקת ביטול אסורה בכרטיס .יש לבצע עסקת זיכוי.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 51 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
.6שינויים בפתקית עבור עסקאות במט"ח
בעסקאות שהתבצעו במט"ח יופיע סכום העסקה במט"ח .שם המטבע יילקח משדה curr-name
בווקטור ( 95נספח )4בהתאם לקוד המטבע ב ISOהמופיע
בשדה .special-currency
.14שינויים בדו"ח התקשורת המשודר מהמסוף
דו"ח התקשורת יכלול פירוט של העסקאות שהתבצעו מהמסוף במטבע ISOעל פי הפורמט המוטמע
עבור מטבע ₪ו –דולר.
.11מבנה ווקטור –46קודי 4711 ISOלמט"ח ראה פרק 14
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 52 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
נספח – 4הוראות שימוש לתוכנית .STUNNEL
.1כללי.
תוכנית Stunnelמיועדת לייצר קישור SSLשל מסופי אשראית לשב"א מעל תווך ה .INTERNET
לתוכנית Stunnel.exeלשתי מטרות עיקריות:
.1זיהוי דו-כיווני בין מחשב משתמש לשרת שב"א על-ידי תעודות דיגיטליות מיוחדות.
.2הצפנה מסרים אשר עוברים דרך Internetב.SSL-
.2אופן פעילות.
משתמש מקבל קובץ Stunnel.zipוקובץ . Client.pemעליו לפתוח את ה ZIP-ולשים את הקבצים שבו יחד עם
קובץ Client.pemלאותה ספריה (רצוי בספריה שבה נמצאים יתר קבצי אשראית) .במידה וספריה זאת לא
מוגדרת על-ידי אפליקציה של המשתמש כספרית העבודה ( ,)Current Directoryאזי יש להכניס את מסלולה
למשתנה :PATH
עבור - Windows95/98פקודה SET PATHבקובץ .Autoexec.bat
עבור - Windows 2000/XPמחשב שלי – מאפיינים – מתקדם – משתני סביבה – משתני מערכת.
)(My computer-Properties-Advance-Environment variables-System Variables
על ידי כך תוכל תוכניות אשראית ,אשר מבצעות תקשורת ,למצוא קובץ .Stunnel.exe
חשוב :בערכת Stunnel.ZIPיש תעודה כללית של שב"א שנקראת .Cafile.pem
באתר שב"א נמצאת ערכה חדשה של Stunnel.ZIPשכוללת את התעודה הכללית החדשה Cafile.pem
מתאריך .18/11/1414אם במקרה התקנת ללקוחות תעודת מסוף מבלי להתקין גם את התעודה הכללית
החדשה ,דע לך שבשנת 1414תיפסק ,ללא כל הודעה מקדימה ,יכולת ההתקשרות של המסוף לשב"א בשל
פקיעת תוקף התעודה הכללית.
.3הגדרות.
א.
ב.
ג.
ד.
באופציה "עדכון פרמטרים – פרמטרים נוספים" של מערכת אשראית יש להגדיר “תקשורת
על-ידי ”INTERNETוכתובת )localhost( 127.1.1.1ופורט ( 999ראה להלן).
כברירת מחדל תוכנית Stunnelמשתמשת בפורט 999במחשב של לקוח .אם מסיבה כלשהי
רוצים לשנות את זה ,אזי ניתן לעשות זאת בפרמטר “ ”acceptשל קובץ .Stunnel.confבמקרה
כזה יש לעשות שינוי גם באופציה "עדכון פרמטרים – פרמטרים נוספים" של מערכת אשראית
לגבי מספר פורט בהתאם.
פרמטר taskbarבקובץ Stunnel.confמגדיר האם ICONשל Stunnelמופיע בלוח משימות
( .)taskbar = yesבמידה וכל התקשרות נוספת גורמת להתווספות ICONכזאת ללוח משימות
(הדבר קורה במערכות מסוימות) יש לפנות לשב"א לקבלת גרסה מעודכנת יותר של המערכת.
במערכות מסוימות יש בעיה עם קבצים של ארבע תווים בסיומת(.) stunnel.conf
ניתן לשנות שם קובץ ל . stunnel.cnf-אם Stunnel.exeלא מתייחס לשינוי ,אזי יש לפנות לשב"א
לקבלת גרסה מתקדמת יותר של . Stunnel
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 53 -
07/13 V9.58
מחלקת תוכנה
-----------------------------------------------------------------------------------------------------------------------------------------------------
.4תקלות.
א .לא הצליח להפעיל – STUNNELתוכנית Stunnel.exeאינה נמצאת בספרית עבודה או באחת
מהספריות המוגדרות במשתנה PATHשל מערכת ההפעלה.
ב – .…Server is down .תוכנית STUNNELהופעלה ,אך יש בעיה בריצה.
במידה ולא מוקרן אוטומטי LOGעם סיבה לתקלה ניתן להפעיל Stunnel.exe
ידנית ואז לראות סיבת התקלה.
ג - …Socket error .במידה והבעיה הופיעה כאשר משתמש מנסה לבצע עסקה ,יש לבדוק האם
הבעיה קיימת גם בשידור תנועות .במידה ולא ,קרוב לוודאי שקיימת
תוכנית ממשק של אשראית ישנה במחשב של משתמש והיא למעשה משמשת לצורך ביצוע
עסקאות .בדרך כלל זה קורה למשתמשי .INTR32.DLLיש לבדוק
שבספריות Windows/System32 , Windows/System ,Windowsלא קיים
קובץ INTR32.DLLישן.
ד.
במידה והבעיה הנ"ל קיימת גם בשידור תנועות יש לבצע כדלקמןRun – Start :
Enter – telnet 127.0.0.1 555
במסך שנפתח אמורים להופיע סימני "~" .אם זה לא כך – יש בעיה תשתית.
--------------------------------------------------------------------------------------------------------------------------------------------------mefizim598.doc
- 54 -
07/13 V9.58
© Copyright 2024