Transcription

1 תיעוד ממשק MTS WebService ממשק ה Web Service מיועד לשימוש מול שרתי הסליקה ממשפחת MTS מבית ארקום. ממשק זה מאפשר למפתחים להתממשק לשרתי הסליקה ללא כל צורך בביצוע הטמעות, פענוח או פעולות כלשהן הקשורות במערכת סליקת כרטיסי אשראי בעצמם. על המפתח ליצור ממשק משתמש לקליטת נתוני העסקה ולהעבירם באמצעות ה Web Service לסליקה. ניתן לקבל תכנית הדגמה בסביבת VB.NET 200 המתארת ומדגימה את אופני הקריאה והשימוש בממשק. הממשק פועל במלואו תחת הצפנת SSL כתובת ה URL להפעלה חיה בלבד היא כתובת ה URL לצרכי פיתוח, בדיקות וטסטים היא שים לב: שמות הפרמטרים המועברים לפונקציות הינם case sensitive למשתמשים בהעברת נתונים שלא אמצעות הפונקציות מומלץ לבדוק מול פריסת הממשק ב URL ארקום ת.ד חדרה 3830 טלפון פקס עמוד מתוך 22

2 הפונקציות החשופות בממשק: - MTS_Ping משמשת לקבלת חיווי לזמינות ופעילות השרת - MTS_GetTransactionID משמשת לקבלת מזהה עסקה - MTS_PutTransactionRequest משמשת להעברת עסקה לבצוע בשרת - MTS_GetTransactionResults משמשת לקבלת תוצאות עסקה מהשרת - MTS_SendNotes משמשת לשליחת שוברי עסקה לבית העסק וללקוח - MTS_PutTransactionAcknowledge משמשת להעברת אישור לשרת לסגירת מהלך העסקה - MTS_GetErrorDescription משמשת לקבלת תיאור שגיאה שנתקבלה כתוצאה מביצוע עסקה - MTS_PutMultiTransactionRequest משמשת להעברת קובץ עסקאות (הוראות קבע) - MTS_GetMultiTransactionResults משמשת לקבלת קובץ תוצאות (הוראות קבע) (Tokens) משמשת לניהול אסימונים - MTS_TokenHandler - MTS_GetTerminalDB משמשת לקבלת בסיס הנתונים מהשרת - MTS_TerminalDB_Ack משמשת לעדכון השרת כי בסיס הנתונים התקבל ולמחיקת הלינק - MTS_CC_Transaction משמשת לביצוע פעולת חיוב במהלך יחיד (נא ראה הסבר בהמשך) כל הפונקציות מחזירות ערך נומרי 0 (אפס) בהצלחה או קוד שגיאה רלוונטי המתאים למהות השגיאה פונקציות האמורות להחזיר ערכים נוספים עושות זאת בדריכת הפרמטר המתאים שהועבר אליהן בקריאה ארקום ת.ד חדרה 3830 טלפון פקס עמוד 2 מתוך 22

3 מהלך נכון של פעילות מול ממשק הסליקה פנה לשרת לקבלת מזהה עסקה ייחודי - MTS_GetTransactionID העבר לשרת את נתוני העסקה - MTS_PutTransactionRequest פנה לשרת בבקשה לקבלת תוצאות העסקה - MTS_GetTransactionResults פנה לשרת לקבלת תיאור קוד הסטאטוס שהוחזר בתשובה - MTS_GetErrorDescription במידת הצורך העברת נתוני שוברים לשליחה ללקוח ולבית העסק העבר חיווי לשרת לסגירת מהלך העסקה - MTS_PutTransactionAcknowledge או לחילופין בפעולה במהלך יחיד באמצעות MTS_CC_Transaction הערות: ללא מזהה עסקה ייחודי לא ניתן לאחזר תוצאות עסקאות שמור את מזהה העסקה במידה וחלה תקלה או ניתוק תקשורת תמיד ניתן לפנות עם מזהה עסקה ולאחזר את תוצאת העסקה אשר תמתין בשרת עד לקבלת חיווי סגירת מהלך עסקה את פעולת הבקשה לקבלת תוצאת עסקה ניתן להפעיל ללא קשר למהלך העברת העסקה יש לקחת בחשבון כי בעת הפניה העסקה לא נסתיימה ולכן תתקבל הודעה כי לא נמצאה תוצאת עסקה (קוד 902). במקרה כזה יש לפנות שוב ולבקש את תוצאות העסקה. את הפניות יש להפעיל בלולאה עד אשר מתקבל קוד חוזר 0 (יש תוצאה). יש לאפשר פסק זמן של לפחות שנייה בין פניה לפניה. השימוש בפונקציה MTS_CC_Transaction מחייב שימוש במזהה ייחודי אשר מועבר לשרת, מזהה ייחודי זה נועד בעיקר על מנת לאפשר במקרה של תקלה לחזור למערכת ולאחזר את תוצאות העסקה. o האחריות על ייחודיות המזהה, ייצורו ואספקתו לשרת חלה במלואה על המפתח. o ניתן כמובן להשתמש בפונקציה המייצרת מזהה ייחודי המסופקת בממשק. ארקום ת.ד חדרה 3830 טלפון פקס עמוד 3 מתוך 22

