קבלת מידע על עסקה שנעשתה לפי מספר עסקה פנימי - (Get Transaction Info By Id)
מתי להשתמש בפונקציה זו?
עבור בתי עסק שמעוניינים לקבל ולאסוף מידע על עסקאות שאין להן קוד פרופיל נמוך, כגון עסקאות שבוצעו דרך דפי נחיתה, ממשק ישיר או אפילו מסוף וירטואלי, ניתן להשתמש בפונקציה זו.
פונקציה זו מיועדת לשימוש לאחר קבלת מספרי העסקה באמצעות הפונקציה 'רשימת עסקאות' (List of Transactions).
מה מקבלים מהפונקציה הזאת?
אפשר לקבל מהפונקציה את הסכום עסקה, מצב עסקה, את הארבע ספרות האחרונות, שש ספרות אחרונות, את הטוקן ועוד כמה ערכים של העסקה.
להלן קישור לפונקציה בJSON.
שיטת בקשה - POST.
https://secure.cardcom.solutions/api/v11/Transactions/GetTransactionInfoById
להלן הפרמטרים שצרים להעביר בפונקציה Get Transaction Info By Id.
מקרא:
פרמטר אדום - חובה
פרמטר מודגש - מומלץ
פרמטר לא אדום ולא מודגש - אופציונלי
מספר | פרמטר | ערכים אפשריים לדוגמא | תיאור |
1 | TerminalNumber | "1000" | מספר מסוף. - מספר מסוף פנימי לא שבא. |
2 | UserName | "test2025" | שם API. |
3 | UserPassword | "test5000$" | סיסמת API. |
4 | InternalDealNumber | 204961310 | מספר עסקה פנימית. |
RESPONSE של Get Transaction Info By Id.
מספר | פרמטר | ערכים אפשריים לדוגמא | תיאור |
1 | ResponseCode | 0 | 0 - הפעולה תקינה |
2 | Description | "העסקה בוצעה בהצלחה" | תיאור התשובה , במידה ומתקבל תשובה שונה, העסקה לא בוצעה בהצלחה. |
3 | TranzactionId | 204961310 | מספר ייחודי של עסקה שבוצעה בעת חיוב אשראי. |
4 | TerminalNumber | 1000 | מספר מסוף |
5 | Amount | 200.0 | הסכום לחיוב, ניתן עד שני תווים לאחר הנקודה. |
6 | CoinId | 1 - שקל 2 - דולר לקודי מטבע נוספים - רשימת קודי מטבעות | מספר מטבע. |
7 | CouponNumber | "38024607" | מספר שובר של הפתקית. לפעמים יכול לשמש להתאמות |
8 | CreateDate | "2025-03-23T09:24:02" | תאריך יצירת עסקה |
9 | Last4CardDigits | 0 | ארבע ספרות אחרונות של אשראי INT |
10 | Last4CardDigitsString | "0000" | ארבע ספרות אחרונות של אשראי string |
11 | FirstCardDigits | 458000 | שש ספרות ראשונות. |
12 | JParameter | "0" | J- פרמטר , סוג בדיקה לביצוע על הכרטיס |
13 | CardMonth | 10 | חודש כרטיס |
14 | CardYear | 27 | שנת כרטיס |
15 | ApprovalNumber | "12345" | מספר אישור. חיוני במקרה של J5. אם יש J5 והבית עסק ירצה לחייב מאוחר יותר את מסגרת התפוסה, המספר אישור, יהיה חיוני לחיוב המסגרת. |
16 | FirstPaymentAmount | 0 | סכום תשלום הראשון |
17 | ConstPaymentAmount | 0 | סכום מספר התשלומים הנוספים |
18 | NumberOfPayments | 1 | מספר התשלומים |
19 | CardInfo | "Israeli" | סוג הכרטיס |
20 | CardOwnerName | "Card Owner" | שם בעל הכרטיס |
21 | CardOwnerPhone | "039436100" | מספר טלפון של בעל הכרטיס |
22 | CardOwnerEmail | "t@t.com" | אימייל בעל הכרטיס |
23 | CardOwnerIdentityNumber | "213654847" | מספר תעודת זהות |
24 | Token | "4cf8e168-261e-4613-8d20-000332986b24" | מספר האסימון, חוה לשמור בבסיס הנתונים. |
25 | CardName | "ויזה רגיל" | שם כרטיס |
26 | SapakMutav | "15" | מספר לקוח בעבודה ברב מוטב |
27 | Uid | "21121517002429612920744" | מזהה עסקה יחודי. במידה ועשו הכחשה \ זיכוי \ ביטול מתוך העסקה, הUID של הפעולה החדשה הזאת יהיה זהה לעסקה המקורית. אם עשו זיכוי מחוץ לעסקה, למשל כעסקה חדשה עם אסימון, הUID יהיה חדש. |
28 | ConcentrationNumber | "4568" | מספר הפקדה / ריכוז |
29 | DocumentNumber | 585959 | מספר מסמך |
30 | DocumentType | "TaxInvoiceAndReceipt" – חשבונית מס וקבלה "TaxInvoiceAndReceiptRefund" – חשבונית זיכוי והחזר כספים "Receipt" – קבלה מלכ''ר "ReceiptRefund" – קבלה מלכ"ר זיכוי ( החזר כספים) "Quote" – הצעת מחיר "Order" – הזמנה "OrderConfirmation" – אישור הזמנה - מאתר "OrderConfirmationRefund" – זיכוי אישור הזמנה - מאתר "DeliveryNote" – תעודת משלוח "DeliveryNoteRefund" – תעודת החזרה "ProformaInvoice" – חשבון עסקה "DemandForPayment" – דרישה לתשלום "DemandForPaymentRefund" – ביטול דרישה לתשלום "ProformaDealInvoice" – חשבון קבלה פרופורמה "ProformaDealInvoiceRefund" –חשבון קבלה זיכוי "TaxInvoice" – חשבונית מס "ProformaInvoiceRefund" – זיכוי חשבון עסקה "TaxInvoiceRefund" – חשבונית מס זיכוי "ReceiptForTaxInvoice" – קבלה (לחשבונית) "DonationReceipt" – קבלה על תרומה "DonationReceiptRefund" – זיכוי קבלה תרומה (החזר כספים) "ReceiptForTaxInvoiceRefund" – החזר כספים לקוחות (קבלה זיכוי) | סוג מסמך |
31 | Rrn | "205437814684146" | מספר זיהוי אצל חברות האשראי |
32 | Brand | "PrivateCard" "MasterCard" "Visa" "Maestro" "AmericanExpress" "Isracard" "JBC" "Discover" "Diners" | מותג כרטיס |
33 | Acquire | "Unknown" "Isracard" "CAL" "Diners" "AmericanExpress" "Laumicard" "CardCom" "PayPal" "Upay" "PayMe" | חברה סולקת
|
34 | Issuer | "NonIsrael" "Isracard" "CAL" "Diners" "AmericanExpress" "JCB" "Laumicard" | חברה מנפיקה |
35 | PaymentType | "Unknown" "Standard" "SpecialCredits" "ImmediateCharge" "CreditClub" "SuperCredit" "InstallmentCredit" "Payments" "ClubPatments" | סוג אשראי - חיוב רגיל \ תשלום \ קרדיט \ ניכיון |
36 | CardNumberEntryMode | "MagneticStip" "SelfService" "GasStationSelfService" "Contactless" "EmvContactless" "MobileContactless" "EmvMobileContactless" "MobileNumber" "Emv" "Phone" "SignatureOnly" "Internet" "Fallback" "EmptyCandidateList" | מקור עסקה - אינטרנטית \ EMV \ טלפונית... |
37 | DealType | "Information" "Debit" "Discharge" "ForcedCharge" "CashBack" "CashTransaction" "Recurring" "BalanceQuery" "Cancel" "Refund" "Recharge" | סוג + מקור עסקה - ביטול \ חיוב \ הוראת קבע \ זיכוי |
38 | IsRefund | boolean - true \ false | האם זו הייתה עסקה זיכוי |
39 | DocumentUrl | נותן את הURL של המסמך | קישור למסמך. |
40 | CustomFields - מערך של אובייקטים | Id - 20 Value - "value" | הערכים של השדות המותאמים אישית. |
41 | IsAbroadCard | boolean (true\false) | האם הכרטיס הוא כרטיס מחו''ל? |
להלן קוד לדוגמא לפונקציה ביחד עם התשובה.
פונקציה לקבלת מידע על העסקה:
{
"TerminalNumber": "1000",
"UserName": "test2025",
"UserPassword": "test5000$",
"InternalDealNumber": 204961310
}
התשובה המתקבלת:
{
"ResponseCode": 0,
"Description": "העסקה בוצעה בהצלחה",
"TranzactionId": 204961310,
"TerminalNumber": 1000,
"Amount": 200.0,
"CoinId": 1,
"CouponNumber": "38024607",
"CreateDate": "2025-03-23T09:24:02",
"Last4CardDigits": 0,
"Last4CardDigitsString": "0000",
"FirstCardDigits": 458000,
"JParameter": "0",
"CardMonth": 10,
"CardYear": 27,
"ApprovalNumber": "12345",
"FirstPaymentAmount": 0.0,
"ConstPaymentAmount": 0.0,
"NumberOfPayments": 1,
"CardInfo": "Israeli",
"CardOwnerName": "Card Owner",
"CardOwnerPhone": "039436100",
"CardOwnerEmail": "",
"CardOwnerIdentityNumber": "",
"Token": "4cf8e168-261e-4613-8d20-000332986b24",
"CardName": "ויזה רגיל",
"SapakMutav": "",
"Uid": "21121517002429612920744",
"ConcentrationNumber": "0",
"DocumentNumber": null,
"DocumentType": null,
"Rrn": "",
"Brand": "Visa",
"Acquire": "Laumicard",
"Issuer": "CAL",
"PaymentType": "Standard",
"CardNumberEntryMode": "Phone",
"DealType": "Debit",
"IsRefund": false,
"DocumentUrl": null,
"CustomFields": [
{
"Id": 2,
"Value": "החבצלת 110 קרית אונו"
},
{
"Id": 3,
"Value": "Ding"
}
],
"IsAbroadCard": false
}