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": 101,
    "transactionId": "2222211112222",
    "txAmount": 20,
    "txFee": 0,
    "txTotalAmount": 20,
    "txCurrency": "USD",
    "baseAmount": 20,
    "baseFeeAmount": 0,
    "baseTotalAmount": 20,
    "baseCurrency": "USD",
    "status": "Declined",
    "statusCode": "",
    "subStatus": "",
    "errorMsg": "Failed to initialize transaction",
    "customerBrowserAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/145.0.0.0 Safari/537.36",
    "initialPsp": "Stripe",
    "initialPspStatusCode": "",
    "initialPspRefId": "",
    "initialPspMid": "Stripe",
    "finalPsp": "Stripe",
    "finalPspStatusCode": "",
    "finalPspRefId": "",
    "finalPspMid": "Stripe",
    "paymentType": "Card",
    "txType": "VISA",
    "txMethod": "Deposit",
    "cardScheme": "VISA",
    "cardBin": 411111,
    "cardIssuer": "VISA PRODUCTION SUPPORT CLIENT BID 1",
    "cardIssuerCountry": "UNITED STATES",
    "maskedPan": "411111XXXXXX1111",
    "cardHolderName": "tes test",
    "customerEmail": "[email protected]",
    "customerFirstName": "Esse adipisicing ea",
    "customerLastName": "Dolores ut voluptas",
    "customerCountry": "US",
    "customerAddress": "Dolor sit est ipsum",
    "customerIpAddr": "3.1.1.1",
    "customerIpCountry": "Singapore",
    "customerIpRegion": "Central Singapore",
    "customerIpCity": "Singapore",
    "created": "2026-03-05 19:07:33",
    "updated": "2026-03-05 19:07:35",
    "updatedBy": "",
    "kycStatus": false
  }
],
"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
merchantId	integer	Merchant ID
transactionId	string	Unique transaction ID
txAmount	number	Transaction amount
txFee	number	Transaction fee
txTotalAmount	number	Total transaction amount (amount + fee)
txCurrency	string	Transaction currency
baseAmount	number	Base amount in merchant currency
baseFeeAmount	number	Base fee amount
baseTotalAmount	number	Base total amount
baseCurrency	string	Base currency
status	string	Current status of the transaction
statusCode	string	Status code from the platform
subStatus	string	Transaction sub-status (e.g., Refunded, Partially Refunded)
errorMsg	string	Error message if declined or failed
customerBrowserAgent	string	Customer browser user agent
initialPsp	string	Payment Service Provider initially attempted
initialPspStatusCode	string	Status code from the initial PSP
initialPspRefId	string	Reference ID from the initial PSP
initialPspMid	string	Merchant ID (MID) at the initial PSP
finalPsp	string	PSP that processed the final attempt
finalPspStatusCode	string	Status code from the final PSP
finalPspRefId	string	Reference ID from the final PSP
finalPspMid	string	Merchant ID (MID) at the final PSP
paymentType	string	Payment type (e.g., Card)
txType	string	Transaction type (e.g., VISA)
txMethod	string	Transaction method (e.g., Deposit)
cardScheme	string	Card scheme (e.g., VISA)
cardBin	integer	Card BIN
cardIssuer	string	Card issuer name
cardIssuerCountry	string	Card issuer country
maskedPan	string	Masked card number
cardHolderName	string	Cardholder name
customerEmail	string	Customer email
customerFirstName	string	Customer first name
customerLastName	string	Customer last name
customerCountry	string	Customer country code
customerAddress	string	Customer address
customerIpAddr	string	Customer IP address
customerIpCountry	string	Country derived from customer IP
customerIpRegion	string	Region derived from customer IP
customerIpCity	string	City derived from customer IP
created	string	Creation timestamp
updated	string	Last update timestamp
updatedBy	string	User or system that last updated the record
kycStatus	boolean	Whether KYC verification passed