4 פרמטרים המועברים לפונקציות פרמטר המסומן באדום מצביע על פרמטר המועבר By Reference ומשמש להחזרת נתונים מהפונקציה תיאור / הערות קבלת חיווי זמינות מהשרת - MTS_Ping סוג שם הפרמטר TerminalNum Password קבלת מזהה עסקה ייחודי - MTS_GetTransactionID תיאור / הערות סוג שם הפרמטר TerminalNum Password מזהה ייחודי לעסקה TransactionID קבלת תוצאות עסקה - MTS_GetTransactionResults תיאור / הערות סוג שם הפרמטר TerminalNum Password מזהה ייחודי לעסקה כפי שנתקבל מהשרת TransactionID תוצאת העסקה מבנה הנתונים יפורט בהמשך Answer שובר העסקה חלק בית העסק (מוכן להדפסה) במידה והעסקה כשלה או לסוג העסקה אין פתקית יוחזר פרמטר ריק MerchantNote שובר העסקה לחתימת הלקוח (מוכן להדפסה) במידה והעסקה כשלה או לסוג העסקה אין פתקית יוחזר פרמטר ריק ClientNote ארקום ת.ד חדרה 3830 טלפון פקס עמוד 4 מתוך 22

5 קבלת תיאור לקוד שגיאה - MTS_GetErrorDescription תיאור / הערות סוג שם הפרמטר TerminalNum Password מזהה ייחודי לעסקה כפי שנתקבל מהשרת TransactionID קוד השגיאה כפי שהתקבל מהשרת ErrorCode תיאור השגיאה בעברית ErrorDesc העברת אישור לשרת על סגירת מהלך העסקה - MTS_PutTransactionAcknowledge תיאור / הערות סוג שם הפרמטר TerminalNum Password מזהה ייחודי לעסקה כפי שנתקבל מהשרת TransactionID ארקום ת.ד חדרה 3830 טלפון פקס עמוד 5 מתוך 22

6 העברת קובץ לחיובי הוראות קבע - MTS_PutMultiTransactionRequest תיאור / הערות סוג שם הפרמטר TerminalNum Password מזהה ייחודי לעסקה כפי שנתקבל מהשרת TransactionID קובץ חיובים במבנה של שורות טקסט (CSV) ובסוף כל שורה CR/LF RequestBuffer בחיובי הוראות קבע לא מוחזרים שוברי עסקה לחתימת הלקוח מבנה רשומה להוראות קבע ,22,0.,234567,PrivRef Card Number (PAN) or Token Card Expiry (MMYY) Transaction Amount Pre-Approval Code (as received from the J5 operation) Private Reference (X Parameter MAX 9 Chars) כל השדות הם מנדטוריים. ניתן להעביר ערך ריק לשדה אך חובה לשמר את מבנה השורה. בדוגמא הבאה מועברת שורה ללא אסמכתא פרטית אך הפסיק בסוף השורה ממשיך להופיע ,22,0.,234567, הערה: ניתן להעביר את קובץ החיובים במבנה Int_IN רגיל של שב"א במקום במבנה זה. המערכת תזהה אוטומטית את המבנים ותפעל עליהם כנדרש באופן שקוף לחלוטין התשובות המוחזרות לא מושפעות ממבנה הנתונים המועברים בקובץ החיובים ארקום ת.ד חדרה 3830 טלפון פקס עמוד 6 מתוך 22

7 קבלת תוצאות לקובץ הוראות קבע - MTS_GetMultiTransactionResults תיאור / הערות סוג שם הפרמטר TerminalNum Password מזהה ייחודי לעסקה כפי שנתקבל מהשרת TransactionID קובץ תוצאות השורות במבנה התשובה כמפורט בהמשך Answer שליחת שוברי עסקה שם הפרמטר TerminalNum Password TransactionID MerchantNote ClientNote Client MTS_SendNotes סוג תיאור / הערות מזהה ייחודי לעסקה כפי שנתקבל מהשרת שובר עסקה (עותק בית העסק) כפי שהועבר ע"י השרת שובר עסקה (עותק לקוח) כפי שהועבר ע"י השרת כתובת דוא"ל של הלקוח הערות: שובר בית העסק יישלח לכתובת הדוא"ל הרשומה במערכת ואליה נשלחים גם דו"חות השידור ניתן להעביר רק שובר לקוח או רק שובר בית עסק, שובר ריק לא יישלח השוברים אשר יישלחו יהיו במבנה JPG למניעת אפשרות שינויים או עריכה וכן לצפייה נוחה ארקום ת.ד חדרה 3830 טלפון פקס עמוד 7 מתוך 22

