עיבוד קובץ מוחלפים באסימונים בממשקים (Get muhlafim tokens)
מתי להשתמש בפונקציה זו?
בתי עסקים אשר עובדים עם השירות של מודל מוחלפים יוכלו להשתמש בפונקציה זאת על מנת לראות את האסימונים שקיבלו עדכון או סטטוס חדש על החיוב הכולל (כגון הכחשה או הפסקת הו''ק) על מנת שהם יוכלו לדעת באיזה מצב נמצאים ההוראות קבע וכרטיסי האשראי החדשים של הלקוחות.
מה מקבלים מהפונקציה הזאת?
הטוקנים והמזהה שלהם מתעדכנים עם הפרטי אשראי החדשים.
מודלים, פעולות ודרישות נחוצות.
מודל אסימונים.
מודל מוחלפים.
מסוף ללא דרישה ל- CVV, ת''ז וסוג חיוב הוראת קבע (צריך לבקש זאת מהסולק).
לאחר יצירת אסימון, צריך לחייב אותו בפונקציה Do Transaction עם הפרמטר IsAutoRecurringPayment.
להלן קישור לפונקציה בJSON.
POST - https://secure.cardcom.solutions/api/v11/RecuringPayments/GetMuhlafimByDate
להלן הפרמטרים שצרים להעביר בפונקציה Get muhlafim tokens.
מקרא:
פרמטר אדום - חובה
פרמטר מודגש - מומלץ
פרמטר לא אדום ולא מודגש - אופציונלי
מספר | פרמטר | ערכים אפשריים לדוגמא | תיאור |
1 | apiUserName | "test2025" | שם משתמש API. |
2 | apiPassword | "test5000$" | סיסמת משתמש API. |
3 | fromDate | "2019-08-24T14:15:22Z" | מתאריך הקובץ שנקלט. |
4 | toDate | "2019-08-24T14:15:22Z" | עד תאריך הקובץ הבא שנקלט. |
RESPONSE של Get muhlafim tokens.
מספר | פרמטר | ערכים אפשריים לדוגמא | תיאור |
1 | ResponseCode | 0 | קוד תשובה, אם שווה לאפס הפונקציה בוצעה בצורה תקינה. בכל תשובה אחרת, הפעולה לא הייתה תקינה. |
2 | Description | "OK" | תיאור התשובה. ''OK'' זה טוב. |
3 | UpdateList מערך של אובייקטים. | ID - INT ------------------------------------------ UpdatedTokenList - מערך של אובייקטים | ID - מספר מזהה של קובץ מוחלפים ---------------------------- UpdatedTokenList - רשימת אסימונים מעודכנים. |
ערכים של UpdatedTokenList.
מערך של אובייקטים.
מספר | פרמטר | ערכים אפשריים לדוגמא | תיאור |
1 | ID | INT | מזהה קובץ (זהה למזהה של אובייקט האב). |
2 | ExcelRow | INT | מספר שורה בקובץ אקסל |
3 | OriginalStatus | תלוי בחברה סולקת | סטטוס מקור מחברה סולקת |
4 | Status | סטטוס במערכת קארדקום. | 1 - התקבל מספר מוחלף |
5 | Token | AA-BB-CC | אסימון. אם האסימון שהתקבל ריק , זה אומר שלא מצאנו טוקן לעדכון , ככול הנראה הבית עסק עדכן אשראי ידני . - הטוקן נשאר אותו טוקן אנו מעדכנים בצד שרת את האשראי מאחוריו. |
6 | NewExpirationDateYYYY | 2022 | שנת תוקף כרטיס חדש |
7 | NewExpirationDateMM | 10 | חודש תוקף כרטיס חדש |
8 | Last4Digits | 1234 | 4 ספרות אחרונות של מספר כרטיס אשראי החדש |
להלן קוד לדוגמא לפונקציה.
קריאת POST לקבלת המוחלפים לאסימונים:
{
"apiUserName": "test2025",
"apiPassword": "test5000$",
"fromDate": "2019-08-24T14:15:22Z",
"toDate": "2019-08-24T14:15:22Z"
}דוגמא לתשובה המתקבלת:
{
"ResponseCode": 0,
"Description": "string",
"UpdateList": [
{
"ID": 0,
"UpdatedTokenList": [
{
"ID": 0,
"ExcelRow": 0,
"OriginalStatus": "string",
"Status": 0,
"Token": "string",
"NewExpirationDateYYYY": "string",
"NewExpirationDateMM": "string",
"Last4Digits": "string"
}
]
}
]
}