מרכז הידע / ממשקים API

שאלו את ה-AI

✦ תשובת ה-AI

חושב…

מקורות

    Financial - עסקאות מקור - (CreditCard Transactions)

    מתי להשתמש בפונקציה זו?

    הפונקציה הזאת מספקת מידע מתאריך לתאריך המופיע בדוחות חברת האשראי, ומציגה את העסקאות המקור.

    עסקאות המקור כוללות את כל העסקאות שעברו עיבוד ומיועדות להיכנס לחשבון הבנק של העסק.  הפונקציה גם מראה את זמני השידור ביחד עם כמה מפרטי העסקאות.

    להלן קישור לפונקציה בJSON.

    שיטת בקשה - POST.
    CreditCard Transactions

    https://secure.cardcom.solutions/api/v11/Financial/CreditCardTransactions

    להלן הפרמטרים שצרים להעביר בפונקציה .

    מקרא:

    פרמטר אדום - חובה

    פרמטר מודגש - מומלץ

    פרמטר לא אדום ולא מודגש - אופציונלי

    מספר
         		פרמטר ערכים אפשריים לדוגמא תיאור
    1 ApiName "kzFKfohEvL6AOF8aMEJz" שם API.
    2 ApiPassword "FIDHIh4pAadw3Slbdsjg" סיסמת API.
    3 FromCreateDate "25032025" למצוא עסקאות מתאריך X.
    4 ToCreateDate "26032025" למצוא עסקאות עד תאריך Y
    5 Page 1 מאיזה עמוד למשוך את פרטי רשימת העסקאות .
    6 Page_size 20 מה יהיה כמות השורות בעמוד שמהם אנחנו נמשוך את פרטי רשימת העסקאות.

     

    RESPONSE של CreditCard Transactions.

    מספר
         		פרמטר ערכים אפשריים לדוגמא תיאור
    1 ResponseCode 0 קוד תשובה, אם שווה לאפס הפונקציה בוצעה בצורה תקינה. בכל תשובה אחרת, הפעולה לא הייתה תקינה.
    2 Description "OK" תיאור התשובה. ''OK'' זה טוב.
    3 Page 1 מאיזה עמוד למשוך את פרטי רשימת העסקאות .
    4 Page_size 20 מה יהיה כמות השורות בעמוד שמהם אנחנו נמשוך את פרטי רשימת העסקאות.

    ערכים של CreditCardTransactions (5).

    מערך של אובייקטים.

    מספר
         		פרמטר ערכים אפשריים לדוגמא תיאור
    1 Id (Int) מזהה עסקת אשראי פנימי.
    2 SapakNumber (Int) מספר ספק קארדקום.
    3 ARN (String) "2135146546" מזהה סולק, בחברת האשראי הסולקת.
    4 TransacDate (String) "2025-02-28T00:00:00" תאריך עסקה.
    5 TransacTime (String) "06:28:19" שעת עסקה.
    6 TransmissionDate (String) "2025-03-01T00:00:00" תאריך שידור עסקה.
    7 TransmissionTime (String) "00:02:01" זמן שידור עסקה.
    8 TranType (String) -

    • Info_0 – "מידע" 

    • Charge_1 – "חיוב"

    • Prika_2 – "פריקה" 

    • Meulachet_3 – "מולאכת" 

    • Cashback_6 – "החזר כספי"

    • Cash_7 – "מזומן" 

    • DirectDebite_11 – "חיוב ישיר"

    • ManualCashDisbursement_12 – "הפצה ידנית של מזומן" 

    • Yitra_30 – "יתרה"

    • Refund_53 – "החזר"

    • Recharge_55 – "טעינה"

    		 סוג עסקה.
    9 Rrn (String) "5149847" מזהה סולק מול מנפיק.
    10  Amount (Number) 116   מחיר עסקה.
    11 FirstPayment (Number)   תשלום ראשון 
    12  NotFirstPayment (Number)  יתרת תשלומים לאחר התשלום הראשון 
    13 NoPayments (Int)  מספר התשלומים
    14  IndexPayment (Int)  אינדקס התשלום
     15 Agg_PayDay (String) יום תשלום מצטבר
    16  Agg_IfPac (Int) האם פעימה מצטברת
    17 ActionCode (String)

    • NoActionCode – "לא קוד פעולה"

    • Purchase_1 – "רכישה"

    • Return_6 – "החזרה"

    • FeeCharge_10 – "עמלת חיוב"

    • CloseTXNReturn_11 – "סגירת עסקה והחזרה"

    • CHB_15 – "חיוב CHB"

    • CHBNoMerchandis_19 – "חיוב CHB ללא סחורה"

    • FeeChargeReturn_20 – "עמלת חיוב והחזרה"

    • CloseTXN_21 – "סגירת עסקה"

    • HOLD_24 – "החזקה"

    • Cancel_25 – "ביטול"

    • RevCHB_35 – "החזר חיוב CHB"

    • Rep_45 – "שחזור"

    • OriginalRequest_51 – "בקשה מקורית"

    • CopyRequest_52 – "בקשת העתק"

    • CHB2_65 – "חיוב CHB 2"

    • CHB2NoMerchandi_69 – "חיוב CHB 2 ללא סחורה"

    • RevCHB2_75 – "החזר חיוב CHB 2"

    • BlockedCard_90 – "כרטיס חסום"

    • NEW_ISSUER_NOTIFY_ISSUANCE_CARD_91 – "הנפקת כרטיס - הודעת ספק חדש"

    • OLD_ISSUER_RESPONSE_FOR_NOTIFY_92 – "תגובה מהספק הישן להודעה"

    • FRAUD_93 – "הונאה"

    • CANCEL_STANDING_ORDER_94 – "ביטול הוראת קבע"

    • CHANGE_CARD_STANDING_ORDER_95 – "שינוי הוראת קבע בכרטיס"

    • ISSUER_CANCEL_STANDING_ORDER_96 – "ביטול הוראת קבע על ידי הספק"

    • RESUME_CARD_97 – "החזרת כרטיס לפעולה"

    • CHANGE_NOT_ACTIVATED_CARD_98 – "שינוי כרטיס שלא הופעל"

    • CBH_SECOND_FULL_205 – "CBH שני מלא"

    • CBH_SECOND_PARTIAL_282 – "CBH שני חלקי"

    • CBH_FIRST_FULL_450 – "CBH ראשון מלא"

    • CBH_FIRST_FULL_451 – "CBH ראשון מלא"

    • CBH_FIRST_PARTIAL_453 – "CBH ראשון חלקי"

    • CBH_FIRST_PARTIAL_454 – "CBH ראשון חלקי"

    • PrePayment_1001 – "תשלום מראש"

    • PrePaymentFutureDebts_1002 – "תשלום מראש חובות עתידיים"

    • CHBCommition_1003 – "עמלת CHB"

    • CancelMTI520Commition_1004 – "ביטול עמלת MTI520"

    • RefundAC6Commition_1005 – "החזר עמלת AC6"

    • NotUsedRefundsSum_2001 – "סכום החזר שלא שולם"

    • GetMoneyFromMerchant_2002 – "קבלת כסף מסוחר"

    • FixVat_2003 – "תיקון מע"מ"

    • InternalTransactionRecalc_9001 – "חישוב מחדש של עסקה פנימית"

    		 קוד פעולה
    18  Last4Digits (Int) 4187 ארבע הספרות האחרונות
    19 First7Digits (Int) 1254879 שבע הספרות הראשונות
    20  Uid (String)

    מזהה עסקה יחודי.

    במידה ועשו הכחשה \ זיכוי \ ביטול מתוך העסקה, הUID של הפעולה החדשה הזאת יהיה זהה לעסקה המקורית.

    אם עשו זיכוי מחוץ לעסקה, למשל כעסקה חדשה עם אסימון, הUID יהיה חדש.
    21 Mti (String)

    • Request_100 – "בקשה"

    • RequestRepeat_101 – "בקשה חוזרת"

    • ResponseToRequest_110 – "תשובה לבקשה"

    • RequestCancel_400 – "ביטול בקשה"

    • ResponseToRequestCancel_410 – "תשובה לביטול בקשה"

    • RequestReversal – "בקשת הפיכה"

    • ResponseToRequestReversal_430 – "תשובה לבקשת הפיכה"

    • CreditCardCharge_500 – "חיוב כרטיס אשראי"

    • CreditRefund_520 – "החזר אשראי"

    • Info_540 – "מידע"

    • RequestNetwork_800 – "בקשת רשת"

    • ResponseNetwork_810 – "תשובה לרשת"

    		 סוג הודעת MTI
    22  SessionNumber (Int) מספר סשן
    23 CouponNumber (String) מספר שובר
    24  AuthorizeNo (String) מספר אישור
    25 Retailer (Int) מזהה קמעונאי
    26 Brand (String)

    • MasterCard_1 – "מאסטרקארד"

    • Visa_2 – "ויזה"

    • Diners_3 – "דינרס"

    • Amex_4 – "אמריקן אקספרס"

    • Isracard_5 – "ישראכרט"

    		 מותג (לדוגמה: MasterCard)
    27 Agg_IfPctFixAmt (Int) האם סכום קבוע פעימה מצטברת
    28 OriginCurrency (Int) מטבע המקור
    29 PaymentCurrency (Int) מטבע התשלום
    30 SapakMutavNumber (Int) מספר ספק מוטב
    31 Eci "Empty"
    "NoCavvUcaf"
    "CavvUcafNotIssuer"
    "CavvUcaf"    		 האם העסקה עברה 3DSecure
    CavvUcaf - עבר תקין 3DS

     

    להלן קוד לדוגמא לפונקציה ביחד עם התשובה.

    דוגמא לקריאה:

    {
      "ApiName": "string",
      "ApiPassword": "string",
      "FromCreateDate": "string",
      "ToCreateDate": "string",
      "Page": 0,
      "Page_size": 0
    }

     

     

    דוגמא לתשובה המתקבלת:

    {
      "ResponseCode": 0,
      "Description": "string",
      "Page": 0,
      "Page_size": 0,
      "CreditCardTransactions": [
        {
          "Id": 0,
          "SapakNumber": 0,
          "ARN": "string",
          "TransacDate": "2019-08-24T14:15:22Z",
          "TransacTime": "string",
          "TransmissionDate": "2019-08-24T14:15:22Z",
          "TransmissionTime": "string",
          "TranType": "Info_0",
          "Rrn": "string",
          "Amount": 0,
          "FirstPayment": 0,
          "NotFirstPayment": 0,
          "NoPayments": 0,
          "IndexPayment": 0,
          "Agg_PayDay": "2019-08-24T14:15:22Z",
          "Agg_IfPac": 0,
          "ActionCode": "NoActionCode",
          "Last4Digits": 0,
          "First7Digits": 0,
          "Uid": "string",
          "Mti": "Request_100",
          "SessionNumber": 0,
          "CouponNumber": "string",
          "AuthorizeNo": "string",
          "Retailer": 0,
          "Brand": "MasterCard_1",
          "Agg_IfPctFixAmt": 0,
          "OriginCurrency": 0,
          "PaymentCurrency": 0,
          "SapakMutavNumber": 0
        }
      ]
    }

    האם המאמר הזה עזר לך?