8 יצירת עסקה - MTS_PutTransactionRequest שם הפרמטר TerminalNum Password TransactionID CardNum CardExpiry TransSum TransPoints Last4Digits CVV2 ID TransCurrency ISO_Currency CreditType ApprovalCode FirstPayment FixedPayment NumOfFixedPayments TransRef J_Prm סוג נומרי נומרי נומרי נומרי נומרי נומרי נומרי נומרי תיאור / הערות מזהה ייחודי לעסקה כפי שנתקבל מהשרת מספר כרטיס אשראי / תוכן פס מגנטי תוקף כרטיס MMYY בעסקה עם פס מגנטי חובה להעביר ערך כלשהו, מומלץ 0000 סכום הפעולה (לזיכוי יש להעביר מספר שלילי) כוכבים/נקודות לשימוש כחלק מהסכום לחיוב ארבע ספרות אחרונות במספר הכרטיס קוד אימות כרטיס (4 ספרות) ת.ז. בעל הכרטיס (9 ספרות) קוד מטבע / עסקת תשלומים קידוד ISO של המטבע (ראה נספח עבודה במט"ח בהמשך) קוד סוג אשראי קוד אישור מוקדם לעסקה כפי שנתקבל טלפונית סכום תשלום ראשון בעסקת תשלומים סכום כל אחד משאר התשלומים מספר התשלומים אסמכתא פרטית שדה חופשי (פרמטר X) עד 9 תווים קוד סוג פעולה * J Z_Prm Q_Prm R_Prm ערך פרמטר Z (רק למסופים עם אישור מחברת האשראי. באין אישור יועבר ריק) ערך פרמטר Q ערך פרמטר R במידה ואין צורך או שימוש בשדה מסוים לא ניתן שלא להעביר בו ערך ולכן יש לטעון אותו באפס (0) עבור שדה נומרי ושדה ריק ("") עבור שדה נומרי. פרמטר J משמש בפרמטר לקביעת אופי הפעולה, להלן הערכים ומשמעותם: פעולת חיוב/זיכוי רגילה משמש לקבלת זיהוי בלבד ובדיקת הכרטיס כאקט לפני ביצוע פעולה (במרבית המקרים מיותר ואינו מומלץ) משמש לקבלת אישור בלבד ללא ביצוע חיוב בפועל. מיועד להוראות קבע / תשלום נדחה באמצעות כרטיס אשראי ארקום ת.ד חדרה 3830 טלפון פקס עמוד 8 מתוך 22

9 הערות בהעברת סכום תשלום ראשון וסכום כל תשלום בערכי אפס (0) המערכת תחשב אוטומטית את ערכי התשלומים בהעברת סכום תשלום ראשון מחושב ואת ערך התשלום הקבוע בשאר התשלומים אפס (0) המערכת תחשב את ערך התשלום הקבוע מפרט ערכים לשדה סוג אשראי (CreditType) סוג אשראי רגיל ישרא/אמקס קרדיט ויזה/דיינרס עדיף 30 פלוס חיוב מיידי מועדון אשראי סופר קרדיט קרדיט/קרדיט בתשלומים קבועים תשלומים עסקת מועדון בתשלומים קוד מפרט ערכים לשדה קוד מטבע (TransCurrency) סוג מטבע מטבע לפי מפרט ISO לא נתמך במלואו באופן סטנדרטי ע"י חברות האשראי שקל דולר עסקת תשלומים צמודים לדולר עסקת תשלומים צמודים למדד קוד שים לב: נא לפנות למחלקת התמיכה לקבלת מספר מסוף וסיסמת גישה למערכת הפיתוח ניתן לביצוע ישירות ע"י הקלקה על הלינק הבא info@arkom.co.il פעולות המועברות תחת סביבת טסט לא תחייבנה את הכרטיסים המועברים לצורך הבדיקות והפיתוח המערכת תבצע את מהלך העסקה המלא כולל קבלת אישורים אך לא תבצע כל חיוב או פעולה כספית כולל לא תפיסת אובליגו לכרטיס המועבר. על כן ניתן להשתמש בכרטיס אשראי אמיתי לצרכי בדיקות ללא כל חשש מחיוב ארקום ת.ד חדרה 3830 טלפון פקס עמוד 9 מתוך 22

10 MTS_TokenHandler - טיפול באסימונים (Tokens) שם הפרמטר TerminalNum Password OpCode Token PAN AltPAN סוג נומרי תיאור / הערות קוד הפעולה לפי המפורט להלן: 2 0 מחיקת אסימון (לפי מספר אסימון) יצירת אסימון חדש 2 החלף / עדכן מספר כרטיס אשראי 3 תשאל את השרת לסטטוס אסימונים 4 מחק את כל האסימונים מבסיס הנתונים 5 כווץ את טבלת האסימונים 6 מחיקת אסימון (לפי מספר כרטיס אשראי) 7 אחזור אסימון לפי מספר כרטיס האסימון שיוחזר ע"י המערכת ואשר ישמש כתחליף למספר כרטיס * מספר הכרטיס אשר האסימון המיועד ייצג בעת ביצוע פעולות מספר הכרטיס החלופי לפעולת עדכון מספר כרטיס 3 שים לב עקרונית השימוש באסימון מהווה תחליף שקוף לשימוש במספר כרטיס. בעת העברת עסקה לביצוע, מערכת הפועלת עם אסימונים תעביר בשדה המיועד למספר כרטיס את האסימון המייצג אותו. בעת העברת הפעולה לשרת הסליקה המערכת תבצע החלפת האסימון במספר הכרטיס השמור במערכת ובכך יימנע הצורך מאגירת מספרי כרטיסים במערכת המתממשקת ל MTS כל הפעולות באסימון כתחליף מייצג למספר כרטיס אשראי שקופות למערכת ומתבצעות באופן אוטומטי ברקע בעת העברת העסקה לשרת באמצעות ה Web Service שירות האסימונים הינו שירות נוסף והשימוש בו דורש הסכם שימוש נפרד מעבר להסכם השימוש ב MTS תחזוקת האסימונים נמצאת באחריותו המלאה של המשתמש ובאחריותו למחוק אסימונים שאינם בתוקף אסימון משמש בעיקרון לצורכי ביצוע הוראת קבע או העברת קבצי פעולות מרובות שורות. ניתן להעביר עסקה בודדת במקרה הצורך באותו אופן בו מועברת עסקה רגילה רק שכאמור במקום מספר הכרטיס יועבר האסימון לשם העברת חיובי הוראת קבע יש להעביר את הכרטיס אישור ולשמור את מספר האישור המתקבל, ואז יש לייצר עבורו אסימון ולשמור את נתוני האסימון ואת מספר האישור לשם שימוש חוזר בעת העברת קובץ לחיוב. קבלת האישור מתבצעת באמצעות הפונקציה MTS_PutTransactionRequest כאשר בפרמטר J יש להעביר את הקוד 5. ארקום ת.ד חדרה 3830 טלפון פקס עמוד 0 מתוך 22

11 הערה יצירת אסימון חדש ניתן לייצר את האסימון במערכת המארחת ולהעביר לשרת את האסימון לשימוש. במקרים מסויימים עשוי להיווצר מצב בו המערכת המקומית תעדיף לייצר את האסימונים בעצמה ולא להסתמך על האסימונים המיוצרים בשרת. במקרה כזה יש להעביר את האסימון המבוקש לשרת בשדה Token אם האסימון שהועבר יהיה בעל מבנה חוקי אזי השרת לא ייצר אסימון אלא ישתמש באסימון שסופק. העברת שדה Token טעון בערך אסימון חוקי תגרום כאמור לשרת להשתמש באסימון שסופק העברת השדה ריק או עם ערך לא חוקי לאסימון תגרום לשרת לייצר אסימון בעצמו ערך חוקי לאסימון הוא: חייב להתחיל בתוו ^ ולהכיל לפחות 20 תווים במקרה של ייצור אסימון עצמי כל האחריות תחול על המערכת המארחת לצורך החלפת / עדכון מספר כרטיס אשראי בבסיס הנתונים יש לספק את מספר הכרטיס הישן ואת מספר הכרטיס החדש. מיועד לאותם מקרים בהם מתקבל קובץ עדכון מאת חברות האשראי. במקרים אחרים יש למחוק אסימון וליצר חדש ואז אין כל צורך לשמור או לספק את מספר הכרטיס הישן. האסימון לא משתנה ובכך נשמרת השקיפות מבחינת השימוש באסימון. מיועד לקבלת מידע כמה אסימונים מוקצים, כמה בשימוש וכמה נותרו. הנתון חוזר בשדה המיועד לאסימון (Token) ובמבנה CSV מיועד כאמור להחלפת מספרי כרטיס, בכל מקרה אחר יש להעביר שדה ריק..2.3 ארקום ת.ד חדרה 3830 טלפון פקס עמוד מתוך 22

12 - MTS_GetTerminalDB טיפול בבסיס הנתונים קבלת עותק של בסיס הנתונים כפי שהוא בשרת תיאור / הערות סוג שם הפרמטר TerminalNum Password פרמטר המחזיר את הלינק להורדת בסיס הנתונים. הקובץ המועבר הוא במבנה ZIP עם סיסמא כפי שתועבר בממשק DownloadLink סיסמת הגישה לקובץ ה - ZIP מנדטורי ZipPassword מטרתה של פונקציה זו היא לאפשר קבלת עותק של בסיס הנתונים כפי שהוא מופיע בשרת. בסיס נתונים זה יכול לשמש למגוון מטרות בהתאם לצרכי ואיפיון המערכת המארחת. בסיס הנתונים המקבל הוא במבנה SQLite ומבנהו הפנימי מפורט בהמשך בסיס נתונים זה אינו מאחסן נתוני כרטיסי אשראי או כל נתון רגיש אחר השדה "מספר כרטיס" מכיל אך ורק את 4 הספרות האחרונות של הכרטיס ששימש לבצוע הפעולה לינק הגישה וההורדה המתקבל באמצעות הפונקציה מאפשר הורדה רגילה ע"י דפדפן או בפרוטוקול HTTP טיפול בבסיס הנתונים החזרת חיווי לשרת כי הקובץ נתקבל - MTS_TerminalDB_Ack תיאור / הערות סוג שם הפרמטר TerminalNum Password הלינק להורדת בסיס הנתונים כפי שנתקבל מהשרת DownloadLink פונקציה זו משמשת להחזרת חיווי לשרת כי הקובץ נתקבל בהצלחה וכי ניתן להסיר את הלינק ולמחוק את עותק הקובץ ממחיצת ההורדות בשרת ארקום ת.ד חדרה 3830 טלפון פקס עמוד 2 מתוך 22

13 מבנה הנתונים המוחזרים מהפונקציה MTS_GetTransactionResults בשדה Answer פונקצית ביצוע עיסקה מחזירה STRING המכיל את כל נתוני תוצאת העסקה. Fixed Length זה הינו רציף ומחולק עפ"י מיקום STRING שם השדה תווים מקום יחסי הערות 3 סטאטוס אם התקבל קוד "000" ניתן לוותר על בדיקת תיאור השגיאה 4 פילר תו ריק 5 מספר כרטיס 9 אפסים מובילים. 0 כרטיס פרטי של חברה מנפיקה (PL) 24 מותג סטרקארד מא 2 ויזה 3 מאסטרו ישראכרט 25 קוד חב' אשראי 2 ויזה כ.א.ל חברה סולקת 3 דיינרס 4 אמריקן אקספרס 6 לאומי קארד 26 3 קוד שרות 29 פרמטר J MMYY 30 תאריך תוקף 4 0 לא הוכנס 34 תשובת חב' הוכנס ותקין האשראי ת"ז 2 לא תקין 3 לא נבדק 0 לא הוכנס 35 תשובת חב' הוכנס ותקין האשראי CVV 2 לא תקין 3 לא נבדק 36 סכום באגורות מידע נוסף העברת מידע נוסף ע"י חברת האשראי בתוך תשובה לשאילתא. לדוגמא: יתרת האשראי של מחזיק הכרטיס. השדה הנו נומרי. 52 סכום בכוכבים 8 ישראכרט 60 קוד חב' אשראי ארקום ת.ד חדרה 3830 טלפון פקס עמוד 3 מתוך 22

14 2 ויזה כ.א.ל חברה מנפיקה 3 דיינרס 4 אמריקן אקספרס JCB 5 6 לאומי קארד 00 כרטיס חסום 6 2 סוג עסקה 0 עסקת חובה רגילה 02 עסקת חובה מאושרת 03 עסקה מאולצת 5 עסקת זכות 52 עסקת ביטול 53 עסקת זכות מאושרת 63 סוג אשראי תוצאת בדיקה של ערך UCAF/CAVV במהלך ביצוע בקשה 64 UCAF/CAVV לאישור. 65 סוג מטבע 66 2 קוד עסקה 68 קוד מועדון כפי שנקבע בין חברות האשראי ורשתות השיווק. 69 סיבת התקשרות "רווח" לא בוצעה התקשרות - אקראי - תקרה 2 - מספר סודי 3 - קוד שרות בפס מגנטי 4 - בקשה לאישור ללא עסקה 5 - חסום לא חד משמעי 6 Z.F.L (תקרת ( בקשה לאישור יזומה 8 מקור האישור - אושר ע"י שב"א 70 - אושר ע"י חברת האשראי 2 - אושר ע"י המענה הקולי 3 - עסקה ללא אישור 0 7 מספר אישור 7 78 סכום תשלום 8 ראשון 86 סכום תשלום 8 ארקום ת.ד חדרה 3830 טלפון פקס עמוד 4 מתוך 22

15 קבוע 94 מספר תשלומים 2 96 מספר קובץ מספר קופה מספר סודר 3 בקופה 04 שם כרטיס 5 כרטיס חו"ל 9 ציון לכרטיס חו"ל 20 פרמטר X שדה חופשי לא מועבר לחברת האשראי נתוני משתמש 9 CR/LF 39 2 סיומת הסכום המוחזר במבנה הנתונים הוא באגורות וללא סימן מינוס לעסקת זיכוי. לשם זיהוי האם העסקה היא עסקת זיכוי יש לבדוק את ערך השדה "סוג עסקה" השדות MerchantNote / ClientNote יכילו את שוברי העסקה בהתאמה במידה והעסקה הייתה עסקת חיוב או זיכוי שעברה בהצלחה. בכל סוג עסקה אחר או במקרה שהעסקה שנכשלה השדות יהיו ריקים. במידה ויש שובר הוא יהיה מוכן להדפסה (ניתן לשולחו ישירות למדפסת או לקובץ) ארקום ת.ד חדרה 3830 טלפון פקס עמוד 5 מתוך 22

16 יצירת עסקה במהלך יחיד - MTS_CC_Transaction תיאור / הערות סוג שם הפרמטר TerminalNum Password מזהה ייחודי לעסקה TransactionID מספר כרטיס אשראי / תוכן פס מגנטי CardNum תוקף כרטיס MMYY בעסקה עם פס מגנטי חובה להעביר ערך כלשהו, מומלץ 0000 CardExpiry סכום הפעולה (לזיכוי יש להעביר מספר שלילי) נומרי TransSum כוכבים/נקודות לשימוש כחלק מהסכום לחיוב נומרי TransPoints ארבע ספרות אחרונות במספר הכרטיס Last4Digits קוד אימות כרטיס (4 ספרות) CVV2 ת.ז. בעל הכרטיס (9 ספרות) ID קוד מטבע / עסקת תשלומים נומרי TransCurrency קידוד ISO של המטבע ILS) (USD, EUR, ISO_Currency קוד סוג אשראי נומרי CreditType קוד אישור מוקדם לעסקה כפי שנתקבל טלפונית ApprovalCode סכום תשלום ראשון בעסקת תשלומים נומרי FirstPayment סכום כל אחד משאר התשלומים נומרי FixedPayment מספר התשלומים נומרי NumOfFixedPayments אסמכתא פרטית שדה חופשי (פרמטר X) עד 9 תווים TransRef קוד סוג פעולה J נומרי J_Prm ערך פרמטר Z (רק למסופים עם אישור מחברת האשראי. באין אישור יועבר ריק) Z_Prm ערך פרמטר Q Q_Prm ערך פרמטר R R_Prm תוצאת העסקה מבנה הנתונים יפורט בהמשך Answer שובר העסקה חלק בית העסק (מוכן להדפסה) במידה והעסקה כשלה או לסוג העסקה אין פתקית יוחזר פרמטר ריק MerchantNote שובר העסקה לחתימת הלקוח (מוכן להדפסה) במידה והעסקה כשלה או לסוג העסקה אין פתקית יוחזר פרמטר ריק ClientNote להסברים ראה MTS_PutTransactionRequest וכן MTS_GetTransactionResults ארקום ת.ד חדרה 3830 טלפון פקס עמוד 6 מתוך 22

17 מבנה הנתונים בבסיס הנתונים פורמט SQLite בסיס הנתונים מכיל טבלה אחת בשם Transactions מבנה הנתונים הוא כמפורט להלן: TransID Status CardNum Brand Acquirer ServiceCode J_Prm CardExpiry IDresponse CVVresponse TransSUM ExtraInfo TransPoints Issuer TransType CreditType UCAF_CAVV CurrencyType TransCode ClubCode CallReason ApprovalSource ApprovalCode FirstPayment FixedPayment NumOfPayments SlipNum CardName TouristCard TransRef TransDate SettlementRef INTEGER FLOAT FLOAT FLOAT FLOAT INTEGER INTEGER DATE ארקום ת.ד חדרה 3830 טלפון פקס עמוד 7 מתוך 22

18 נספח הודעות שגיאה ארקום ת.ד חדרה 3830 טלפון פקס עמוד 8 מתוך עסקה תקינה - 00 חסום גנוב התקשר לחברת האשראי סירוב מזויף ת.ז.או CVV שגויים ECI או UCAF/CAVV שגויים תקלה בבניית מפתח גישה לקובץ חסומים לא הצליח להתקשר,התקשר לחברת האשראי - 00 תוכנית הופסקה עפ"י הוראת המפעיל (ESC) או COM PORT לא ניתן לפתיחה (WINDOWS) - 05 אין התאמה בין המספר שהוקלד לפס המגנטי - 06 נתונים נוספים אינם או ישנם בניגוד להגדרות המסוף - 07 לא הוקלדו 4 ספרות האחרונות - 09 רשומה בקובץ INT_IN קצרה מ 6 תווים קובץ קלט (IN_INT) לא קיים - 02 קובץ חסומים (NEG) לא קיים או לא מעודכן - בצע שידור או בקשה לאישור עבור כל עסקה אחד מקבצי פרמטרים או ווקטורים לא קיים קובץ תאריכים (DATA) לא קיים קובץ אתחול (START) לא קיים הפרש בימים בקליטת חסומים גדול מדי - בצע שידור או בקשה לאישור עבור כל עסקה הפרש דורות בקליטת חסומים גדול מידי - בצע שידור או בקשה לאישור עבור כל עסקה כאשר לא הוכנס פס מגנטי כולו הגדר עסקה כעסקה טלפונית או כעסקת חתימה בלבד מספר מסוף מרכזי לא הוכנס למסוף המוגדר לעבודה כרב ספק מספר מוטב לא הוכנס למסוף המוגדר לעבודה כרב מוטב מסוף שאינו מעודכן כרב ספק/רב מוטב והוקלד מס' ספק/מס' מוטב - 03 מסוף מעודכן כרב ספק והוקלד גם מס' מוטב תנועות ישנות בצע שידור או בקשה לאישור עבור כל עסקה כרטיס לא תקין כרטיס לא רשאי לבצע במסוף זה או אין אישור לעסקה כזאת כרטיס לא רשאי לבצע עסקה עם סוג אשראי זה פג תוקף שגיאה בתשלומים - סכום עסקה צריך להיות שווה תשלום ראשון + (תשלום קבוע כפול מס' תשלומים) לא ניתן לבצע עסקה מעל תקרה לכרטיס לאשראי חיוב מיידי סיפרת בקורת לא תקינה מסוף שמוגדר כרב מוטב הוקלד מס' ספק - 04 מעל תקרה, אך קובץ הקלט מכיל הוראה לא לבצע שאילתא (J,J2,J3) חסום בספק, אך קובץ הקלט מכיל הוראה לא לבצע שאילתא (J,J2,J3) אקראית, אך קובץ הקלט מכיל הוראה לא לבצע שאילתא (J,J2,J3) מסוף לא רשאי לבקש אישור ללא עסקה, אך קובץ הקלט מכיל (J5) מסוף לא רשאי לבקש אישור ביוזמתו, אך קובץ הקלט מכיל (J6) יש לבקש אישור, אך קובץ הקלט מכיל הוראה לא לבצע שאילתא (J,J2,J3) יש לבקש אישור בשל בעיה הקשורה לקכ"ח אך קובץ הקלט מכיל הוראה לא לבצע שאילתא - 05 מספר רכב לא תקין מד מרחק לא הוקלד מסוף לא מוגדר כתחנת דלק. (הועבר כרטיס דלק או קוד עסקה לא מתאים) לא הוקלד מספר תעודת זהות לא הוקלד CVV2-059 לא הוקלדו מספר תעודת הזהות וה- CVV2-060 צרוף ABS לא נמצא בהתחלת נתוני קלט בזיכרון - 06 מספר כרטיס לא נמצא או נמצא פעמיים סוג עסקה לא תקין קוד עסקה לא תקין סוג אשראי לא תקין

19 של ויזה) מטבע לא תקין קיים תשלום ראשון ו/או תשלום קבוע לסוג אשראי שונה מתשלומים קיים מספר תשלומים לסוג אשראי שאינו דורש זה לא ניתן להצמיד לדולר או למדד לסוג אשראי שונה מתשלומים אורך הפס המגנטי קצר מידי לא מוגדר מכשיר להקשת מספר סודי - 07 חובה להקליד מספר סודי קכ"ח לא זמין - העבר בקורא מגנטי הכרטיס נושא שבב ויש להעבירו דרך הקכ"ח דחייה -כרטיס נעול דחייה -פעולה עם קכ"ח לא הסתיימה בזמן הראוי דחייה -נתונים אשר התקבלו מקכ"ח אינם מוגדרים במערכת הוקש מספר סודי שגוי הוכנס "קוד מועדון" לסוג אשראי לא מתאים לא מצליח לקרוא/ לכתוב/ לפתוח קובץ TRAN - 0 אין אישור מחברת אשראי לעבודה - 06 למסוף אין אישור לביצוע שאילתא לאשראי חיוב מיידי - 07 סכום העסקה גדול מידי - חלק למספר עסקאות - 08 למסוף אין אישור לבצע עסקאות מאולצות - 09 למסוף אין אישור לכרטיס עם קוד השרות למסוף אין אישור לכרטיס חיוב מיידי - למסוף אין אישור לעסקה בתשלומים - 2 למסוף אין אישור לעסקה טלפון/חתימה בלבד בתשלומים - 3 למסוף אין אישור לעסקה טלפונית - 4 למסוף אין אישור לעסקה "חתימה בלבד" - 5 למסוף אין אישור לעסקה בדולרים - 6 למסוף אין אישור לעסקת מועדון - 7 למסוף אין אישור לעסקת כוכבים/נקודות/מיילים - 8 למסוף אין אישור לאשראי ישראקרדיט - 9 למסוף אין אישור לאשראי אמקס קרדיט - 20 למסוף אין אישור להצמדה לדולר - 2 למסוף אין אישור להצמדה למדד - 22 למסוף אין אישור להצמדה למדד לכרטיסי חו"ל - 23 למסוף אין אישור לעסקת כוכבים/נקודות/מיילים לסוג אשראי זה - 24 למסוף אין אישור לאשראי קרדיט בתשלומים לכרטיסי ישראכרט - 25 למסוף איו אישור לאשראי קרדיט בתשלומים לכרטיסי אמקס - 26 למסוף אין אישור לקוד מועדון זה - 27 למסוף אין אישור לעסקת חיוב מיידי פרט לכרטיסי חיוב מיידי - 28 למסוף אין אישור לקבל כרטיסי ויזה אשר מתחילים ב למסוף אין אישור לבצע עסקת זכות מעל תקרה - 30 כרטיס לא רשאי לבצע עסקת מועדון - 3 כרטיס לא רשאי לבצע עסקת כוכבים/נקודות/מיילים - 32 כרטיס לא רשאי לבצע עסקאות בדולרים (רגילות או טלפוניות) - 33 כרטיס לא תקף על פי רשימת כרטיסים תקפים של ישראכרט - 34 כרטיס לא תקין עפ"י הגדרת המערכת VECTOR) של ישראכרט) - מס' הספרות בכרטיס שגוי - 35 כרטיס לא רשאי לבצע עסקאות דולריות עפ"י הגדרת המערכת VECTOR) של ישראכרט) - 36 הכרטיס שייך לקבוצת כרטיסים אשר אינה רשאית לבצע עסקאות עפ"י הגדרת המערכת VECTOR20) - 37 קידומת הכרטיס (7 ספרות) לא תקפה עפ"י הגדרת המערכת VECTOR2) של דיינרס) - 38 כרטיס לא רשאי לבצע עסקאות בתשלומים על פי רשימת כרטיסים תקפים של ישראכרט - 39 מספר תשלומים גדול מידי על פי רשימת כרטיסים תקפים של ישראכרט - 40 כרטיסי ויזה ודיינרס לא רשאים לבצע עסקאות מועדון בתשלומים - 4 סידרת כרטיסים לא תקפה עפ"י הגדרת המערכת. VECTOR5) של ישראכרט) - 42 קוד שרות לא תקף עפ"י הגדרת המערכת VECTOR6) של ישראכרט) - 43 קידומת הכרטיס (2 ספרות) לא תקפה עפ"י הגדרת המערכת. VECTOR7) של ישראכרט) - 44 קוד שרות לא תקף עפ"י הגדרת המערכת. VECTOR2) של ויזה) - 45 קוד שרות לא תקף עפ"י הגדרת המערכת. VECTOR3) של ויזה) ארקום ת.ד חדרה 3830 טלפון פקס עמוד 9 מתוך 22

