תיעוד ממשק סליקה WebService

‫ארקום‬
‫מערכות ממוחשבות בע"מ‬
‫‪10/07/2011‬‬
‫תיעוד ממשק ‪MTS WebService‬‬
‫ממשק ה ‪ Web Service‬מיועד לשימוש מול שרתי הסליקה ממשפחת ‪ MTS‬מבית ארקום‪.‬‬
‫ממשק זה מאפשר למפתחים להתממשק לשרתי הסליקה ללא כל צורך בביצוע הטמעות‪ ,‬פענוח או פעולות‬
‫כלשהן הקשורות במערכת סליקת כרטיסי אשראי בעצמם‪.‬‬
‫על המפתח ליצור ממשק משתמש לקליטת נתוני העסקה ולהעבירם באמצעות ה ‪ Web Service‬לסליקה‪.‬‬
‫ניתן לקבל תכנית הדגמה בסביבת ‪ VB.NET 2010‬המתארת ומדגימה את אופני הקריאה והשימוש בממשק‪.‬‬
‫הממשק פועל במלואו תחת הצפנת ‪SSL‬‬
‫כתובת ה ‪ URL‬להפעלה חיה בלבד היא‬
‫‪https://secure.arkom.co.il/wsmts/MTS_WebService.asmx‬‬
‫כתובת ה ‪ URL‬לצרכי פיתוח‪ ,‬בדיקות וטסטים היא‬
‫‪https://secure.arkom.co.il/wsdev/MTS_WebService.asmx‬‬
‫שים לב‪:‬‬
‫שמות הפרמטרים המועברים לפונקציות הינם ‪case sensitive‬‬
‫למשתמשים בהעברת נתונים שלא אמצעות הפונקציות מומלץ לבדוק מול פריסת הממשק ב ‪URL‬‬
‫ארקום מערכות ממוחשבות בע"מ ת‪.‬ד‪ 3002 .‬חדרה ‪ 38130‬טלפון ‪ 04-6222830 072-2753000‬פקס ‪www.arkom.co.il 04-6222840‬‬
‫מסמך זה הינו רכוש ארקום‪ .‬המידע הכלול במסמך זה הינו מידע פנימי‪ .‬העתקה‪ ,‬הפצה ו‪/‬או כל שימוש אחר במסמך או חלקים ממנו‪ ,‬אסורים לחלוטין‪.‬‬
‫עמוד ‪ 1‬מתוך ‪22‬‬
‫ארקום‬
‫מערכות ממוחשבות בע"מ‬
‫‪10/07/2011‬‬
‫הפונקציות החשופות בממשק‪:‬‬
‫•‬
‫‪ - MTS_Ping‬משמשת לקבלת חיווי לזמינות ופעילות השרת‬
‫•‬
‫‪ - MTS_GetTransactionID‬משמשת לקבלת מזהה עסקה‬
‫•‬
‫‪ - MTS_PutTransactionRequest‬משמשת להעברת עסקה לבצוע בשרת‬
‫•‬
‫‪ - MTS_GetTransactionResults‬משמשת לקבלת תוצאות עסקה מהשרת‬
‫•‬
‫‪ - MTS_SendNotes‬משמשת לשליחת שוברי עסקה לבית העסק וללקוח‬
‫•‬
‫‪ - MTS_PutTransactionAcknowledge‬משמשת להעברת אישור לשרת לסגירת מהלך העסקה‬
‫•‬
‫‪ - MTS_GetErrorDescription‬משמשת לקבלת תיאור שגיאה שנתקבלה כתוצאה מביצוע עסקה‬
‫•‬
‫‪ - MTS_PutMultiTransactionRequest‬משמשת להעברת קובץ עסקאות )הוראות קבע(‬
‫•‬
‫‪ - MTS_GetMultiTransactionResults‬משמשת לקבלת קובץ תוצאות )הוראות קבע(‬
‫•‬
‫‪ - MTS_TokenHandler‬משמשת לניהול אסימונים )‪(Tokens‬‬
‫•‬
‫‪ - MTS_GetTerminalDB‬משמשת לקבלת בסיס הנתונים מהשרת‬
‫•‬
‫‪ - MTS_TerminalDB_Ack‬משמשת לעדכון השרת כי בסיס הנתונים התקבל ולמחיקת הלינק‬
‫•‬
‫‪ - MTS_CC_Transaction‬משמשת לביצוע פעולת חיוב במהלך יחיד )נא ראה הסבר בהמשך(‬
‫כל הפונקציות מחזירות ערך נומרי – ‪) 0‬אפס( בהצלחה או קוד שגיאה רלוונטי המתאים למהות השגיאה‬
‫פונקציות האמורות להחזיר ערכים נוספים עושות זאת בדריכת הפרמטר המתאים שהועבר אליהן בקריאה‬
‫ארקום מערכות ממוחשבות בע"מ ת‪.‬ד‪ 3002 .‬חדרה ‪ 38130‬טלפון ‪ 04-6222830 072-2753000‬פקס ‪www.arkom.co.il 04-6222840‬‬
‫מסמך זה הינו רכוש ארקום‪ .‬המידע הכלול במסמך זה הינו מידע פנימי‪ .‬העתקה‪ ,‬הפצה ו‪/‬או כל שימוש אחר במסמך או חלקים ממנו‪ ,‬אסורים לחלוטין‪.‬‬
‫עמוד ‪ 2‬מתוך ‪22‬‬
‫ארקום‬
‫מערכות ממוחשבות בע"מ‬
‫‪10/07/2011‬‬
‫מהלך נכון של פעילות מול ממשק הסליקה‬
‫‪ .1‬פנה לשרת לקבלת מזהה עסקה ייחודי ‪MTS_GetTransactionID -‬‬
‫‪ .2‬העבר לשרת את נתוני העסקה ‪MTS_PutTransactionRequest -‬‬
‫‪ .3‬פנה לשרת בבקשה לקבלת תוצאות העסקה ‪MTS_GetTransactionResults -‬‬
‫‪ .4‬פנה לשרת לקבלת תיאור קוד הסטאטוס שהוחזר בתשובה ‪MTS_GetErrorDescription -‬‬
‫‪ .5‬במידת הצורך העברת נתוני שוברים לשליחה ללקוח ולבית העסק‬
‫‪ .6‬העבר חיווי לשרת לסגירת מהלך העסקה ‪MTS_PutTransactionAcknowledge -‬‬
‫או לחילופין בפעולה במהלך יחיד באמצעות ‪MTS_CC_Transaction‬‬
‫הערות‪:‬‬
‫•‬
‫ללא מזהה עסקה ייחודי לא ניתן לאחזר תוצאות עסקאות – שמור את מזהה העסקה‬
‫•‬
‫במידה וחלה תקלה או ניתוק תקשורת תמיד ניתן לפנות עם מזהה עסקה ולאחזר את תוצאת העסקה‬
‫אשר תמתין בשרת עד לקבלת חיווי סגירת מהלך עסקה‬
‫•‬
‫את פעולת הבקשה לקבלת תוצאת עסקה ניתן להפעיל ללא קשר למהלך העברת העסקה‬
‫יש לקחת בחשבון כי בעת הפניה העסקה לא נסתיימה ולכן תתקבל הודעה כי לא נמצאה תוצאת עסקה‬
‫)קוד ‪ .(902‬במקרה כזה יש לפנות שוב ולבקש את תוצאות העסקה‪ .‬את הפניות יש להפעיל בלולאה עד‬
‫אשר מתקבל קוד חוזר ‪) 0‬יש תוצאה(‪ .‬יש לאפשר פסק זמן של לפחות שנייה בין פניה לפניה‪.‬‬
‫•‬
‫השימוש בפונקציה ‪ MTS_CC_Transaction‬מחייב שימוש במזהה ייחודי אשר מועבר לשרת‪ ,‬מזהה‬
‫ייחודי זה נועד בעיקר על מנת לאפשר במקרה של תקלה לחזור למערכת ולאחזר את תוצאות העסקה‪.‬‬
‫‪ o‬האחריות על ייחודיות המזהה‪ ,‬ייצורו ואספקתו לשרת חלה במלואה על המפתח‪.‬‬
‫‪ o‬ניתן כמובן להשתמש בפונקציה המייצרת מזהה ייחודי המסופקת בממשק‪.‬‬
‫ארקום מערכות ממוחשבות בע"מ ת‪.‬ד‪ 3002 .‬חדרה ‪ 38130‬טלפון ‪ 04-6222830 072-2753000‬פקס ‪www.arkom.co.il 04-6222840‬‬
‫מסמך זה הינו רכוש ארקום‪ .‬המידע הכלול במסמך זה הינו מידע פנימי‪ .‬העתקה‪ ,‬הפצה ו‪/‬או כל שימוש אחר במסמך או חלקים ממנו‪ ,‬אסורים לחלוטין‪.‬‬
‫עמוד ‪ 3‬מתוך ‪22‬‬
‫ארקום‬
‫מערכות ממוחשבות בע"מ‬
‫‪10/07/2011‬‬
‫פרמטרים המועברים לפונקציות‬
‫פרמטר המסומן באדום מצביע על פרמטר המועבר ‪ By Reference‬ומשמש להחזרת נתונים מהפונקציה‬
‫קבלת חיווי זמינות מהשרת ‪MTS_Ping -‬‬
‫שם הפרמטר‬
‫סוג‬
‫תיאור ‪ /‬הערות‬
‫‪TerminalNum‬‬
‫אלפא‬
‫מספר מסוף לבצוע הפעולה כפי שנקבע ע"י ארקום‬
‫‪Password‬‬
‫אלפא‬
‫סיסמת גישה כפי שנקבעה למסוף ע"י ארקום‬
‫קבלת מזהה עסקה ייחודי ‪MTS_GetTransactionID -‬‬
‫שם הפרמטר‬
‫סוג‬
‫תיאור ‪ /‬הערות‬
‫‪TerminalNum‬‬
‫אלפא‬
‫מספר מסוף לבצוע הפעולה כפי שנקבע ע"י ארקום‬
‫‪Password‬‬
‫אלפא‬
‫סיסמת גישה כפי שנקבעה למסוף ע"י ארקום‬
‫‪TransactionID‬‬
‫אלפא‬
‫מזהה ייחודי לעסקה‬
‫קבלת תוצאות עסקה ‪MTS_GetTransactionResults -‬‬
‫שם הפרמטר‬
‫סוג‬
‫תיאור ‪ /‬הערות‬
‫‪TerminalNum‬‬
‫אלפא‬
‫מספר מסוף לבצוע הפעולה כפי שנקבע ע"י ארקום‬
‫‪Password‬‬
‫אלפא‬
‫סיסמת גישה כפי שנקבעה למסוף ע"י ארקום‬
‫‪TransactionID‬‬
‫אלפא‬
‫מזהה ייחודי לעסקה כפי שנתקבל מהשרת‬
‫‪Answer‬‬
‫אלפא‬
‫תוצאת העסקה – מבנה הנתונים יפורט בהמשך‬
‫‪MerchantNote‬‬
‫אלפא‬
‫שובר העסקה – חלק בית העסק )מוכן להדפסה(‬
‫‪ClientNote‬‬
‫אלפא‬
‫במידה והעסקה כשלה או לסוג העסקה אין פתקית יוחזר פרמטר ריק‬
‫שובר העסקה לחתימת הלקוח )מוכן להדפסה(‬
‫במידה והעסקה כשלה או לסוג העסקה אין פתקית יוחזר פרמטר ריק‬
‫ארקום מערכות ממוחשבות בע"מ ת‪.‬ד‪ 3002 .‬חדרה ‪ 38130‬טלפון ‪ 04-6222830 072-2753000‬פקס ‪www.arkom.co.il 04-6222840‬‬
‫מסמך זה הינו רכוש ארקום‪ .‬המידע הכלול במסמך זה הינו מידע פנימי‪ .‬העתקה‪ ,‬הפצה ו‪/‬או כל שימוש אחר במסמך או חלקים ממנו‪ ,‬אסורים לחלוטין‪.‬‬
‫עמוד ‪ 4‬מתוך ‪22‬‬
‫ארקום‬
‫מערכות ממוחשבות בע"מ‬
‫‪10/07/2011‬‬
‫קבלת תיאור לקוד שגיאה ‪MTS_GetErrorDescription -‬‬
‫שם הפרמטר‬
‫סוג‬
‫תיאור ‪ /‬הערות‬
‫‪TerminalNum‬‬
‫אלפא‬
‫מספר מסוף לבצוע הפעולה כפי שנקבע ע"י ארקום‬
‫‪Password‬‬
‫אלפא‬
‫סיסמת גישה כפי שנקבעה למסוף ע"י ארקום‬
‫‪TransactionID‬‬
‫אלפא‬
‫מזהה ייחודי לעסקה כפי שנתקבל מהשרת‬
‫‪ErrorCode‬‬
‫אלפא‬
‫קוד השגיאה כפי שהתקבל מהשרת‬
‫‪ErrorDesc‬‬
‫אלפא‬
‫תיאור השגיאה בעברית‬
‫העברת אישור לשרת על סגירת מהלך העסקה ‪MTS_PutTransactionAcknowledge -‬‬
‫שם הפרמטר‬
‫סוג‬
‫תיאור ‪ /‬הערות‬
‫‪TerminalNum‬‬
‫אלפא‬
‫מספר מסוף לבצוע הפעולה כפי שנקבע ע"י ארקום‬
‫‪Password‬‬
‫אלפא‬
‫סיסמת גישה כפי שנקבעה למסוף ע"י ארקום‬
‫‪TransactionID‬‬
‫אלפא‬
‫מזהה ייחודי לעסקה כפי שנתקבל מהשרת‬
‫ארקום מערכות ממוחשבות בע"מ ת‪.‬ד‪ 3002 .‬חדרה ‪ 38130‬טלפון ‪ 04-6222830 072-2753000‬פקס ‪www.arkom.co.il 04-6222840‬‬
‫מסמך זה הינו רכוש ארקום‪ .‬המידע הכלול במסמך זה הינו מידע פנימי‪ .‬העתקה‪ ,‬הפצה ו‪/‬או כל שימוש אחר במסמך או חלקים ממנו‪ ,‬אסורים לחלוטין‪.‬‬
‫עמוד ‪ 5‬מתוך ‪22‬‬
‫ארקום‬
‫מערכות ממוחשבות בע"מ‬
‫‪10/07/2011‬‬
‫העברת קובץ לחיובי הוראות קבע ‪MTS_PutMultiTransactionRequest -‬‬
‫שם הפרמטר‬
‫סוג‬
‫תיאור ‪ /‬הערות‬
‫‪TerminalNum‬‬
‫אלפא‬
‫מספר מסוף לבצוע הפעולה כפי שנקבע ע"י ארקום‬
‫‪Password‬‬
‫אלפא‬
‫סיסמת גישה כפי שנקבעה למסוף ע"י ארקום‬
‫‪TransactionID‬‬
‫אלפא‬
‫מזהה ייחודי לעסקה כפי שנתקבל מהשרת‬
‫‪RequestBuffer‬‬
‫אלפא‬
‫קובץ חיובים במבנה של שורות טקסט )‪ (CSV‬ובסוף כל שורה ‪CR/LF‬‬
‫•‬
‫בחיובי הוראות קבע לא מוחזרים שוברי עסקה לחתימת הלקוח‬
‫מבנה רשומה להוראות קבע‬
‫‪4580000000000000,1212,10.11,1234567,PrivRef1‬‬
‫‪Card Number (PAN) or Token‬‬
‫)‪Card Expiry (MMYY‬‬
‫‪Transaction Amount‬‬
‫)‪Pre-Approval Code (as received from the J5 operation‬‬
‫)‪Private Reference (X Parameter MAX 19 Chars‬‬
‫כל השדות הם מנדטוריים‪ .‬ניתן להעביר ערך ריק לשדה אך חובה לשמר את מבנה השורה‪.‬‬
‫בדוגמא הבאה מועברת שורה ללא אסמכתא פרטית אך הפסיק בסוף השורה ממשיך להופיע‪.‬‬
‫‪4580000000000000,1212,10.11,1234567,‬‬
‫הערה‪:‬‬
‫ניתן להעביר את קובץ החיובים במבנה ‪ Int_IN‬רגיל של שב"א במקום במבנה זה‪.‬‬
‫המערכת תזהה אוטומטית את המבנים ותפעל עליהם כנדרש באופן שקוף לחלוטין‬
‫התשובות המוחזרות לא מושפעות ממבנה הנתונים המועברים בקובץ החיובים‬
‫ארקום מערכות ממוחשבות בע"מ ת‪.‬ד‪ 3002 .‬חדרה ‪ 38130‬טלפון ‪ 04-6222830 072-2753000‬פקס ‪www.arkom.co.il 04-6222840‬‬
‫מסמך זה הינו רכוש ארקום‪ .‬המידע הכלול במסמך זה הינו מידע פנימי‪ .‬העתקה‪ ,‬הפצה ו‪/‬או כל שימוש אחר במסמך או חלקים ממנו‪ ,‬אסורים לחלוטין‪.‬‬
‫עמוד ‪ 6‬מתוך ‪22‬‬
‫ארקום‬
‫מערכות ממוחשבות בע"מ‬
‫‪10/07/2011‬‬
‫קבלת תוצאות לקובץ הוראות קבע ‪MTS_GetMultiTransactionResults -‬‬
‫שם הפרמטר‬
‫סוג‬
‫תיאור ‪ /‬הערות‬
‫‪TerminalNum‬‬
‫אלפא‬
‫מספר מסוף לבצוע הפעולה כפי שנקבע ע"י ארקום‬
‫‪Password‬‬
‫אלפא‬
‫סיסמת גישה כפי שנקבעה למסוף ע"י ארקום‬
‫‪TransactionID‬‬
‫אלפא‬
‫מזהה ייחודי לעסקה כפי שנתקבל מהשרת‬
‫‪Answer‬‬
‫אלפא‬
‫קובץ תוצאות – השורות במבנה התשובה כמפורט בהמשך‬
‫שליחת שוברי עסקה – ‪MTS_SendNotes‬‬
‫שם הפרמטר‬
‫סוג‬
‫תיאור ‪ /‬הערות‬
‫‪TerminalNum‬‬
‫אלפא‬
‫מספר מסוף לבצוע הפעולה כפי שנקבע ע"י ארקום‬
‫‪Password‬‬
‫אלפא‬
‫סיסמת גישה כפי שנקבעה למסוף ע"י ארקום‬
‫‪TransactionID‬‬
‫אלפא‬
‫מזהה ייחודי לעסקה כפי שנתקבל מהשרת‬
‫‪MerchantNote‬‬
‫אלפא‬
‫שובר עסקה )עותק בית העסק( כפי שהועבר ע"י השרת‬
‫‪ClientNote‬‬
‫אלפא‬
‫שובר עסקה )עותק לקוח( כפי שהועבר ע"י השרת‬
‫‪ClientEmail‬‬
‫אלפא‬
‫כתובת דוא"ל של הלקוח‬
‫הערות‪:‬‬
‫•‬
‫שובר בית העסק יישלח לכתובת הדוא"ל הרשומה במערכת ואליה נשלחים גם דו"חות השידור‬
‫•‬
‫ניתן להעביר רק שובר לקוח או רק שובר בית עסק‪ ,‬שובר ריק לא יישלח‬
‫•‬
‫השוברים אשר יישלחו יהיו במבנה ‪ JPG‬למניעת אפשרות שינויים או עריכה וכן לצפייה נוחה‬
‫ארקום מערכות ממוחשבות בע"מ ת‪.‬ד‪ 3002 .‬חדרה ‪ 38130‬טלפון ‪ 04-6222830 072-2753000‬פקס ‪www.arkom.co.il 04-6222840‬‬
‫מסמך זה הינו רכוש ארקום‪ .‬המידע הכלול במסמך זה הינו מידע פנימי‪ .‬העתקה‪ ,‬הפצה ו‪/‬או כל שימוש אחר במסמך או חלקים ממנו‪ ,‬אסורים לחלוטין‪.‬‬
‫עמוד ‪ 7‬מתוך ‪22‬‬
‫ארקום‬
‫מערכות ממוחשבות בע"מ‬
‫‪10/07/2011‬‬
‫יצירת עסקה ‪MTS_PutTransactionRequest -‬‬
‫שם הפרמטר‬
‫סוג‬
‫תיאור ‪ /‬הערות‬
‫‪TerminalNum‬‬
‫אלפא‬
‫מספר מסוף לבצוע הפעולה כפי שנקבע ע"י ארקום‬
‫‪Password‬‬
‫אלפא‬
‫סיסמת גישה כפי שנקבעה למסוף ע"י ארקום‬
‫‪TransactionID‬‬
‫אלפא‬
‫מזהה ייחודי לעסקה כפי שנתקבל מהשרת‬
‫‪CardNum‬‬
‫אלפא‬
‫מספר כרטיס אשראי ‪ /‬תוכן פס מגנטי‬
‫‪CardExpiry‬‬
‫אלפא‬
‫תוקף כרטיס ‪MMYY‬‬
‫‪TransSum‬‬
‫נומרי‬
‫סכום הפעולה )לזיכוי יש להעביר מספר שלילי(‬
‫‪TransPoints‬‬
‫נומרי‬
‫כוכבים‪/‬נקודות לשימוש כחלק מהסכום לחיוב‬
‫‪Last4Digits‬‬
‫אלפא‬
‫ארבע ספרות אחרונות במספר הכרטיס‬
‫‪CVV2‬‬
‫אלפא‬
‫קוד אימות כרטיס )‪ 4‬ספרות(‬
‫‪ID‬‬
‫אלפא‬
‫ת‪.‬ז‪ .‬בעל הכרטיס )‪ 9‬ספרות(‬
‫‪TransCurrency‬‬
‫נומרי‬
‫קוד מטבע ‪ /‬עסקת תשלומים‬
‫‪ISO_Currency‬‬
‫אלפא‬
‫קידוד ‪ ISO‬של המטבע )ראה נספח עבודה במט"ח בהמשך(‬
‫‪CreditType‬‬
‫נומרי‬
‫קוד סוג אשראי‬
‫‪ApprovalCode‬‬
‫אלפא‬
‫קוד אישור מוקדם לעסקה כפי שנתקבל טלפונית‬
‫‪FirstPayment‬‬
‫נומרי‬
‫סכום תשלום ראשון בעסקת תשלומים‬
‫‪FixedPayment‬‬
‫נומרי‬
‫סכום כל אחד משאר התשלומים‬
‫‪NumOfFixedPayments‬‬
‫נומרי‬
‫מספר התשלומים‬
‫‪TransRef‬‬
‫אלפא‬
‫אסמכתא פרטית – שדה חופשי )פרמטר ‪ (X‬עד ‪ 19‬תווים‬
‫‪J_Prm‬‬
‫נומרי‬
‫קוד סוג פעולה ‪J‬‬
‫‪Z_Prm‬‬
‫אלפא‬
‫ערך פרמטר ‪Z‬‬
‫‪Q_Prm‬‬
‫אלפא‬
‫ערך פרמטר ‪Q‬‬
‫‪R_Prm‬‬
‫אלפא‬
‫ערך פרמטר ‪R‬‬
‫בעסקה עם פס מגנטי חובה להעביר ערך כלשהו‪ ,‬מומלץ ‪0000‬‬
‫*‬
‫)רק למסופים עם אישור מחברת האשראי‪ .‬באין אישור יועבר ריק(‬
‫•‬
‫במידה ואין צורך או שימוש בשדה מסוים לא ניתן שלא להעביר בו ערך ולכן יש לטעון אותו באפס )‪ (0‬עבור שדה נומרי ושדה‬
‫ריק )""( עבור שדה אלפאנומרי‪.‬‬
‫פרמטר ‪ J‬משמש בפרמטר לקביעת אופי הפעולה‪ ,‬להלן הערכים ומשמעותם‪:‬‬
‫•‬
‫•‬
‫•‬
‫‪0‬‬
‫‪2‬‬
‫‪5‬‬
‫פעולת חיוב‪/‬זיכוי רגילה‬
‫משמש לקבלת זיהוי בלבד ובדיקת הכרטיס כאקט לפני ביצוע פעולה )במרבית המקרים מיותר ואינו מומלץ(‬
‫משמש לקבלת אישור בלבד ללא ביצוע חיוב בפועל‪ .‬מיועד להוראות קבע ‪ /‬תשלום נדחה באמצעות כרטיס אשראי‪.‬‬
‫ארקום מערכות ממוחשבות בע"מ ת‪.‬ד‪ 3002 .‬חדרה ‪ 38130‬טלפון ‪ 04-6222830 072-2753000‬פקס ‪www.arkom.co.il 04-6222840‬‬
‫מסמך זה הינו רכוש ארקום‪ .‬המידע הכלול במסמך זה הינו מידע פנימי‪ .‬העתקה‪ ,‬הפצה ו‪/‬או כל שימוש אחר במסמך או חלקים ממנו‪ ,‬אסורים לחלוטין‪.‬‬
‫עמוד ‪ 8‬מתוך ‪22‬‬
‫ארקום‬
‫מערכות ממוחשבות בע"מ‬
‫‪10/07/2011‬‬
‫הערות‬
‫•‬
‫•‬
‫•‬
‫בהעברת סכום תשלום ראשון וסכום כל תשלום בערכי אפס )‪ (0‬המערכת תחשב אוטומטית את ערכי‬
‫התשלומים‬
‫בהעברת סכום תשלום ראשון מחושב ואת ערך התשלום הקבוע בשאר התשלומים אפס )‪ (0‬המערכת‬
‫תחשב את ערך התשלום הקבוע‬
‫מפרט ערכים לשדה סוג אשראי )‪(CreditType‬‬
‫סוג אשראי‬
‫רגיל‬
‫ישרא‪/‬אמקס קרדיט‬
‫ויזה‪/‬דיינרס עדיף‬
‫‪ 30‬פלוס‬
‫חיוב מיידי‬
‫מועדון אשראי‬
‫סופר קרדיט‬
‫קרדיט‪/‬קרדיט בתשלומים קבועים‬
‫תשלומים‬
‫עסקת מועדון בתשלומים‬
‫•‬
‫קוד‬
‫‪1‬‬
‫‪2‬‬
‫‪3‬‬
‫‪4‬‬
‫‪5‬‬
‫‪6‬‬
‫‪8‬‬
‫‪9‬‬
‫מפרט ערכים לשדה קוד מטבע )‪(TransCurrency‬‬
‫סוג מטבע‬
‫מטבע לפי מפרט ‪ISO‬‬
‫לא נתמך במלואו באופן סטנדרטי ע"י חברות האשראי‬
‫שקל‬
‫דולר‬
‫עסקת תשלומים צמודים לדולר‬
‫עסקת תשלומים צמודים למדד‬
‫קוד‬
‫‪0‬‬
‫‪1‬‬
‫‪2‬‬
‫‪4‬‬
‫‪8‬‬
‫שים לב‪:‬‬
‫נא לפנות למחלקת התמיכה לקבלת‬
‫מספר מסוף וסיסמת גישה למערכת הפיתוח‬
‫ניתן לביצוע ישירות ע"י הקלקה על הלינק הבא ‪[email protected]‬‬
‫פעולות המועברות תחת סביבת טסט לא תחייבנה את הכרטיסים המועברים‬
‫לצורך הבדיקות והפיתוח המערכת תבצע את מהלך העסקה המלא כולל קבלת אישורים אך לא תבצע‬
‫כל חיוב או פעולה כספית כולל לא תפיסת אובליגו לכרטיס המועבר‪.‬‬
‫על כן ניתן להשתמש בכרטיס אשראי אמיתי לצרכי בדיקות ללא כל חשש מחיוב‬
‫ארקום מערכות ממוחשבות בע"מ ת‪.‬ד‪ 3002 .‬חדרה ‪ 38130‬טלפון ‪ 04-6222830 072-2753000‬פקס ‪www.arkom.co.il 04-6222840‬‬
‫מסמך זה הינו רכוש ארקום‪ .‬המידע הכלול במסמך זה הינו מידע פנימי‪ .‬העתקה‪ ,‬הפצה ו‪/‬או כל שימוש אחר במסמך או חלקים ממנו‪ ,‬אסורים לחלוטין‪.‬‬
‫עמוד ‪ 9‬מתוך ‪22‬‬
‫ארקום‬
‫מערכות ממוחשבות בע"מ‬
‫‪10/07/2011‬‬
‫טיפול באסימונים )‪MTS_TokenHandler - (Tokens‬‬
‫שם הפרמטר‬
‫סוג‬
‫תיאור ‪ /‬הערות‬
‫‪TerminalNum‬‬
‫אלפא‬
‫מספר מסוף לבצוע הפעולה כפי שנקבע ע"י ארקום‬
‫‪Password‬‬
‫אלפא‬
‫סיסמת גישה כפי שנקבעה למסוף ע"י ארקום‬
‫‪OpCode‬‬
‫נומרי‬
‫קוד הפעולה לפי המפורט להלן‪:‬‬
‫‪Token‬‬
‫אלפא‬
‫האסימון שיוחזר ע"י המערכת ואשר ישמש כתחליף למספר כרטיס *‬
‫‪PAN‬‬
‫אלפא‬
‫מספר הכרטיס אשר האסימון המיועד ייצג בעת ביצוע פעולות‬
‫‪AltPAN‬‬
‫אלפא‬
‫•‬
‫‪ – 0‬מחיקת אסימון )לפי מספר אסימון(‬
‫•‬
‫‪ – 1‬יצירת אסימון חדש‬
‫•‬
‫‪ – 2‬החלף ‪ /‬עדכן מספר כרטיס אשראי‬
‫•‬
‫‪ – 3‬תשאל את השרת לסטטוס אסימונים‬
‫•‬
‫‪ – 4‬מחק את כל האסימונים מבסיס הנתונים‬
‫•‬
‫‪ – 5‬כווץ את טבלת האסימונים‬
‫•‬
‫‪ – 6‬מחיקת אסימון )לפי מספר כרטיס אשראי(‬
‫•‬
‫‪ – 7‬אחזור אסימון לפי מספר כרטיס‬
‫‪1‬‬
‫‪2‬‬
‫מספר הכרטיס החלופי לפעולת עדכון מספר כרטיס‬
‫‪3‬‬
‫שים לב‬
‫עקרונית השימוש באסימון מהווה תחליף שקוף לשימוש במספר כרטיס‪.‬‬
‫בעת העברת עסקה לביצוע‪ ,‬מערכת הפועלת עם אסימונים תעביר בשדה המיועד למספר כרטיס את האסימון‬
‫המייצג אותו‪ .‬בעת העברת הפעולה לשרת הסליקה המערכת תבצע החלפת האסימון במספר הכרטיס השמור‬
‫במערכת ובכך יימנע הצורך מאגירת מספרי כרטיסים במערכת המתממשקת ל ‪MTS‬‬
‫כל הפעולות באסימון כתחליף מייצג למספר כרטיס אשראי שקופות למערכת ומתבצעות באופן אוטומטי ברקע‬
‫בעת העברת העסקה לשרת באמצעות ה ‪Web Service‬‬
‫שירות האסימונים הינו שירות נוסף והשימוש בו דורש הסכם שימוש נפרד מעבר להסכם השימוש ב ‪MTS‬‬
‫תחזוקת האסימונים נמצאת באחריותו המלאה של המשתמש ובאחריותו למחוק אסימונים שאינם בתוקף‬
‫אסימון משמש בעיקרון לצורכי ביצוע הוראת קבע או העברת קבצי פעולות מרובות שורות‪ .‬ניתן להעביר עסקה‬
‫בודדת במקרה הצורך באותו אופן בו מועברת עסקה רגילה רק שכאמור במקום מספר הכרטיס יועבר האסימון‬
‫לשם העברת חיובי הוראת קבע יש להעביר את הכרטיס אישור ולשמור את מספר האישור המתקבל‪ ,‬ואז יש‬
‫לייצר עבורו אסימון ולשמור את נתוני האסימון ואת מספר האישור לשם שימוש חוזר בעת העברת קובץ לחיוב‪.‬‬
‫קבלת האישור מתבצעת באמצעות הפונקציה ‪ MTS_PutTransactionRequest‬כאשר בפרמטר ‪ J‬יש להעביר‬
‫את הקוד ‪.5‬‬
‫ארקום מערכות ממוחשבות בע"מ ת‪.‬ד‪ 3002 .‬חדרה ‪ 38130‬טלפון ‪ 04-6222830 072-2753000‬פקס ‪www.arkom.co.il 04-6222840‬‬
‫מסמך זה הינו רכוש ארקום‪ .‬המידע הכלול במסמך זה הינו מידע פנימי‪ .‬העתקה‪ ,‬הפצה ו‪/‬או כל שימוש אחר במסמך או חלקים ממנו‪ ,‬אסורים לחלוטין‪.‬‬
‫עמוד ‪ 10‬מתוך ‪22‬‬
‫ארקום‬
‫מערכות ממוחשבות בע"מ‬
‫‪10/07/2011‬‬
‫הערה – יצירת אסימון חדש‬
‫ניתן לייצר את האסימון במערכת המארחת ולהעביר לשרת את האסימון לשימוש‪.‬‬
‫במקרים מסויימים עשוי להיווצר מצב בו המערכת המקומית תעדיף לייצר את האסימונים בעצמה ולא להסתמך‬
‫על האסימונים המיוצרים בשרת‪.‬‬
‫במקרה כזה יש להעביר את האסימון המבוקש לשרת בשדה ‪Token‬‬
‫אם האסימון שהועבר יהיה בעל מבנה חוקי אזי השרת לא ייצר אסימון אלא ישתמש באסימון שסופק‪.‬‬
‫העברת שדה ‪ Token‬טעון בערך אסימון חוקי תגרום כאמור לשרת להשתמש באסימון שסופק‬
‫העברת השדה ריק או עם ערך לא חוקי לאסימון תגרום לשרת לייצר אסימון בעצמו‬
‫ערך חוקי לאסימון הוא‪ :‬חייב להתחיל בתוו ^ ולהכיל לפחות ‪ 20‬תווים‬
‫במקרה של ייצור אסימון עצמי כל האחריות תחול על המערכת המארחת‬
‫‪.1‬‬
‫לצורך החלפת ‪ /‬עדכון מספר כרטיס אשראי בבסיס הנתונים יש לספק את מספר הכרטיס הישן ואת מספר הכרטיס החדש‪ .‬מיועד‬
‫לאותם מקרים בהם מתקבל קובץ עדכון מאת חברות האשראי‪ .‬במקרים אחרים יש למחוק אסימון וליצר חדש ואז אין כל צורך‬
‫לשמור או לספק את מספר הכרטיס הישן‪ .‬האסימון לא משתנה ובכך נשמרת השקיפות מבחינת השימוש באסימון‪.‬‬
‫‪.2‬‬
‫מיועד לקבלת מידע כמה אסימונים מוקצים‪ ,‬כמה בשימוש וכמה נותרו‪ .‬הנתון חוזר בשדה המיועד לאסימון )‪ (Token‬ובמבנה ‪CSV‬‬
‫‪.3‬‬
‫מיועד כאמור להחלפת מספרי כרטיס‪ ,‬בכל מקרה אחר יש להעביר שדה ריק‬
‫ארקום מערכות ממוחשבות בע"מ ת‪.‬ד‪ 3002 .‬חדרה ‪ 38130‬טלפון ‪ 04-6222830 072-2753000‬פקס ‪www.arkom.co.il 04-6222840‬‬
‫מסמך זה הינו רכוש ארקום‪ .‬המידע הכלול במסמך זה הינו מידע פנימי‪ .‬העתקה‪ ,‬הפצה ו‪/‬או כל שימוש אחר במסמך או חלקים ממנו‪ ,‬אסורים לחלוטין‪.‬‬
‫עמוד ‪ 11‬מתוך ‪22‬‬
‫ארקום‬
‫מערכות ממוחשבות בע"מ‬
‫‪10/07/2011‬‬
‫טיפול בבסיס הנתונים – קבלת עותק של בסיס הנתונים כפי שהוא בשרת ‪MTS_GetTerminalDB -‬‬
‫שם הפרמטר‬
‫סוג‬
‫תיאור ‪ /‬הערות‬
‫‪TerminalNum‬‬
‫אלפא‬
‫מספר מסוף לבצוע הפעולה כפי שנקבע ע"י ארקום‬
‫‪Password‬‬
‫אלפא‬
‫סיסמת גישה כפי שנקבעה למסוף ע"י ארקום‬
‫‪DownloadLink‬‬
‫אלפא‬
‫פרמטר המחזיר את הלינק להורדת בסיס הנתונים‪.‬‬
‫‪ZipPassword‬‬
‫אלפא‬
‫הקובץ המועבר הוא במבנה ‪ ZIP‬עם סיסמא כפי שתועבר בממשק‬
‫סיסמת הגישה לקובץ ה ‪ - ZIP‬מנדטורי‬
‫מטרתה של פונקציה זו היא לאפשר קבלת עותק של בסיס הנתונים כפי שהוא מופיע בשרת‪.‬‬
‫בסיס נתונים זה יכול לשמש למגוון מטרות בהתאם לצרכי ואיפיון המערכת המארחת‪.‬‬
‫בסיס הנתונים המקבל הוא במבנה ‪ SQLite‬ומבנהו הפנימי מפורט בהמשך‬
‫בסיס נתונים זה אינו מאחסן נתוני כרטיסי אשראי או כל נתון רגיש אחר‬
‫השדה "מספר כרטיס" מכיל אך ורק את ‪ 4‬הספרות האחרונות של הכרטיס ששימש לבצוע הפעולה‬
‫לינק הגישה וההורדה המתקבל באמצעות הפונקציה מאפשר הורדה רגילה ע"י דפדפן או בפרוטוקול ‪HTTP‬‬
‫טיפול בבסיס הנתונים – החזרת חיווי לשרת כי הקובץ נתקבל ‪MTS_TerminalDB_Ack -‬‬
‫שם הפרמטר‬
‫סוג‬
‫תיאור ‪ /‬הערות‬
‫‪TerminalNum‬‬
‫אלפא‬
‫מספר מסוף לבצוע הפעולה כפי שנקבע ע"י ארקום‬
‫‪Password‬‬
‫אלפא‬
‫סיסמת גישה כפי שנקבעה למסוף ע"י ארקום‬
‫‪DownloadLink‬‬
‫אלפא‬
‫הלינק להורדת בסיס הנתונים כפי שנתקבל מהשרת‬
‫פונקציה זו משמשת להחזרת חיווי לשרת כי הקובץ נתקבל בהצלחה וכי ניתן להסיר את הלינק ולמחוק את עותק‬
‫הקובץ ממחיצת ההורדות בשרת‬
‫ארקום מערכות ממוחשבות בע"מ ת‪.‬ד‪ 3002 .‬חדרה ‪ 38130‬טלפון ‪ 04-6222830 072-2753000‬פקס ‪www.arkom.co.il 04-6222840‬‬
‫מסמך זה הינו רכוש ארקום‪ .‬המידע הכלול במסמך זה הינו מידע פנימי‪ .‬העתקה‪ ,‬הפצה ו‪/‬או כל שימוש אחר במסמך או חלקים ממנו‪ ,‬אסורים לחלוטין‪.‬‬
‫עמוד ‪ 12‬מתוך ‪22‬‬
‫ארקום‬
‫מערכות ממוחשבות בע"מ‬
‫‪10/07/2011‬‬
‫מבנה הנתונים המוחזרים מהפונקציה ‪ MTS_GetTransactionResults‬בשדה ‪Answer‬‬
‫פונקצית ביצוע עיסקה מחזירה ‪ STRING‬המכיל את כל נתוני תוצאת העסקה‪.‬‬
‫‪ STRING‬זה הינו רציף ומחולק עפ"י מיקום – ‪Fixed Length‬‬
‫שם השדה‬
‫תווים‬
‫מקום יחסי‬
‫הערות‬
‫אם התקבל קוד "‪ "000‬ניתן לוותר על בדיקת תיאור השגיאה‬
‫סטאטוס‬
‫‪3‬‬
‫‪1‬‬
‫פילר‬
‫‪1‬‬
‫‪4‬‬
‫מספר כרטיס‬
‫‪19‬‬
‫‪5‬‬
‫אפסים מובילים‪.‬‬
‫מותג‬
‫‪1‬‬
‫‪24‬‬
‫‪ – 0‬כרטיס פרטי של חברה מנפיקה )‪(PL‬‬
‫קוד חב' אשראי‬
‫‪1‬‬
‫‪25‬‬
‫תו ריק‬
‫‪ – 1‬מאסטרקארד‬
‫‪ – 2‬ויזה‬
‫‪ – 3‬מאסטרו‬
‫חברה סולקת‬
‫‪ – 1‬ישראכרט‬
‫‪ – 2‬ויזה כ‪.‬א‪.‬ל‬
‫‪ – 3‬דיינרס‬
‫‪ – 4‬אמריקן אקספרס‬
‫‪ – 6‬לאומי קארד‬
‫קוד שרות‬
‫‪3‬‬
‫‪26‬‬
‫פרמטר ‪J‬‬
‫‪1‬‬
‫‪29‬‬
‫תאריך תוקף‬
‫‪4‬‬
‫‪30‬‬
‫‪MMYY‬‬
‫תשובת חב'‬
‫‪1‬‬
‫‪34‬‬
‫‪ – 0‬לא הוכנס‬
‫‪ – 1‬הוכנס ותקין‬
‫האשראי – ת"ז‬
‫‪ – 2‬לא תקין‬
‫‪ – 3‬לא נבדק‬
‫תשובת חב'‬
‫‪1‬‬
‫‪35‬‬
‫האשראי – ‪CVV‬‬
‫‪ – 0‬לא הוכנס‬
‫‪ – 1‬הוכנס ותקין‬
‫‪ – 2‬לא תקין‬
‫‪ – 3‬לא נבדק‬
‫סכום באגורות‬
‫‪8‬‬
‫‪36‬‬
‫מידע נוסף‬
‫‪8‬‬
‫‪44‬‬
‫סכום בכוכבים‬
‫‪8‬‬
‫‪52‬‬
‫קוד חב' אשראי‬
‫‪1‬‬
‫‪60‬‬
‫העברת מידע נוסף ע"י חברת האשראי בתוך תשובה לשאילתא‪.‬‬
‫לדוגמא‪ :‬יתרת האשראי של מחזיק הכרטיס‪ .‬השדה הנו אלפא נומרי‪.‬‬
‫‪ – 1‬ישראכרט‬
‫ארקום מערכות ממוחשבות בע"מ ת‪.‬ד‪ 3002 .‬חדרה ‪ 38130‬טלפון ‪ 04-6222830 072-2753000‬פקס ‪www.arkom.co.il 04-6222840‬‬
‫מסמך זה הינו רכוש ארקום‪ .‬המידע הכלול במסמך זה הינו מידע פנימי‪ .‬העתקה‪ ,‬הפצה ו‪/‬או כל שימוש אחר במסמך או חלקים ממנו‪ ,‬אסורים לחלוטין‪.‬‬
‫עמוד ‪ 13‬מתוך ‪22‬‬
‫ארקום‬
‫מערכות ממוחשבות בע"מ‬
‫‪10/07/2011‬‬
‫‪ – 2‬ויזה כ‪.‬א‪.‬ל‬
‫חברה מנפיקה‬
‫‪ – 3‬דיינרס‬
‫‪ – 4‬אמריקן אקספרס‬
‫‪JCB – 5‬‬
‫‪ – 6‬לאומי קארד‬
‫סוג עסקה‬
‫‪2‬‬
‫‪61‬‬
‫סוג אשראי‬
‫‪1‬‬
‫‪63‬‬
‫‪UCAF/CAVV‬‬
‫‪1‬‬
‫‪64‬‬
‫סוג מטבע‬
‫‪1‬‬
‫‪65‬‬
‫קוד עסקה‬
‫‪2‬‬
‫‪66‬‬
‫‪ – 00‬כרטיס חסום‬
‫‪ – 01‬עסקת חובה רגילה‬
‫‪ – 02‬עסקת חובה מאושרת‬
‫‪ – 03‬עסקה מאולצת‬
‫‪ – 51‬עסקת זכות‬
‫‪ – 52‬עסקת ביטול‬
‫‪ – 53‬עסקת זכות מאושרת‬
‫תוצאת בדיקה של ערך ‪ UCAF/CAVV‬במהלך ביצוע בקשה‬
‫לאישור‪.‬‬
‫קוד מועדון‬
‫‪1‬‬
‫‪68‬‬
‫כפי שנקבע בין חברות האשראי ורשתות השיווק‪.‬‬
‫סיבת התקשרות‬
‫‪1‬‬
‫‪69‬‬
‫"רווח" – לא בוצעה התקשרות‬
‫מקור האישור‬
‫‪1‬‬
‫‪70‬‬
‫מספר אישור‬
‫‪7‬‬
‫‪71‬‬
‫סכום תשלום‬
‫‪8‬‬
‫‪78‬‬
‫‪ - 1‬אקראי‬
‫‪ - 2‬תקרה‬
‫‪ - 3‬מספר סודי‬
‫‪ - 4‬קוד שרות בפס מגנטי‬
‫‪ - 5‬בקשה לאישור ללא עסקה‬
‫‪ - 6‬חסום לא חד משמעי‬
‫‪) Z.F.L - 7‬תקרת ‪( 0‬‬
‫‪ - 8‬בקשה לאישור יזומה‬
‫‪ - 1‬אושר ע"י שב"א‬
‫‪ - 2‬אושר ע"י חברת האשראי‬
‫‪ - 3‬אושר ע"י המענה הקולי‬
‫‪ - 0‬עסקה ללא אישור‬
‫ראשון‬
‫סכום תשלום‬
‫‪8‬‬
‫‪86‬‬
‫ארקום מערכות ממוחשבות בע"מ ת‪.‬ד‪ 3002 .‬חדרה ‪ 38130‬טלפון ‪ 04-6222830 072-2753000‬פקס ‪www.arkom.co.il 04-6222840‬‬
‫מסמך זה הינו רכוש ארקום‪ .‬המידע הכלול במסמך זה הינו מידע פנימי‪ .‬העתקה‪ ,‬הפצה ו‪/‬או כל שימוש אחר במסמך או חלקים ממנו‪ ,‬אסורים לחלוטין‪.‬‬
‫עמוד ‪ 14‬מתוך ‪22‬‬
‫ארקום‬
‫מערכות ממוחשבות בע"מ‬
‫‪10/07/2011‬‬
‫קבוע‬
‫מספר תשלומים‬
‫‪2‬‬
‫‪94‬‬
‫מספר קובץ‬
‫‪2‬‬
‫‪96‬‬
‫מספר קופה‬
‫‪3‬‬
‫‪98‬‬
‫‪001-999‬‬
‫מספר סודר‬
‫‪3‬‬
‫‪101‬‬
‫‪001-999‬‬
‫בקופה‬
‫שם כרטיס‬
‫‪15‬‬
‫‪104‬‬
‫ציון לכרטיס חו"ל‬
‫‪1‬‬
‫‪119‬‬
‫‪ – 1‬כרטיס חו"ל‬
‫נתוני משתמש‬
‫‪19‬‬
‫‪120‬‬
‫פרמטר ‪ – X‬שדה חופשי – לא מועבר לחברת האשראי‬
‫סיומת‬
‫‪2‬‬
‫‪139‬‬
‫‪CR/LF‬‬
‫•‬
‫הסכום המוחזר במבנה הנתונים הוא באגורות וללא סימן מינוס לעסקת זיכוי‪ .‬לשם זיהוי האם העסקה היא‬
‫עסקת זיכוי יש לבדוק את ערך השדה "סוג עסקה"‬
‫•‬
‫השדות ‪ MerchantNote / ClientNote‬יכילו את שוברי העסקה בהתאמה במידה והעסקה הייתה עסקת‬
‫חיוב או זיכוי שעברה בהצלחה‪.‬‬
‫בכל סוג עסקה אחר או במקרה שהעסקה שנכשלה השדות יהיו ריקים‪.‬‬
‫במידה ויש שובר הוא יהיה מוכן להדפסה )ניתן לשולחו ישירות למדפסת או לקובץ(‬
‫ארקום מערכות ממוחשבות בע"מ ת‪.‬ד‪ 3002 .‬חדרה ‪ 38130‬טלפון ‪ 04-6222830 072-2753000‬פקס ‪www.arkom.co.il 04-6222840‬‬
‫מסמך זה הינו רכוש ארקום‪ .‬המידע הכלול במסמך זה הינו מידע פנימי‪ .‬העתקה‪ ,‬הפצה ו‪/‬או כל שימוש אחר במסמך או חלקים ממנו‪ ,‬אסורים לחלוטין‪.‬‬
‫עמוד ‪ 15‬מתוך ‪22‬‬
‫ארקום‬
‫מערכות ממוחשבות בע"מ‬
‫‪10/07/2011‬‬
‫יצירת עסקה במהלך יחיד ‪MTS_CC_Transaction -‬‬
‫שם הפרמטר‬
‫סוג‬
‫תיאור ‪ /‬הערות‬
‫‪TerminalNum‬‬
‫אלפא‬
‫מספר מסוף לבצוע הפעולה כפי שנקבע ע"י ארקום‬
‫‪Password‬‬
‫אלפא‬
‫סיסמת גישה כפי שנקבעה למסוף ע"י ארקום‬
‫‪TransactionID‬‬
‫אלפא‬
‫מזהה ייחודי לעסקה‬
‫‪CardNum‬‬
‫אלפא‬
‫מספר כרטיס אשראי ‪ /‬תוכן פס מגנטי‬
‫‪CardExpiry‬‬
‫אלפא‬
‫תוקף כרטיס ‪MMYY‬‬
‫‪TransSum‬‬
‫נומרי‬
‫סכום הפעולה )לזיכוי יש להעביר מספר שלילי(‬
‫‪TransPoints‬‬
‫נומרי‬
‫כוכבים‪/‬נקודות לשימוש כחלק מהסכום לחיוב‬
‫‪Last4Digits‬‬
‫אלפא‬
‫ארבע ספרות אחרונות במספר הכרטיס‬
‫‪CVV2‬‬
‫אלפא‬
‫קוד אימות כרטיס )‪ 4‬ספרות(‬
‫‪ID‬‬
‫אלפא‬
‫ת‪.‬ז‪ .‬בעל הכרטיס )‪ 9‬ספרות(‬
‫‪TransCurrency‬‬
‫נומרי‬
‫קוד מטבע ‪ /‬עסקת תשלומים‬
‫‪ISO_Currency‬‬
‫אלפא‬
‫קידוד ‪ ISO‬של המטבע )‪(USD, EUR, ILS‬‬
‫‪CreditType‬‬
‫נומרי‬
‫קוד סוג אשראי‬
‫‪ApprovalCode‬‬
‫אלפא‬
‫קוד אישור מוקדם לעסקה כפי שנתקבל טלפונית‬
‫‪FirstPayment‬‬
‫נומרי‬
‫סכום תשלום ראשון בעסקת תשלומים‬
‫‪FixedPayment‬‬
‫נומרי‬
‫סכום כל אחד משאר התשלומים‬
‫‪NumOfFixedPayments‬‬
‫נומרי‬
‫מספר התשלומים‬
‫‪TransRef‬‬
‫אלפא‬
‫אסמכתא פרטית – שדה חופשי )פרמטר ‪ (X‬עד ‪ 19‬תווים‬
‫‪J_Prm‬‬
‫נומרי‬
‫קוד סוג פעולה ‪J‬‬
‫‪Z_Prm‬‬
‫אלפא‬
‫ערך פרמטר ‪Z‬‬
‫‪Q_Prm‬‬
‫אלפא‬
‫ערך פרמטר ‪Q‬‬
‫‪R_Prm‬‬
‫אלפא‬
‫ערך פרמטר ‪R‬‬
‫‪Answer‬‬
‫אלפא‬
‫תוצאת העסקה – מבנה הנתונים יפורט בהמשך‬
‫‪MerchantNote‬‬
‫אלפא‬
‫שובר העסקה – חלק בית העסק )מוכן להדפסה(‬
‫‪ClientNote‬‬
‫אלפא‬
‫בעסקה עם פס מגנטי חובה להעביר ערך כלשהו‪ ,‬מומלץ ‪0000‬‬
‫)רק למסופים עם אישור מחברת האשראי‪ .‬באין אישור יועבר ריק(‬
‫במידה והעסקה כשלה או לסוג העסקה אין פתקית יוחזר פרמטר ריק‬
‫שובר העסקה לחתימת הלקוח )מוכן להדפסה(‬
‫במידה והעסקה כשלה או לסוג העסקה אין פתקית יוחזר פרמטר ריק‬
‫להסברים ראה ‪ MTS_PutTransactionRequest‬וכן ‪MTS_GetTransactionResults‬‬
‫ארקום מערכות ממוחשבות בע"מ ת‪.‬ד‪ 3002 .‬חדרה ‪ 38130‬טלפון ‪ 04-6222830 072-2753000‬פקס ‪www.arkom.co.il 04-6222840‬‬
‫מסמך זה הינו רכוש ארקום‪ .‬המידע הכלול במסמך זה הינו מידע פנימי‪ .‬העתקה‪ ,‬הפצה ו‪/‬או כל שימוש אחר במסמך או חלקים ממנו‪ ,‬אסורים לחלוטין‪.‬‬
‫עמוד ‪ 16‬מתוך ‪22‬‬
‫ארקום‬
‫מערכות ממוחשבות בע"מ‬
10/07/2011
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
TEXT
TEXT
TEXT
TEXT
TEXT
TEXT
INTEGER
TEXT
TEXT
TEXT
FLOAT
TEXT
FLOAT
TEXT
TEXT
TEXT
TEXT
TEXT
TEXT
TEXT
TEXT
TEXT
TEXT
FLOAT
FLOAT
INTEGER
TEXT
TEXT
INTEGER
TEXT
DATE
TEXT
www.arkom.co.il 04-6222840 ‫ פקס‬04-6222830 072-2753000 ‫ טלפון‬38130 ‫ חדרה‬3002 .‫ד‬.‫ארקום מערכות ממוחשבות בע"מ ת‬
.‫ אסורים לחלוטין‬,‫או כל שימוש אחר במסמך או חלקים ממנו‬/‫ הפצה ו‬,‫ העתקה‬.‫ המידע הכלול במסמך זה הינו מידע פנימי‬.‫מסמך זה הינו רכוש ארקום‬
22 ‫ מתוך‬17 ‫עמוד‬
‫ארקום‬
‫מערכות ממוחשבות בע"מ‬
‫‪10/07/2011‬‬
‫נספח הודעות שגיאה‬
‫‪ - 000‬עסקה תקינה‬
‫‪ - 001‬חסום‬
‫‪ - 002‬גנוב‬
‫‪ - 003‬התקשר לחברת האשראי‬
‫‪ - 004‬סירוב‬
‫‪ - 005‬מזויף‬
‫‪ - 006‬ת‪.‬ז‪.‬או ‪ CVV‬שגויים‬
‫‪ ECI - 007‬או ‪ UCAF/CAVV‬שגויים‬
‫‪ - 008‬תקלה בבניית מפתח גישה לקובץ חסומים‬
‫‪ - 009‬לא הצליח להתקשר‪,‬התקשר לחברת האשראי‬
‫‪ - 010‬תוכנית הופסקה עפ"י הוראת המפעיל )‪ (ESC‬או ‪ COM PORT‬לא ניתן לפתיחה )‪(WINDOWS‬‬
‫‪ - 015‬אין התאמה בין המספר שהוקלד לפס המגנטי‬
‫‪ - 016‬נתונים נוספים אינם או ישנם בניגוד להגדרות המסוף‬
‫‪ - 017‬לא הוקלדו ‪ 4‬ספרות האחרונות‬
‫‪ - 019‬רשומה בקובץ ‪ INT_IN‬קצרה מ ‪ 16‬תווים‬
‫‪ - 020‬קובץ קלט )‪ (IN_INT‬לא קיים‬
‫‪ - 021‬קובץ חסומים )‪ (NEG‬לא קיים או לא מעודכן ‪ -‬בצע שידור או בקשה לאישור עבור כל עסקה‬
‫‪ - 022‬אחד מקבצי פרמטרים או ווקטורים לא קיים‬
‫‪ - 023‬קובץ תאריכים )‪ (DATA‬לא קיים‬
‫‪ - 024‬קובץ אתחול )‪ (START‬לא קיים‬
‫‪ - 025‬הפרש בימים בקליטת חסומים גדול מדי ‪ -‬בצע שידור או בקשה לאישור עבור כל עסקה‬
‫‪ - 026‬הפרש דורות בקליטת חסומים גדול מידי ‪ -‬בצע שידור או בקשה לאישור עבור כל עסקה‬
‫‪ - 027‬כאשר לא הוכנס פס מגנטי כולו הגדר עסקה כעסקה טלפונית או כעסקת חתימה בלבד‬
‫‪ - 028‬מספר מסוף מרכזי לא הוכנס למסוף המוגדר לעבודה כרב ספק‬
‫‪ - 029‬מספר מוטב לא הוכנס למסוף המוגדר לעבודה כרב מוטב‬
‫‪ - 030‬מסוף שאינו מעודכן כרב ספק‪/‬רב מוטב והוקלד מס' ספק‪/‬מס' מוטב‬
‫‪ - 031‬מסוף מעודכן כרב ספק והוקלד גם מס' מוטב‬
‫‪ - 032‬תנועות ישנות בצע שידור או בקשה לאישור עבור כל עסקה‬
‫‪ - 033‬כרטיס לא תקין‬
‫‪ - 034‬כרטיס לא רשאי לבצע במסוף זה או אין אישור לעסקה כזאת‬
‫‪ - 035‬כרטיס לא רשאי לבצע עסקה עם סוג אשראי זה‬
‫‪ - 036‬פג תוקף‬
‫‪ - 037‬שגיאה בתשלומים ‪ -‬סכום עסקה צריך להיות שווה תשלום ראשון ‪) +‬תשלום קבוע כפול מס' תשלומים(‬
‫‪ - 038‬לא ניתן לבצע עסקה מעל תקרה לכרטיס לאשראי חיוב מיידי‬
‫‪ - 039‬סיפרת בקורת לא תקינה‬
‫‪ - 040‬מסוף שמוגדר כרב מוטב הוקלד מס' ספק‬
‫‪ - 041‬מעל תקרה‪ ,‬אך קובץ הקלט מכיל הוראה לא לבצע שאילתא )‪(J1,J2,J3‬‬
‫‪ - 042‬חסום בספק‪ ,‬אך קובץ הקלט מכיל הוראה לא לבצע שאילתא )‪(J1,J2,J3‬‬
‫‪ - 043‬אקראית‪ ,‬אך קובץ הקלט מכיל הוראה לא לבצע שאילתא )‪(J1,J2,J3‬‬
‫‪ - 044‬מסוף לא רשאי לבקש אישור ללא עסקה‪ ,‬אך קובץ הקלט מכיל )‪(J5‬‬
‫‪ - 045‬מסוף לא רשאי לבקש אישור ביוזמתו‪ ,‬אך קובץ הקלט מכיל )‪(J6‬‬
‫‪ - 046‬יש לבקש אישור‪ ,‬אך קובץ הקלט מכיל הוראה לא לבצע שאילתא )‪(J1,J2,J3‬‬
‫‪ - 047‬יש לבקש אישור בשל בעיה הקשורה לקכ"ח אך קובץ הקלט מכיל הוראה לא לבצע שאילתא‬
‫‪ - 051‬מספר רכב לא תקין‬
‫‪ - 052‬מד מרחק לא הוקלד‬
‫‪ - 053‬מסוף לא מוגדר כתחנת דלק‪) .‬הועבר כרטיס דלק או קוד עסקה לא מתאים(‬
‫‪ - 057‬לא הוקלד מספר תעודת זהות‬
‫‪ - 058‬לא הוקלד ‪CVV2‬‬
‫‪ - 059‬לא הוקלדו מספר תעודת הזהות וה‪CVV2 -‬‬
‫‪ - 060‬צרוף ‪ ABS‬לא נמצא בהתחלת נתוני קלט בזיכרון‬
‫‪ - 061‬מספר כרטיס לא נמצא או נמצא פעמיים‬
‫‪ - 062‬סוג עסקה לא תקין‬
‫‪ - 063‬קוד עסקה לא תקין‬
‫‪ - 064‬סוג אשראי לא תקין‬
‫ארקום מערכות ממוחשבות בע"מ ת‪.‬ד‪ 3002 .‬חדרה ‪ 38130‬טלפון ‪ 04-6222830 072-2753000‬פקס ‪www.arkom.co.il 04-6222840‬‬
‫מסמך זה הינו רכוש ארקום‪ .‬המידע הכלול במסמך זה הינו מידע פנימי‪ .‬העתקה‪ ,‬הפצה ו‪/‬או כל שימוש אחר במסמך או חלקים ממנו‪ ,‬אסורים לחלוטין‪.‬‬
‫עמוד ‪ 18‬מתוך ‪22‬‬
‫ארקום‬
‫מערכות ממוחשבות בע"מ‬
‫‪10/07/2011‬‬
‫‪ - 065‬מטבע לא תקין‬
‫‪ - 066‬קיים תשלום ראשון ו‪/‬או תשלום קבוע לסוג אשראי שונה מתשלומים‬
‫‪ - 067‬קיים מספר תשלומים לסוג אשראי שאינו דורש זה‬
‫‪ - 068‬לא ניתן להצמיד לדולר או למדד לסוג אשראי שונה מתשלומים‬
‫‪ - 069‬אורך הפס המגנטי קצר מידי‬
‫‪ - 070‬לא מוגדר מכשיר להקשת מספר סודי‬
‫‪ - 071‬חובה להקליד מספר סודי‬
‫‪ - 072‬קכ"ח לא זמין ‪ -‬העבר בקורא מגנטי‬
‫‪ - 073‬הכרטיס נושא שבב ויש להעבירו דרך הקכ"ח‬
‫‪ - 074‬דחייה ‪-‬כרטיס נעול‬
‫‪ - 075‬דחייה ‪-‬פעולה עם קכ"ח לא הסתיימה בזמן הראוי‬
‫‪ - 076‬דחייה ‪-‬נתונים אשר התקבלו מקכ"ח אינם מוגדרים במערכת‬
‫‪ - 077‬הוקש מספר סודי שגוי‬
‫‪ - 080‬הוכנס "קוד מועדון" לסוג אשראי לא מתאים‬
‫‪ - 099‬לא מצליח לקרוא‪ /‬לכתוב‪ /‬לפתוח קובץ ‪TRAN‬‬
‫‪ - 101‬אין אישור מחברת אשראי לעבודה‬
‫‪ - 106‬למסוף אין אישור לביצוע שאילתא לאשראי חיוב מיידי‬
‫‪ - 107‬סכום העסקה גדול מידי ‪ -‬חלק למספר עסקאות‬
‫‪ - 108‬למסוף אין אישור לבצע עסקאות מאולצות‬
‫‪ - 109‬למסוף אין אישור לכרטיס עם קוד השרות ‪587‬‬
‫‪ - 110‬למסוף אין אישור לכרטיס חיוב מיידי‬
‫‪ - 111‬למסוף אין אישור לעסקה בתשלומים‬
‫‪ - 112‬למסוף אין אישור לעסקה טלפון‪/‬חתימה בלבד בתשלומים‬
‫‪ - 113‬למסוף אין אישור לעסקה טלפונית‬
‫‪ - 114‬למסוף אין אישור לעסקה "חתימה בלבד"‬
‫‪ - 115‬למסוף אין אישור לעסקה בדולרים‬
‫‪ - 116‬למסוף אין אישור לעסקת מועדון‬
‫‪ - 117‬למסוף אין אישור לעסקת כוכבים‪/‬נקודות‪/‬מיילים‬
‫‪ - 118‬למסוף אין אישור לאשראי ישראקרדיט‬
‫‪ - 119‬למסוף אין אישור לאשראי אמקס קרדיט‬
‫‪ - 120‬למסוף אין אישור להצמדה לדולר‬
‫‪ - 121‬למסוף אין אישור להצמדה למדד‬
‫‪ - 122‬למסוף אין אישור להצמדה למדד לכרטיסי חו"ל‬
‫‪ - 123‬למסוף אין אישור לעסקת כוכבים‪/‬נקודות‪/‬מיילים לסוג אשראי זה‬
‫‪ - 124‬למסוף אין אישור לאשראי קרדיט בתשלומים לכרטיסי ישראכרט‬
‫‪ - 125‬למסוף איו אישור לאשראי קרדיט בתשלומים לכרטיסי אמקס‬
‫‪ - 126‬למסוף אין אישור לקוד מועדון זה‬
‫‪ - 127‬למסוף אין אישור לעסקת חיוב מיידי פרט לכרטיסי חיוב מיידי‬
‫‪ - 128‬למסוף אין אישור לקבל כרטיסי ויזה אשר מתחילים ב ‪3-‬‬
‫‪ - 129‬למסוף אין אישור לבצע עסקת זכות מעל תקרה‬
‫‪ - 130‬כרטיס לא רשאי לבצע עסקת מועדון‬
‫‪ - 131‬כרטיס לא רשאי לבצע עסקת כוכבים‪/‬נקודות‪/‬מיילים‬
‫‪ - 132‬כרטיס לא רשאי לבצע עסקאות בדולרים )רגילות או טלפוניות(‬
‫‪ - 133‬כרטיס לא תקף על פי רשימת כרטיסים תקפים של ישראכרט‬
‫‪ - 134‬כרטיס לא תקין עפ"י הגדרת המערכת )‪ VECTOR1‬של ישראכרט( ‪ -‬מס' הספרות בכרטיס שגוי‬
‫‪ - 135‬כרטיס לא רשאי לבצע עסקאות דולריות עפ"י הגדרת המערכת )‪ VECTOR1‬של ישראכרט(‬
‫‪ - 136‬הכרטיס שייך לקבוצת כרטיסים אשר אינה רשאית לבצע עסקאות עפ"י הגדרת המערכת )‪ VECTOR20‬של ויזה(‬
‫‪ - 137‬קידומת הכרטיס )‪ 7‬ספרות( לא תקפה עפ"י הגדרת המערכת )‪ VECTOR21‬של דיינרס(‬
‫‪ - 138‬כרטיס לא רשאי לבצע עסקאות בתשלומים על פי רשימת כרטיסים תקפים של ישראכרט‬
‫‪ - 139‬מספר תשלומים גדול מידי על פי רשימת כרטיסים תקפים של ישראכרט‬
‫‪ - 140‬כרטיסי ויזה ודיינרס לא רשאים לבצע עסקאות מועדון בתשלומים‬
‫‪ - 141‬סידרת כרטיסים לא תקפה עפ"י הגדרת המערכת‪ VECTOR5) .‬של ישראכרט(‬
‫‪ - 142‬קוד שרות לא תקף עפ"י הגדרת המערכת )‪ VECTOR6‬של ישראכרט(‬
‫‪ - 143‬קידומת הכרטיס )‪ 2‬ספרות( לא תקפה עפ"י הגדרת המערכת‪ VECTOR7) .‬של ישראכרט(‬
‫‪ - 144‬קוד שרות לא תקף עפ"י הגדרת המערכת‪ VECTOR12) .‬של ויזה(‬
‫‪ - 145‬קוד שרות לא תקף עפ"י הגדרת המערכת‪ VECTOR13) .‬של ויזה(‬
‫ארקום מערכות ממוחשבות בע"מ ת‪.‬ד‪ 3002 .‬חדרה ‪ 38130‬טלפון ‪ 04-6222830 072-2753000‬פקס ‪www.arkom.co.il 04-6222840‬‬
‫מסמך זה הינו רכוש ארקום‪ .‬המידע הכלול במסמך זה הינו מידע פנימי‪ .‬העתקה‪ ,‬הפצה ו‪/‬או כל שימוש אחר במסמך או חלקים ממנו‪ ,‬אסורים לחלוטין‪.‬‬
‫עמוד ‪ 19‬מתוך ‪22‬‬
‫ארקום‬
‫מערכות ממוחשבות בע"מ‬
‫‪10/07/2011‬‬
‫‪ - 146‬לכרטיס חיוב מיידי אסור לבצע עסקת זכות‬
‫‪ - 147‬כרטיס לא רשאי לבצע עסקאות בתשלומים עפ"י וקטור ‪ 31‬של לאומיקארד‬
‫‪ - 148‬כרטיס לא רשאי לבצע עסקאות טלפוניות וחתימה בלבד עפ"י ווקטור ‪ 31‬של לאומיקארד‬
‫‪ - 149‬כרטיס אינו רשאי לבצע עסקאות טלפוניות עפ"י וקטור ‪ 31‬של לאומיקארד‬
‫‪ - 150‬אשראי לא מאושר לכרטיסי חיוב מיידי‬
‫‪ - 151‬אשראי לא מאושר לכרטיסי חו"ל‬
‫‪ - 152‬קוד מועדון לא תקין‬
‫‪ - 153‬כרטיס לא רשאי לבצע עסקאות אשראי גמיש )עדיף ‪ (/30+‬עפ"י הגדרת המערכת‪ VECTOR21) .‬של דיינרס(‬
‫‪ - 154‬כרטיס לא רשאי לבצע עסקאות חיוב מיידי עפ"י הגדרת המערכת‪ VECTOR21) .‬של דיינרס(‬
‫‪ - 155‬סכום המינימלי לתשלום בעסקת קרדיט קטן מידי‬
‫‪ - 156‬מספר תשלומים לעסקת קרדיט לא תקין‬
‫‪ - 157‬תקרה ‪ 0‬לסוג כרטיס זה בעסקה עם אשראי רגיל או קרדיט‬
‫מיידי‬
‫‪ - 158‬תקרה ‪ 0‬לסוג כרטיס זה בעסקה עם אשראי חיוב‬
‫‪ - 159‬תקרה ‪ 0‬לסוג כרטיס זה בעסקת חיוב מיידי בדולרים‬
‫‪ - 160‬תקרה ‪ 0‬לסוג כרטיס זה בעסקה טלפונית‬
‫‪ - 161‬תקרה ‪ 0‬לסוג כרטיס זה בעסקת זכות‬
‫‪ - 162‬תקרה ‪ 0‬לסוג כרטיס זה בעסקת תשלומים‬
‫‪ - 163‬כרטיס אמריקן אקספרס אשר הונפק בחו"ל לא רשאי לבצע עסקאות בתשלומים‬
‫‪ - 164‬כרטיסי‪ JCB‬רשאי לבצע עסקאות רק באשראי רגיל‬
‫‪ - 165‬סכום בכוכבים‪/‬נקודות‪/‬מיילים גדול מסכום העסקה‬
‫‪ - 166‬כרטיס מועדון לא בתחום של המסוף‬
‫‪ - 167‬לא ניתן לבצע עסקת כוכבים‪/‬נקודות‪/‬מיילים בדולרים‬
‫‪ - 168‬למסוף אין אישור לעסקה דולרית עם סוג אשראי זה‬
‫‪ - 169‬לא ניתן לבצע עסקת זכות עם אשראי שונה מהרגיל‬
‫‪ - 170‬סכום הנחה בכוכבים‪/‬נקודות‪/‬מיילים גדול מהמותר‬
‫‪ - 171‬לא ניתן לבצע עסקה מאולצת לכרטיס‪/‬אשראי חיוב מיידי‬
‫‪ - 172‬לא ניתן לבטל עסקה קודמת )עסקת זכות או מספר כרטיס אינו זהה(‬
‫‪ - 173‬עסקה כפולה‬
‫‪ - 174‬למסוף אין אישור להצמדה למדד לאשראי זה‬
‫‪ - 175‬למסוף אין אישור להצמדה לדולר לאשראי זה‬
‫‪ - 176‬כרטיס אינו תקף עפ"י הגדרת ה מערכת )וקטור ‪ 1‬של ישראכרט(‬
‫‪ - 177‬בתחנות דלק לא ניתן לבצע "שרות עצמי" אלא "שרות עצמי בתחנות דלק"‬
‫‪ - 178‬אסור לבצע עסקת זכות בכוכבים‪/‬נקודות‪/‬מיילים‬
‫‪ - 179‬אסור לבצע עסקת זכות בדולר בכרטיס תייר‬
‫‪ - 180‬בכרטיס מועדון לא ניתן לבצע עסקה טלפונית‬
‫‪ - 200‬שגיאה יישומית‬
‫ארקום מערכות ממוחשבות בע"מ ת‪.‬ד‪ 3002 .‬חדרה ‪ 38130‬טלפון ‪ 04-6222830 072-2753000‬פקס ‪www.arkom.co.il 04-6222840‬‬
‫מסמך זה הינו רכוש ארקום‪ .‬המידע הכלול במסמך זה הינו מידע פנימי‪ .‬העתקה‪ ,‬הפצה ו‪/‬או כל שימוש אחר במסמך או חלקים ממנו‪ ,‬אסורים לחלוטין‪.‬‬
‫עמוד ‪ 20‬מתוך ‪22‬‬
‫ארקום‬
‫מערכות ממוחשבות בע"מ‬
‫‪10/07/2011‬‬
‫‪901‬‬
‫‪902‬‬
‫‪903‬‬
‫‪904‬‬
‫‪905‬‬
‫‪906‬‬
‫‪911‬‬
‫‪912‬‬
‫‪913‬‬
‫‪914‬‬
‫‪915‬‬
‫‪916‬‬
‫‪917‬‬
‫‪918‬‬
‫‪919‬‬
‫‪920‬‬
‫‪921‬‬
‫‪922‬‬
‫‪923‬‬
‫‪998‬‬
‫‪999‬‬
‫שגיאה בהעברת נתונים‬
‫לא נמצאה תוצאת עסקה‪ ,‬נסה שוב מאוחר יותר‬
‫שגיאה כללית במשלוח שוברי עסקה‬
‫שגיאה במשלוח שובר עסקה עותק בית העסק‬
‫שגיאה במשלוח שובר עסקה עותק לקוח‬
‫שגיאה במשלוח נתוני רישום‬
‫שגיאת פיענוח או עיבוד נתונים‬
‫מסוף לא פעיל‬
‫מסוף אינו רשאי להפעיל אסימונים‬
‫שגיאה לא מוגדרת בתפעול אסימונים‬
‫המסוף ניצל את כל מיכסת האסימונים המוקצבת לו‬
‫מספר השורות בקובץ גדול מ ‪ ,9999‬נא לפצל לקבצים קטנים יותר‬
‫בעיה בפיענוח קובץ חיובים מרובה שורות‬
‫לא נמצא בסיס נתונים להעברה‬
‫כישלון ביצירת בסיס נתונים מכווץ להעברה‬
‫שגיאה בטיפול בחיווי גמר פעילות עם בסיס נתונים‬
‫המסוף אינו רשאי לבצע פעולה זו‬
‫אסימון או כרטיס לא קיים‬
‫אסימון או כרטיס כבר קיים‬
‫שגיאה פנימית בתהליך רישום סטטוס פעולה )‪(WS‬‬
‫שרת או שירות אינו זמין‬
‫ארקום מערכות ממוחשבות בע"מ ת‪.‬ד‪ 3002 .‬חדרה ‪ 38130‬טלפון ‪ 04-6222830 072-2753000‬פקס ‪www.arkom.co.il 04-6222840‬‬
‫מסמך זה הינו רכוש ארקום‪ .‬המידע הכלול במסמך זה הינו מידע פנימי‪ .‬העתקה‪ ,‬הפצה ו‪/‬או כל שימוש אחר במסמך או חלקים ממנו‪ ,‬אסורים לחלוטין‪.‬‬
‫עמוד ‪ 21‬מתוך ‪22‬‬
‫ארקום‬
‫מערכות ממוחשבות בע"מ‬
‫‪10/07/2011‬‬
‫נספח עבודה במט"ח‬
‫בעת העברת עסקה לביצוע בשרת יש לשים לב לשימוש נכון בשדה המטבע‪.‬‬
‫העבודה מתבססת על העברת מאפיין המטבע בשדה ‪ TransCurrency‬עפ"י המפרט הבא‪:‬‬
‫•‬
‫•‬
‫•‬
‫•‬
‫•‬
‫‪ – 0‬המטבע יהיה מטבע עפ"י תקן ‪ISO-4217‬‬
‫‪ – 1‬שקל‬
‫‪ – 2‬דולר ארה"ב )‪(USD‬‬
‫‪ – 4‬עסקת תשלומים צמודים לדולר‬
‫‪ – 8‬עסקת תשלומים צמודים למדד‬
‫במידה והעסקה הינה עסקת תשלומים לא ניתן עפ"י הגדרתה לבצעה במטבע אחר זולת שקל ומכאן שהשימוש בשדה המאפיין‬
‫את המטבע ‪ TransCurrency‬משמש בתפקיד כפול – קביעת אופי התשלומים או סוג המטבע‬
‫במידה וסומן קוד מטבע ‪ ISO‬אזי המערכת תבדוק את קוד המטבע בשדה ‪ ISO_CURRENCY‬עפ"י המפרט הבא‪:‬‬
‫‪Australian dollar‬‬
‫‪Canadian dollar‬‬
‫‪Danish kroner‬‬
‫‪Hong Kong dollar‬‬
‫‪Indian rupee‬‬
‫‪Japanese yen‬‬
‫‪Jordanian dinar‬‬
‫‪Norwegian kroner‬‬
‫‪Singapore dollar‬‬
‫‪South African rand‬‬
‫‪Swedish kroner‬‬
‫‪Swiss franc‬‬
‫‪Egyptian pound‬‬
‫‪Pound sterling‬‬
‫‪Turkish lira‬‬
‫‪Euro‬‬
‫•‬
‫•‬
‫|‬
‫|‬
‫|‬
‫|‬
‫|‬
‫|‬
‫|‬
‫|‬
‫|‬
‫|‬
‫|‬
‫|‬
‫|‬
‫|‬
‫|‬
‫|‬
‫‪036‬‬
‫‪124‬‬
‫‪208‬‬
‫‪344‬‬
‫‪356‬‬
‫‪392‬‬
‫‪400‬‬
‫‪578‬‬
‫‪702‬‬
‫‪710‬‬
‫‪752‬‬
‫‪756‬‬
‫‪818‬‬
‫‪826‬‬
‫‪949‬‬
‫‪978‬‬
‫|‬
‫|‬
‫|‬
‫|‬
‫|‬
‫|‬
‫|‬
‫|‬
‫|‬
‫|‬
‫|‬
‫|‬
‫|‬
‫|‬
‫|‬
‫|‬
‫‪AUD‬‬
‫‪CAD‬‬
‫‪DKK‬‬
‫‪HKD‬‬
‫‪INR‬‬
‫‪JPY‬‬
‫‪JOD‬‬
‫‪NOK‬‬
‫‪SGD‬‬
‫‪ZAR‬‬
‫‪SEK‬‬
‫‪CHF‬‬
‫‪EGP‬‬
‫‪GBP‬‬
‫‪TRY‬‬
‫‪EUR‬‬
‫יש לשים לב כי דולר ארה"ב אינו מועבר כמטבע ‪ ISO‬אלא ברמת השדה המאפיין ‪TransCurrency‬‬
‫העברת קוד המטבע לפונקציה תהיה עפ"י קוד מטבע ‪ ISO‬כגון ‪ CAD AUD‬וכו'‬
‫ארקום מערכות ממוחשבות בע"מ ת‪.‬ד‪ 3002 .‬חדרה ‪ 38130‬טלפון ‪ 04-6222830 072-2753000‬פקס ‪www.arkom.co.il 04-6222840‬‬
‫מסמך זה הינו רכוש ארקום‪ .‬המידע הכלול במסמך זה הינו מידע פנימי‪ .‬העתקה‪ ,‬הפצה ו‪/‬או כל שימוש אחר במסמך או חלקים ממנו‪ ,‬אסורים לחלוטין‪.‬‬
‫עמוד ‪ 22‬מתוך ‪22‬‬