Transaction List (Extended)

Get a detailed list of transactions with full information.

Endpoint Information

Name: Get Transaction List (Extended)
Method: GET
URL: {{BASE_URL}}/api/v1/transactions/list

Authentication

Type: Basic Auth

• Username: App Key
• Password: Secret Key

Query Parameters

Parameter	Type	Required	Default	Description
merchantAccountId	string	Yes	-	Your merchant account ID
page	integer	No	1	Page number for pagination
status	string	No	-	Filter by status (e.g., Declined, Accepted)
filterByRef	string	No	-	Filter by transaction reference

Example Request

GET {{BASE_URL}}/api/v1/transactions/list?merchantAccountId=100001&page=1&status=Declined

Response

Success Response

{
"success": true,
"message": "Transaction list",
"data": [
  {
    "merchantId": 123,
    "transactionId": "Re0hIIzQMq",
    "txAmount": 50,
    "txFee": 0,
    "txTotalAmount": 50,
    "txCurrency": "USD",
    "baseAmount": 50,
    "baseFeeAmount": 0,
    "baseTotalAmount": 50,
    "baseCurrency": "USD",
    "status": "Declined",
    "statusCode": "",
    "errorMsg": "",
    "customerBrowserAgent": "Mozilla/5.0...",
    "initialPsp": "Trust Payments",
    "finalPsp": "Trust Payments",
    "paymentType": "Card",
    "txType": "VISA",
    "txMethod": "Deposit",
    "maskedPan": "411111XXXXXX1111",
    "customerEmail": "[email protected]",
    "customerFirstName": "John",
    "customerLastName": "Doe",
    "customerCountry": "AL",
    "customerIpAddr": "103.187.94.96",
    "subStatus": "Refunded", // "Partially Refunded"
    "created": "2025-09-16 10:22:56",
    "updated": "2025-09-16 10:22:58"
  }
],
"pagination": {
  "total": 50,
  "current_items_count": 15,
  "items_per_page": 15,
  "current_page_no": 1,
  "last_page_no": 4,
  "has_more_pages": true
}
}

Response Fields (Key Fields)

Field	Type	Description
transactionId	string	Unique transaction ID
txAmount	number	Transaction amount
txCurrency	string	Transaction currency
status	string	Current status of the transaction
subStatus	string	Transaction sub-status (e.g., Refunded, Partially Refunded)
initialPsp	string	The Payment Service Provider initially attempted
finalPsp	string	The PSP that processed the final attempt
maskedPan	string	Masked card number
customerEmail	string	Customer's email
created	string	Creation timestamp
errorMsg	string	Error message if declined