20 - 46 לכרטיס חיוב מיידי אסור לבצע עסקת זכות - 47 כרטיס לא רשאי לבצע עסקאות בתשלומים עפ"י וקטור 3 של לאומיקארד - 48 כרטיס לא רשאי לבצע עסקאות טלפוניות וחתימה בלבד עפ"י ווקטור 3 של לאומיקארד - 49 כרטיס אינו רשאי לבצע עסקאות טלפוניות עפ"י וקטור 3 של לאומיקארד - 50 אשראי לא מאושר לכרטיסי חיוב מיידי - 5 אשראי לא מאושר לכרטיסי חו"ל - 52 קוד מועדון לא תקין - 53 כרטיס לא רשאי לבצע עסקאות אשראי גמיש (עדיף +30/) עפ"י הגדרת המערכת. VECTOR2) של דיינרס) - 54 כרטיס לא רשאי לבצע עסקאות חיוב מיידי עפ"י הגדרת המערכת. VECTOR2) של דיינרס) - 55 סכום המינימלי לתשלום בעסקת קרדיט קטן מידי - 56 מספר תשלומים לעסקת קרדיט לא תקין - 57 תקרה 0 לסוג כרטיס זה בעסקה עם אשראי רגיל או קרדיט - 58 תקרה 0 לסוג כרטיס זה בעסקה עם אשראי חיוב מיידי - 59 תקרה 0 לסוג כרטיס זה בעסקת חיוב מיידי בדולרים - 60 תקרה 0 לסוג כרטיס זה בעסקה טלפונית - 6 תקרה 0 לסוג כרטיס זה בעסקת זכות - 62 תקרה 0 לסוג כרטיס זה בעסקת תשלומים - 63 כרטיס אמריקן אקספרס אשר הונפק בחו"ל לא רשאי לבצע עסקאות בתשלומים - 64 כרטיסיJCB רשאי לבצע עסקאות רק באשראי רגיל - 65 סכום בכוכבים/נקודות/מיילים גדול מסכום העסקה - 66 כרטיס מועדון לא בתחום של המסוף - 67 לא ניתן לבצע עסקת כוכבים/נקודות/מיילים בדולרים - 68 למסוף אין אישור לעסקה דולרית עם סוג אשראי זה - 69 לא ניתן לבצע עסקת זכות עם אשראי שונה מהרגיל - 70 סכום הנחה בכוכבים/נקודות/מיילים גדול מהמותר - 7 לא ניתן לבצע עסקה מאולצת לכרטיס/אשראי חיוב מיידי - 72 לא ניתן לבטל עסקה קודמת (עסקת זכות או מספר כרטיס אינו זהה) - 73 עסקה כפולה - 74 למסוף אין אישור להצמדה למדד לאשראי זה - 75 למסוף אין אישור להצמדה לדולר לאשראי זה - 76 כרטיס אינו תקף עפ"י הגדרת ה מערכת (וקטור של ישראכרט) - 77 בתחנות דלק לא ניתן לבצע "שרות עצמי" אלא "שרות עצמי בתחנות דלק" - 78 אסור לבצע עסקת זכות בכוכבים/נקודות/מיילים - 79 אסור לבצע עסקת זכות בדולר בכרטיס תייר - 80 בכרטיס מועדון לא ניתן לבצע עסקה טלפונית שגיאה יישומית ארקום ת.ד חדרה 3830 טלפון פקס עמוד 20 מתוך 22

