TAP ON PHONE -קבלת מידע על מכשיר - (PrepareDevice - Get device information before performing Tap On Phone transaction)
מתי להשתמש בפונקציה זו?
פונקציה זו נועדה לבתי עסקים שעובדים עם המודל TAP ON PHONE ורוצים לקבל מידע על המכשיר.
להלן קישור לפונקציה בJSON.
שיטת בקשה - POST.
PrepareDevice - Get device information before performing Tap On Phone transaction
https://secure.cardcom.solutions/api/v11/TapTransactions/PrepareDevice
להלן הפרמטרים שצרים להעביר בפונקציה .
מקרא:
פרמטר אדום - חובה
פרמטר מודגש - מומלץ
פרמטר לא אדום ולא מודגש - אופציונלי
|
מספר |
פרמטר | ערכים אפשריים לדוגמא | תיאור |
| 1 | ApiName | test2025 | שם משתמש ממשקים |
| 2 | ApiPassword | "kzFKfohEvL6AOF8aMEJz" | סיסמת API, מיועד לזיכוי וביטול עסקאות. |
| 3 | TerminalNumber | 1000 | המסוף שמבצע את הפעולה - מספר פנימי, לא שבא. |
| 4 | DeviceUUID | (String) | UID של המכשיר |
| 5 | DeviceManufacturer | (String) | המנפיק של הטלפון. |
| 6 | DeviceModel | (String) | מזהה ייחודי של המכשיר |
RESPONSE של ProcessTransaction - Process Tap On Phone transaction.
|
מספר |
פרמטר | ערכים אפשריים לדוגמא | תיאור |
| 1 | ResponseCode | 0 | 0 - הפעולה תקינה ,אחרת שגוי - שגיאת פיתוח. |
| 2 | Description | "העסקה בוצעה בהצלחה" | תיאור התשובה , במידה ומתקבל תשובה שונה, העסקה לא בוצעה בהצלחה. |
| 3 | TPN | (string) |
TPN עבור מכשיר TapOnPhone |
| 4 | MerchantCode | (string) | קוד סוחר עבור מכשיר tap on phone |
| 5 | SapakMutavNumber | (string) |
מספר ספק מוטב של מספר מסוף קרדקום שנשלח בבקשה |
| 6 | RavMutavTerminalNumber | (Int) |
מספר מסוף רב-מוטב של קרדקום מתוך מספר המסוף שנשלח בבקשה |
להלן קוד לדוגמא לפונקציה ביחד עם התשובה.
דוגמא לקריאה:
{
"ApiName": "string",
"ApiPassword": "string",
"TerminalNumber": 0,
"DeviceUUID": "string",
"DeviceManufacturer": "string",
"DeviceModel": "string"
}
"ApiName": "string",
"ApiPassword": "string",
"TerminalNumber": 0,
"DeviceUUID": "string",
"DeviceManufacturer": "string",
"DeviceModel": "string"
}
דוגמא לתשובה המתקבלת:
{
"ResponseCode": 0,
"Description": "string",
"TPN": "string",
"MerchantCode": "string",
"SapakMutavNumber": "string",
"RavMutavTerminalNumber": 0
}
"ResponseCode": 0,
"Description": "string",
"TPN": "string",
"MerchantCode": "string",
"SapakMutavNumber": "string",
"RavMutavTerminalNumber": 0
}