TAP ON PHONE - ביצוע עסקה - (ProcessTransaction - Process Tap On Phone transaction)
מתי להשתמש בפונקציה זו?
פונקציה זו נועדה לבתי עסקים שעובדים עם המודל TAP ON PHONE ורוצים לבצע עסקה.
להלן קישור לפונקציה בJSON.
שיטת בקשה - POST.
ProcessTransaction - Process Tap On Phone transaction
https://secure.cardcom.solutions/api/v11/TapTransactions/ProcessTransaction
להלן הפרמטרים שצרים להעביר בפונקציה .
מקרא:
פרמטר אדום - חובה
פרמטר מודגש - מומלץ
פרמטר לא אדום ולא מודגש - אופציונלי
|
מספר |
פרמטר | ערכים אפשריים לדוגמא | תיאור |
| 1 | ApiName | test2025 | שם משתמש ממשקים |
| 2 | ApiPassword | "kzFKfohEvL6AOF8aMEJz" | סיסמת API, מיועד לזיכוי וביטול עסקאות. |
| 3 | TerminalNumber | 1000 | המסוף שמבצע את הפעולה - מספר פנימי לא שבא. |
| 4 | סRavMutavTerminalNumber | (Int) | מסר מסוף של הרב מוטב. (מספר מסוף פנימי) |
| 5 | DeviceUUID | (String) | מזהה ייחודי של המכשיר |
ערכים של אובייקט TransactionInfo (6).
|
מספר |
פרמטר | ערכים אפשריים לדוגמא | תיאור |
| 1 | Amount | (String) "150" | סכום מכיר. |
| 2 | Type | (Int) 1 - חיוב, 51 - זיכוי | סוג פעולה. |
| 3 | CreditType | (Int) 1 - חיוב יחדני, 6 - קרדיט תשלומים, 8 - תשלומים רגילים. | סוג עסקת אשראי. |
| 4 | NumberOfPayments | (Int) | כמות תשלומים. |
| 5 | CustomerName | (String) | שם לקוח. |
| 6 | CustomerEmail | (String) | אימייל לקוח. |
| 7 | CustomerPhoneNumber | (String) | מספר טלפון לקוח. |
| 8 | CustomerIdNumber | (String) | ת''ז לקוח. |
| 9 | ResponseCode | (Int) | 0 - הפעולה תקינה ,אחרת שגוי - שגיאת פיתוח. |
| 10 | Message | (String) | הודעת עסקה. |
| 11 | Status | (String) | סטטוס עסקה. |
| 12 | TransactionId | (Int) | מספר עסקה. |
| 13 | ReturnCode | (Int) | קוד להחזרה לאחר עסקה. |
| 14 | ReturnMessage | (String) | ההודעה שמופיעה בחזרה ? |
| 15 | CardNumber | (String) | מספר כרטיס. |
| 16 | CardExpireDateMMYY | (String) | תאריך תפוקה של הכרטיס. |
| 17 | CardBrandCode | (Int) קוד מותג. | מותג כרטיס |
| 18 | CardIssuerCode | (Int) קוד מנפיק. | חברה מנפיקה |
| 19 | CardFinancerCode | (Int) | קוד מממן כרטיס |
| 20 | Token | (String) | הטוקן לחיוב. |
| 21 | ApprovalNumber | (String) | מספר אישור. |
| 22 | ResultRecord | (String) | רשומת תוצאה |
| 23 | UID | "21121517002429612920744" | מזהה עסקה יחודי |
RESPONSE של ProcessTransaction - Process Tap On Phone transaction.
|
מספר |
פרמטר | ערכים אפשריים לדוגמא | תיאור |
| 1 | ResponseCode | 0 | 0 - הפעולה תקינה ,אחרת שגוי - שגיאת פיתוח. |
| 2 | Description | "העסקה בוצעה בהצלחה" | תיאור התשובה , במידה ומתקבל תשובה שונה, העסקה לא בוצעה בהצלחה. |
| 3 | DealNumber | (Int) | מספר עסקה. |
להלן קוד לדוגמא לפונקציה ביחד עם התשובה.
דוגמא לקריאה:
{
"ApiName": "<string>",
"ApiPassword": "<string>",
"TerminalNumber": "<integer>",
"DeviceUUID": "<string>",
"TransactionInfo": {
"Amount": "<string>",
"Type": "<integer>",
"CreditType": "<integer>",
"NumberOfPayments": "<integer>",
"CustomerName": "<string>",
"ResponseCode": "<integer>",
"Message": "<string>",
"Status": "<string>",
"TransactionId": "<integer>",
"ReturnCode": "<integer>",
"ReturnMessage": "<string>",
"CardNumber": "<string>",
"CardExpireDateMMYY": "<string>",
"CardBrandCode": "<integer>",
"CardIssuerCode": "<integer>",
"CardFinancerCode": "<integer>",
"Token": "<string>",
"ApprovalNumber": "<string>",
"ResultRecord": "<string>",
"UID": "<string>",
"CustomerEmail": "<string>",
"CustomerPhoneNumber": "<string>",
"CustomerIdNumber": "<string>"
},
"RavMutavTerminalNumber": "<integer>"
}
דוגמא לתשובה המתקבלת:
{
"ResponseCode": 0,
"Description": "string",
"DealNumber": 0
}