21 שגיאה בהעברת נתונים 90 לא נמצאה תוצאת עסקה, נסה שוב מאוחר יותר 902 שגיאה כללית במשלוח שוברי עסקה 903 שגיאה במשלוח שובר עסקה עותק בית העסק 904 שגיאה במשלוח שובר עסקה עותק לקוח 905 שגיאה במשלוח נתוני רישום 906 שגיאת פיענוח או עיבוד נתונים 9 מסוף לא פעיל 92 מסוף אינו רשאי להפעיל אסימונים 93 שגיאה לא מוגדרת בתפעול אסימונים 94 המסוף ניצל את כל מיכסת האסימונים המוקצבת לו 95 מספר השורות בקובץ גדול מ 9999, נא לפצל לקבצים קטנים יותר 96 בעיה בפיענוח קובץ חיובים מרובה שורות 97 לא נמצא בסיס נתונים להעברה 98 כישלון ביצירת בסיס נתונים מכווץ להעברה 99 שגיאה בטיפול בחיווי גמר פעילות עם בסיס נתונים 920 המסוף אינו רשאי לבצע פעולה זו 92 אסימון או כרטיס לא קיים 922 אסימון או כרטיס כבר קיים 923 שגיאה פנימית בתהליך רישום סטטוס פעולה (WS) 998 שרת או שירות אינו זמין 999 ארקום ת.ד חדרה 3830 טלפון פקס עמוד 2 מתוך 22

