קבלת מידע על הכחשות עסקה, ביטול מנוי וכשל תמורה. הודעות סליקה. - (Special Transactions)
מתי להשתמש בפונקציה זו?
אם בית העסק סולק דרכנו, מומלץ תמיד להשתמש בפונקציה זו. הפונקציה מספקת מידע, אם יש כזה, על כשלי תמורה, הכחשות עסקה וביטולי מנוי שבוצעו על עסקאות של בית העסק.
במקרה שבוצעה פעולה כזו על אחת מהעסקאות, בית העסק יהיה מודע לכך ויוכל לפעול בהתאם.
כמובן, כל זה רלוונטי רק אם בית העסק מעוניין לנהל את הכל בעצמו. בממשק של קארדקום קיימת אפשרות לצפות בעסקאות אלו בדוחות חברת האשראי, בתפריט: חברת אשראי -> 1 -> 1.
מה מקבלים מהפונקציה הזאת?
את כל הפרטים של העסקה המקורית ביחד עם ההודעת הכחשה שמתלווה אליה.
להלן קישור לפונקציה בJSON.
שיטת בקשה - POST.
https://secure.cardcom.solutions/api/v11/Transactions/SpecialTransactions
להלן הפרמטרים שצרים להעביר בפונקציה Refund By Transaction Id.
מקרא:
פרמטר אדום - חובה
פרמטר מודגש - מומלץ
פרמטר לא אדום ולא מודגש - אופציונלי
|
מספר |
פרמטר | ערכים אפשריים לדוגמא | תיאור |
| 1 | ApiName | "test2025" | שם API. |
| 2 | ApiPassword | "test5000$" | סיסמת API. |
| 3 | FromDate | "19032025" | ההודעות שהתקבלו מתאריך. |
| 4 | ToDate | "21032025" | ההודעות שהתקבלו עד תאריך. |
RESPONSE של Special Transactions.
|
מספר |
פרמטר | ערכים אפשריים לדוגמא | תיאור |
| 1 | ResponseCode | 0 | 0 - הפעולה תקינה ,אחרת שגוי - שגיאת פיתוח. |
| 2 | Description | "העסקה בוצעה בהצלחה" | תיאור התשובה , במידה ומתקבל תשובה שונה, העסקה לא בוצעה בהצלחה. |
ערכים של SpecialTransactions (3).
מערך של אובייקטים.
|
מספר |
פרמטר | ערכים אפשריים לדוגמא | תיאור |
| 1 | CreateDate | "2025-03-20T18:39:11.983" | תאריך קבלת ההודעת הכחשה. |
| 2 | SpecialType |
15 19 65 69 - זה ביטול חיוב / הכחשת עסקה. 35 75 45 - ביטול של הכחשת עסקה REV קבלת הכסף בחזרה 51 52 - בקשה לשובר ממנפיק. |
מיועד להתאמות אשראי , מציג את הסיבה של התנועה הכספית |
| 3 | SpecialTypeDesc |
15 - CHB(15) 19 - כשל תמורה CHB 65 - CHB 2 (65) 69 - CHB2 כשל תמורה (69) 10 - גביית תשלום עמלה על טיפול מיוחד (10) 20 - החזרת גבייה עמלה (20) 11 -ביטול זיכוי בגין סגירת עסקה 21 - זיכוי בגין סגירת עסקה 25 - ביטול עסקת חיוב 35 - Reversal CHB 75 - Reversal CHB2 45 - REP לעסקת חיוב (45) 24 - עצירה (24) 51 - בקשת אספקת שובר מקורי 52 - בקשת אספקת שובר העתק 9001 - חישוב מחדש של תנועה |
מיועד להתאמות אשראי תיאור מילולי של SpecialType. |
| 4 | SpecialTypeSubType | 41 |
מיועד להתאמות אשראי תת קוד של SpecialType |
| 5 | Description | "ביטול הוראת קבע – מנוי" \ "לקוח מתכחש לעסקה" \ "כשל תמורה – אי קבלת מוצר/שירות – עסקה רגילה" |
תיאור מילולי שמסביר את סיבת התנועה (SpecialType +SpecialTypeSubType ) |
| 6 | Amount |
-175.20 150.50 |
Amount שלילי – לקחו כסף מבית העסק Amount חיוב – נתנו כסף לבית העסק |
| 7 | OriginlTranAmount | 100 |
סכום עסקה מקורי |
| 8 | ARN | "22707515052285" |
מיועד להתאמות אשראי מזהה יחודי חברה סולקת |
| 9 | UID | "2505073844" | מזהה עסקה של ש.ב.א/ מכשיר / POS |
| 10 | SapakNumber | 1075479 |
מספר ספק שעבור בוצעה הפעולה במידה ועשו הכחשה \ זיכוי \ ביטול מתוך העסקה, הUID של הפעולה החדשה הזאת יהיה זהה לעסקה המקורית. אם עשו זיכוי מחוץ לעסקה, למשל כעסקה חדשה עם אסימון, הUID יהיה חדש. |
| 11 | TranzactionId | 201724409 |
מספר יחודי של קרארדקום של הפעולה , רק אם החיוב בוצע ערך המסוף של קארדקום ( לא חובה שיהיה ערך) |
| 12 | Last4CardDigits | "5581" |
4 ספרות אחרונות |
| 13 | MarkedAsRead | boolean - true \ false | האם סומן שנקרא / טופל דרך מערכת ה UI של קארדקום. |
| 14 | CurrencyISO | 1 - שקל
2 - דולר לקודי מטבע נוספים - רשימת קודי מטבעות |
מטבע הסכום |
| 15 | CardToken | "cd804-81f-45-a3-fea3480" | טוקן כרטיס |
| 16 | OriginlTranDate | NULL | תאריך מקורי של העסקה שעבורה בוצע שינוי החיוב |
| 17 | SpecialTranDate | "2024-11-19T00:00:00" | תאריך דיווח התנועה ( לדומה מחזיק הכרטיס התקשר ביום שישי להתלונן על עסקה לא תקינה) |
| 18 | SapakMutavNumber | 1234 | מספר לקוח בעבודה ברב מוטב |
להלן קוד לדוגמא לפונקציה ביחד עם התשובה.
דוגמא לבקשת מידע על הודעות מערכת.
דוגמא לתשובה המתקבלת: