Transactions

This endpoint allows you to fetch transactions under a store, It requires Bearer token authentication.

Query Parameters

The Get Transactions endpoint takes in the parameters as shown below

Parameter	Type	Required	Description
page	integer	Yes	Page number for pagination (default: 1)
perPage	integer	Yes	Number of records per page (default: 10)
startDate	string	No	Start date for transaction filter (YYYY-MM-DD)
endDate	string	No	End date for transaction filter (YYYY-MM-DD)
transactionType	string	No	See transaction types below
paymentType	string	No	See Payment types below
status	string	No	Status of the transaction
externalId	string	No	External identifier for the transaction
accountNumber	string	No	Phone Number

Transaction Types

Lipila supports the following transaction types:

Payment Type	Description
AirtelMoney	Airtel Money
MTNMoney	MTN Mobile Money
ZamtelKwacha	Zamtel Kwacha
Card	Card Payment

Transaction Types

The following are the transaction types found on Lipila

Transaction Type	Description
Collection	Involves receiving funds in to collections wallet (Deposits)
Disbursement	Involves sending of funds from the disbursements wallet (Withdraws)
Settlement	Involves sending collected fund to either merchants Bank account or mobile money
Allocation	Involves adding of funds into merchants Disbursements wallet.

Transaction status

Below are the statuses that lipila supports.

Status	Description
Pending	The transaction is processing.
Successful	The transaction was successful.
Failed	The transaction is failed.
Ambiguous	The transaction is awaiting final status

Transaction Endpoint

Here’s how to use the endpoint to get transactions:

curl -X 'GET' \
  'https://lipila-uat.hobbiton.app/transactions/thirdParty/merchants?page=1&perPage=10' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer YOUR_SECRET_KEY'

Response Codes

Status code	Description
401	Unauthorized
404	No transactions found
500	Internal server error

Transaction Response

Below is a snapshot of the sample response for the transaction response.

{
  "totalItems": 1,
  "pageSize": 10,
  "pageNumber": 1,
  "totalPages": 1,
  "data": [
    {
      "transactionReferenceId": "LPTXN2508051643211591",
      "tillNumber": 20501,
      "externalId": "test-3531",
      "amount": 100,
      "currency": "ZMW",
      "status": "Successful",
      "customer": {
        "email": "Anonymous",
        "fullName": "TAONGA NAMBELA",
        "phoneNumber": "260966666666"
      },
      "xReferenceId": "LPTXN2508051643211591",
      "paymentType": "MTNMoney",
      "transactionType": "Collection",
      "narration": "test",
      "createdAt": "2025-08-05T14:43:21.572Z",
      "updatedAt": "2025-08-05T14:43:24.271Z"
    }
  ]
}

Note

By default, the endpoint pulls transactions for the past 7 days. The Date filters can be adjusted.