Knowledge Base / API
עברית

Ask AI

✦ AI answer

Thinking…

Sources

    Get Transaction Information Using the Internal Transaction Number (Get Transaction Info By Id)

    Use this function to retrieve detailed information about a transaction by its internal transaction number, including the amount, status, card digits, token, document details, and other transaction values.

    When should this function be used?

    Businesses that want to retrieve and collect information about transactions without a low profile code—for example, transactions made through Gold Authorization Pages, a direct interface, or even a virtual terminal—can use this function.

    This function is intended for use after receiving transaction numbers through the List of Transactions function.

    What information does this function return?

    The function can return the transaction amount, transaction status, last four digits, first six digits, token, and several other transaction values.

    JSON function documentation:

    Request method: POST.

    Get Transaction Info By Id

    https://secure.cardcom.solutions/api/v11/Transactions/GetTransactionInfoById

    The following parameters must be passed to the Get Transaction Info By Id function.

    Legend:

    Red parameter – required

    Bold parameter – recommended

    Parameter that is neither red nor bold – optional

    No.ParameterExample valuesDescription
    1TerminalNumber"1000"Terminal number – the internal terminal number, not the acquiring terminal number.
    2UserName"test2025"API user name.
    3UserPassword"test5000$"API password.
    4InternalDealNumber204961310Internal transaction number.

    Get Transaction Info By Id response

    No.ParameterExample valuesDescription
    1ResponseCode00 – the operation was successful. Any other value indicates an error, such as a development error.
    2Description"The transaction was completed successfully"Response description. If a different response is received, the transaction was not completed successfully.
    3TranzactionId204961310Unique ID of the transaction created when the credit card was charged. The response size may be Int64/BigInt.
    4TerminalNumber1000Terminal number.
    5Amount200.0Amount to charge; up to two digits after the decimal point.
    6CoinId1 – shekel
    2 – dollar
    For additional currency codes, see the Currency Code List.
    Currency number.
    7CouponNumber"38024607"Receipt number printed on the slip. May sometimes be used for reconciliation.
    8CreateDate"2025-03-23T09:24:02"Transaction creation date.
    9Last4CardDigits0Last four credit card digits. INT.
    10Last4CardDigitsString"0000"Last four credit card digits. String.
    11FirstCardDigits458000First six digits.
    12JParameter"0"J parameter—the type of verification performed on the card.
    13CardMonth10Card expiration month.
    14CardYear27Card expiration year.
    15ApprovalNumber"12345"Approval number. Essential in a J5 transaction. If a J5 transaction is followed by a request to charge the held amount, the approval number is required.
    16FirstPaymentAmount0First payment amount.
    17ConstPaymentAmount0Amount of each additional payment.
    18NumberOfPayments1Number of payments.
    19CardInfo"Israeli"Card type.
    20CardOwnerName"Card Owner"Cardholder name.
    21CardOwnerPhone"039436100"Cardholder phone number.
    22CardOwnerEmail"t@t.com"Cardholder email address.
    23CardOwnerIdentityNumber"213654847"National ID number.
    24Token"4cf8e168-261e-4613-8d20-000332986b24"Token number. It is recommended to save it in the database.
    25CardName"Visa Classic"Card name.
    26SapakMutav"15"Customer number in the recurring-payment system.
    27Uid"21121517002429612920744"Unique transaction identifier. If a chargeback, credit, or cancellation is performed from the transaction, the UID of the new operation is identical to the original transaction. If a credit is made outside the transaction—for example, as a new transaction using a token—the UID is new.
    28ConcentrationNumber"4568"Deposit/concentration number.
    29DocumentNumber585959Document number.
    30DocumentType"TaxInvoiceAndReceipt" – tax invoice and receipt
    "TaxInvoiceAndReceiptRefund" – credit tax invoice and refund
    "Receipt" – nonprofit receipt without VAT
    "ReceiptRefund" – nonprofit credit receipt (refund)
    "Quote" – quotation
    "Order" – order
    "OrderConfirmation" – order confirmation (website)
    "OrderConfirmationRefund" – order confirmation credit (website)
    "DeliveryNote" – delivery note
    "DeliveryNoteRefund" – return note
    "ProformaInvoice" – transaction invoice
    "DemandForPayment" – payment demand
    "DemandForPaymentRefund" – payment demand cancellation
    "ProformaDealInvoice" – pro forma transaction receipt
    "ProformaDealInvoiceRefund" – pro forma transaction receipt credit
    "TaxInvoice" – tax invoice
    "ProformaInvoiceRefund" – transaction invoice credit
    "TaxInvoiceRefund" – tax invoice credit
    "ReceiptForTaxInvoice" – receipt for a tax invoice
    "DonationReceipt" – donation receipt
    "DonationReceiptRefund" – donation receipt credit (refund)
    "ReceiptForTaxInvoiceRefund" – customer refund (credit receipt)
    Document type.
    31Rrn"205437814684146"Identification number at the credit card companies.
    32Brand"PrivateCard", "MasterCard", "Visa", "Maestro", "AmericanExpress", "Isracard", "JBC", "Discover", "Diners"Card brand.
    33Acquire"Unknown", "Isracard", "CAL", "Diners", "AmericanExpress", "Laumicard", "CardCom", "PayPal", "UPAY", "PayMe"Acquiring company.
    34Issuer"NonIsrael", "Isracard", "CAL", "Diners", "AmericanExpress", "JCB", "Laumicard"Issuing company.
    35PaymentType"Unknown", "Standard", "SpecialCredits", "ImmediateCharge", "CreditClub", "SuperCredit", "InstallmentCredit", "Payments", "ClubPayments"Credit type—regular charge, payments, credit, or discounting.
    36CardNumberEntryMode"MagneticStrip", "SelfService", "GasStationSelfService", "Contactless", "EmvContactless", "MobileContactless", "EmvMobileContactless", "MobileNumber", "Emv", "Phone", "SignatureOnly", "Internet", "Fallback", "EmptyCandidateList"Transaction source—Internet, EMV, telephone, and so on.
    37DealType"Information", "Debit", "Discharge", "ForcedCharge", "CashBack", "CashTransaction", "Recurring", "BalanceQuery", "Cancel", "Refund", "Recharge"Transaction type and source—cancellation, charge, standing order, credit, and so on.
    38IsRefundBoolean: true/falseWhether this was a credit transaction.
    39DocumentUrlDocument URLLink to the document.
    40CustomFields – array of objectsId – 20
    Value – "value"
    Values of the custom fields.
    41IsAbroadCardBoolean: true/falseWhether the card was issued abroad.

    Example code for the function and its response:

    Function for retrieving transaction information:

    {
      "TerminalNumber": "1000",
      "UserName": "test2025",
      "UserPassword": "test5000$",
      "InternalDealNumber": 204961310
    }

    Response:

    {
      "ResponseCode": 0,
      "Description": "The transaction was completed successfully",
      "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": "Visa Classic",
      "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": "Havatzelet 110, Kiryat Ono"
        },
        {
          "Id": 3,
          "Value": "Ding"
        }
      ],
      "IsAbroadCard": false
    }

    Was this article helpful?