מאמר זה מסכם כיצד ניתן למשוך רשימת אסימונים לאחר ביצוע עדכון קובץ מוחלפים (קובץ המתקבל מחברת אשראי - קובץ אינפורמטיבי).
ראשית בעל העסק צריך לקלוט את קובץ ה- EXCEL מוחלפים שקיבל מחברות האשראי באתר הכספת שלהם למערכת של קארדקום.
קליטה ידנית :
ראו מדריך קליטה ידנית של מוחלפים - יבוא קובץ מוחלפים
קליטה אוטומטית :
-ניתן לבקש מהתמיכה לקבל אינטגרציה לקליטת מוחלפים אוטומטי מחברות האשראי .
-ללקוחות ש סולקים ישירות דרך קארדקום סליקה - הפעולה מתבצעת אוטומטית .
לאחר מכן, המתכנת יכול למשוך את האסימונים המחודשים לפי טווח תאריכים ,
כל השאר מתבצע בצד של קארדקום.
Web Service
כתובת ה Web Service היא : https://secure.cardcom.solutions/Interface/BillGoldService.asmx
כתובת הפונקציה היא : https://secure.cardcom.solutions/Interface/BillGoldService.asmx?op=GetMuhlafimByDate
טבלת פרמטרים להעברת בקשה GetMuhlafimByDate :
| פרמטר | תיאור | ערכים לדוגמה |
| apiUserName | שם משתמש ממשקים | TestUser |
| apiPassword | סיסמת ממשקים | password |
| fromDate | מתאריך הקובץ שנקלט | 02/01/2019 |
| toDate | עד התאריך הקובץ שנקלט | 10/01/2019 |
כל שאר הטבלאות - לא חובה להשתמש. ניתן להשתמש רק ב GetMuhlafimByDate
טבלת פרמטרים להעברת בקשה GetNewMuhlafim :
| פרמטר | תיאור | ערכים לדוגמה |
| apiUserName | שם משתמש לממשקים | TestUser |
| apiPassword | סיסמה לממשקים | password |
טבלת פרמטרים התשובה המתקבלת GetNewMuhlafim:
| פרמטר | תיאור | ערכים לדוגמה |
| ResponseCode | קוד תשובה | 0 - תקין אחר - שגיאה |
| Description | תיאור השגיאה | |
| UpdateList | רשימת קבצים מעודכנים | |
| UpdateList[x].UpdatedTokenList | אובייקט המכיל רשימת אסימונים מעודכנים | |
| UpdateList[x].ID | מספר מזהה של קובץ מוחלפים | 1 |
| UpdatedTokenList | רשימת אסימונים מעודכנים | |
| UpdatedTokenList[x].ExcelRow | מספר שורה באקסל | 3 |
| UpdatedTokenList[x].ID | מזהה קובץ (זהה למזהה של אובייקט האב) | 1 |
| UpdatedTokenList[x].OriginalStatus | סטטוס מקור מחברה סולקת | תלוי בחברה סולקת |
| UpdatedTokenList[x].Status | סטטוס במערכת קארדקום. |
1-התקבל מספר מוחלף 2- ביטול הכרטיס אשראי ללא מוחלף 3-התכחשות לעסקה 4- לקוח בקש לבטל הוראת קבע. |
| UpdatedTokenList[x].Token | אסימון. אם האסימון שהתקבל ריק , זה אומר שלא מצאנו טוקן לעדכון , ככול הנראה הבית עסק עדכן אשראי ידני . |
AA-BB-CC |
| UpdatedTokenList[x].NewExpirationDateYYYY | שנת תוקף כרטיס חדש | 2022 |
| UpdatedTokenList[x].NewExpirationDateMM | חודש תוקף כרטיס חדש | 10 |
| UpdatedTokenList[x].IsOk | האם רשומה תקינה | True |
| UpdatedTokenList[x]. Last4Digits | 4 ספרות אחרונות של מספר כרטיס אשראי החדש | 1234 |
טבלת פרמטרים להעברת בקשה UpdateMuhlafimDone:
| פרמטר | תיאור | ערכים לדוגמה |
| apiUserName | שם משתמש לממשקים | TestUser |
| apiPassword | סיסמה לממשקים | password |
| ID | מזהה קובץ | 1 |
טבלת פרמטרים התשובה המתקבלת UpdateMuhlafimDone:
| פרמטר | תיאור | ערכים לדוגמה |
| ResponseCode | קוד תשובה |
0 - תקין אחר - שגיאה |
| Description | תיאור | OK |
דוגמא לתשובה מתקבלת :
הערות
0 הערות
היכנס למערכת כדי להגיב.