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.
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. | Parameter | Example values | Description |
|---|---|---|---|
| 1 | TerminalNumber | "1000" | Terminal number – the internal terminal number, not the acquiring terminal number. |
| 2 | UserName | "test2025" | API user name. |
| 3 | UserPassword | "test5000$" | API password. |
| 4 | InternalDealNumber | 204961310 | Internal transaction number. |
Get Transaction Info By Id response
| No. | Parameter | Example values | Description |
|---|---|---|---|
| 1 | ResponseCode | 0 | 0 – the operation was successful. Any other value indicates an error, such as a development error. |
| 2 | Description | "The transaction was completed successfully" | Response description. If a different response is received, the transaction was not completed successfully. |
| 3 | TranzactionId | 204961310 | Unique ID of the transaction created when the credit card was charged. The response size may be Int64/BigInt. |
| 4 | TerminalNumber | 1000 | Terminal number. |
| 5 | Amount | 200.0 | Amount to charge; up to two digits after the decimal point. |
| 6 | CoinId | 1 – shekel 2 – dollar For additional currency codes, see the Currency Code List. | Currency number. |
| 7 | CouponNumber | "38024607" | Receipt number printed on the slip. May sometimes be used for reconciliation. |
| 8 | CreateDate | "2025-03-23T09:24:02" | Transaction creation date. |
| 9 | Last4CardDigits | 0 | Last four credit card digits. INT. |
| 10 | Last4CardDigitsString | "0000" | Last four credit card digits. String. |
| 11 | FirstCardDigits | 458000 | First six digits. |
| 12 | JParameter | "0" | J parameter—the type of verification performed on the card. |
| 13 | CardMonth | 10 | Card expiration month. |
| 14 | CardYear | 27 | Card expiration year. |
| 15 | ApprovalNumber | "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. |
| 16 | FirstPaymentAmount | 0 | First payment amount. |
| 17 | ConstPaymentAmount | 0 | Amount of each additional payment. |
| 18 | NumberOfPayments | 1 | Number of payments. |
| 19 | CardInfo | "Israeli" | Card type. |
| 20 | CardOwnerName | "Card Owner" | Cardholder name. |
| 21 | CardOwnerPhone | "039436100" | Cardholder phone number. |
| 22 | CardOwnerEmail | "t@t.com" | Cardholder email address. |
| 23 | CardOwnerIdentityNumber | "213654847" | National ID number. |
| 24 | Token | "4cf8e168-261e-4613-8d20-000332986b24" | Token number. It is recommended to save it in the database. |
| 25 | CardName | "Visa Classic" | Card name. |
| 26 | SapakMutav | "15" | Customer number in the recurring-payment system. |
| 27 | Uid | "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. |
| 28 | ConcentrationNumber | "4568" | Deposit/concentration number. |
| 29 | DocumentNumber | 585959 | Document number. |
| 30 | DocumentType | "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. |
| 31 | Rrn | "205437814684146" | Identification number at the credit card companies. |
| 32 | Brand | "PrivateCard", "MasterCard", "Visa", "Maestro", "AmericanExpress", "Isracard", "JBC", "Discover", "Diners" | Card brand. |
| 33 | Acquire | "Unknown", "Isracard", "CAL", "Diners", "AmericanExpress", "Laumicard", "CardCom", "PayPal", "UPAY", "PayMe" | Acquiring company. |
| 34 | Issuer | "NonIsrael", "Isracard", "CAL", "Diners", "AmericanExpress", "JCB", "Laumicard" | Issuing company. |
| 35 | PaymentType | "Unknown", "Standard", "SpecialCredits", "ImmediateCharge", "CreditClub", "SuperCredit", "InstallmentCredit", "Payments", "ClubPayments" | Credit type—regular charge, payments, credit, or discounting. |
| 36 | CardNumberEntryMode | "MagneticStrip", "SelfService", "GasStationSelfService", "Contactless", "EmvContactless", "MobileContactless", "EmvMobileContactless", "MobileNumber", "Emv", "Phone", "SignatureOnly", "Internet", "Fallback", "EmptyCandidateList" | Transaction source—Internet, EMV, telephone, and so on. |
| 37 | DealType | "Information", "Debit", "Discharge", "ForcedCharge", "CashBack", "CashTransaction", "Recurring", "BalanceQuery", "Cancel", "Refund", "Recharge" | Transaction type and source—cancellation, charge, standing order, credit, and so on. |
| 38 | IsRefund | Boolean: true/false | Whether this was a credit transaction. |
| 39 | DocumentUrl | Document URL | Link to the document. |
| 40 | CustomFields – array of objects | Id – 20 Value – "value" | Values of the custom fields. |
| 41 | IsAbroadCard | Boolean: true/false | Whether 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
}