Get Transaction Details

Retrieves detailed information about a specific transaction.

Endpoint

GET /whitelabel/transactions/getDetails

Request Headers

x-tlp-apikey: <api-key>
x-tlp-signature: <hmac-signature>

Query Parameters

Provide at least one of the following user identifiers: endUserEmail, endUserId, or externalUserId.

Field	Type	Required	Description
endUserEmail	String	Conditional	End user’s registered email address
endUserId	Number	Conditional	Tylt end-user ID
externalUserId	String	Conditional	Merchant’s own user identifier
transactionid	Number	Yes	The transaction's identifier

Example Request

GET /whitelabel/transactions/getDetails?externalUserId=user-10021&transactionId=98765

Signed query object:

{
  "endUserId": 20001, // Optional: Provide one user identifier only
  "endUserEmail": "[e-mail]", // Optional: Alternative to endUserId and externalUserId
  "externalUserId": "user-10021", // Optional: Alternative to endUserId and endUserEmail
  "transactionId": 98765
}

Code Snippet

JavaScript (Axios)

import crypto from 'crypto';
import axios from 'axios';

const apiKey = 'your-api-key';
const apiSecret = 'your-api-secret';

const queryParams = {
    endUserId: 20001, // Optional: Provide one user identifier only
    endUserEmail: "[e-mail]", // Optional: Alternative to endUserId and externalUserId
    externalUserId: "user-10021", // Optional: Alternative to endUserId and endUserEmail
    transactionId: '2144884'
};

const rawPayload = JSON.stringify(queryParams);
const signature = crypto.createHmac('sha256', apiSecret).update(rawPayload).digest('hex');

const headers = {
    'x-tlp-apikey': apiKey,
    'x-tlp-signature': signature
};

const queryString = new URLSearchParams(queryParams).toString();
axios.get(`https://api.tylt.money/whitelabel/transactions/getDetails?${queryString}`, { headers })
    .then(response => console.log(response.data))
    .catch(error => console.error('Error:', error.response ? error.response.data : error.message));

Example Response

{
  "msg": "",
  "data": {
    "transactionId": 2144884,
    "uniqueInternalID": "7beae3e1-7b7c-11f1-a6bf-42010a2801d1",
    "merchantOrderID": "7beae3e1-7b7c-11f1-a6bf-42010a2801d1",
    "transactionType": "Internal Payin",
    "ledger": "CR",
    "baseAmount": 5,
    "baseAmountReceived": 5,
    "conversionRate": 1,
    "baseCurrency": "USDT",
    "baseCurrencyImage": "https://assets.tylt.money/holdings-icons/USDT.png",
    "settledCurrency": "USDT",
    "settledCurrencyImage": "https://assets.tylt.money/holdings-icons/USDT.png",
    "requestedCurrency": "USDT",
    "settledAmountRequested": 5,
    "settledAmountReceived": 5,
    "settledAmountDebited": 0,
    "settledAmount": 5,
    "commission": 0,
    "network": "TPNK",
    "networkImage": "https://assets.tylt.money/payment_user_assets/userUpload-74-1778065240688",
    "walletAddress": "f95bf002-3a05-4f6f-9613-ac5255c07dd4",
    "toAddress": null,
    "transactions": [
      {
        "amount": 5,
        "createdAt": "2026-07-09T09:56:41Z",
        "toAddress": "72a056e3-adcc-471b-8fbc-de79b338b381",
        "updatedAt": "2026-07-09T09:56:41Z",
        "blockNumber": 0,
        "fromAddress": "f95bf002-3a05-4f6f-9613-ac5255c07dd4",
        "confirmations": 1,
        "transactionHash": "7c4ccf19-7b7c-11f1-a6bf-42010a2801d1",
        "confirmationStatus": 1,
        "requiredConfirmations": 1
      }
    ],
    "status": "Completed",
    "insufficientBalance": null,
    "isFinal": 1,
    "isCredited": 0,
    "isDebited": null,
    "paymentURL": "",
    "callBackURL": "",
    "redirectURL": "",
    "createdAt": "2026-07-09T09:56:41Z",
    "expiresAt": "2026-07-09T09:56:41Z",
    "updatedAt": "2026-07-09T09:57:01Z",
    "toFrom": "[e-mail]",
    "comments": ""
  }
}

The exact response fields vary by transaction type.

Transaction Ownership

Tylt scopes the request by the resolved end user.

A merchant cannot retrieve a transaction that belongs to:

• Another end user

• Another merchant

• An unrelated Tylt wallet account

---