22 נספח עבודה במט"ח בעת העברת עסקה לביצוע בשרת יש לשים לב לשימוש נכון בשדה המטבע. העבודה מתבססת על העברת מאפיין המטבע בשדה TransCurrency עפ"י המפרט הבא: 0 המטבע יהיה מטבע עפ"י תקן ISO-427 שקל 2 דולר ארה"ב (USD) 4 עסקת תשלומים צמודים לדולר 8 עסקת תשלומים צמודים למדד במידה והעסקה הינה עסקת תשלומים לא ניתן עפ"י הגדרתה לבצעה במטבע אחר זולת שקל ומכאן שהשימוש בשדה המאפיין את המטבע TransCurrency משמש בתפקיד כפול קביעת אופי התשלומים או סוג המטבע במידה וסומן קוד מטבע ISO אזי המערכת תבדוק את קוד המטבע בשדה ISO_CURRENCY עפ"י המפרט הבא: AUD 036 Australian dollar CAD 24 Canadian dollar DKK 208 Danish kroner HKD 344 Hong Kong dollar INR 356 Indian rupee JPY 392 Japanese yen JOD 400 Jordanian dinar NOK 578 Norwegian kroner SGD 702 Singapore dollar ZAR 70 South African rand SEK 752 Swedish kroner CHF 756 Swiss franc EGP 88 Egyptian pound GBP 826 Pound sterling TRY 949 Turkish lira EUR 978 Euro יש לשים לב כי דולר ארה"ב אינו מועבר כמטבע ISO אלא ברמת השדה המאפיין TransCurrency העברת קוד המטבע לפונקציה תהיה עפ"י קוד מטבע ISO כגון CAD AUD וכו' ארקום ת.ד חדרה 3830 טלפון פקס עמוד 22 מתוך 22