Transaction List (Simplified)

Get a simplified list of transactions for your merchant account.

Endpoint Information

Name: Get Transaction List (Simplified)
Method: GET
URL: {{BASE_URL}}/api/v1/transaction/get-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., Accepted, Declined)
filterByRef	string	No	-	Filter by transaction reference
transactionType	string	No	-	Filter by type (sale, payout)

Example Request

GET {{BASE_URL}}/api/v1/transaction/get-list?merchantAccountId=100001&page=1&status=Accepted&filterByRef=ref-5004

Response

Success Response

{
  "success": true,
  "message": "Transaction list",
  "data": [
    {
      "type": "sale",
      "status": "success",
      "amount": "33.00",
      "currency": "EUR",
      "reference": "6jEoCGIVHC",
      "created_at": "2024-12-18T12:24:20.000000Z",
      "payment_method": "Card (VISA)",
      "transaction_id": "1734524586GXHTTV8WJL"
    },
    {
      "type": "sale",
      "status": "success",
      "amount": "55.00",
      "currency": "USD",
      "reference": "qR2mLtilQ2",
      "created_at": "2024-12-23T07:15:53.000000Z",
      "payment_method": "Card (VISA)",
      "transaction_id": "17349380741KNQAWCAYU"
    }
  ],
  "pagination": {
    "total": 106,
    "current_items_count": 15,
    "items_per_page": 15,
    "current_page_no": 1,
    "last_page_no": 8,
    "has_more_pages": true
  }
}

Response Fields

Field	Type	Description
data[].type	string	Transaction type (e.g., sale, payout)
data[].status	string	Transaction status
data[].amount	string	Transaction amount
data[].currency	string	Transaction currency
data[].reference	string	Your transaction reference
data[].transaction_id	string	Paymid transaction ID
pagination	object	Pagination details