Transactions

You may be able to Query the API for the list of transactions that have occured during any specific period of time by sending the Request to us via the Endpoint Provided

When you list your transactions using our platform, you'll receive the results in a paginated format. This means that your transaction data will be organized into discrete pages, making it easy to navigate through large sets of data.

Each page will contain a specific number of transactions, providing you with a manageable view of your transaction history. You can easily navigate between pages to access older or newer transactions as needed.

Our pagination system ensures that your transaction data is presented in a structured and organized manner, allowing you to efficiently review and analyze your sales activity without overwhelming you with too much information at once.

Request

Send the request to

cURL

{{base_url}}/api/list-transactions

📘

You may request more data by using the urls given in the response, denoted by previous/next.

Other things to note, the response here wont be encrypted, just plain simple JSON payload.

Response

JSON

{
    "payload": {
        "current_page": 1,
        "data": [
            {
                "merchant_order_id": "1",
                "live": 0,
                "status": "pending",
                "amount": "50000",
                "receivable_amount": "0",
                "currency": "TZS",
                "payment_url": null,
                "payment_method": "MOBILEMONEYPULL",
                "merchant_redirect_url": null,
                "merchant_cancel_url": null,
                "merchant_webhook": "https://webhook.site/#!/2250a4d1-a6e2-4ac8-97b2-26dda65da334",
                "customer_email": "[email protected]",
                "customer_userid": "2",
                "customer_phone": "1234567890",
                "customer_name": "John Doe",
                "is_recurring": 0,
                "transaction_settlement_date": null
            },
        ],
        "first_page_url": "{{base_url}}/api/list-transactions?page=1",
        "from": 1,
        "last_page": 1,
        "last_page_url": "{{base_url}}/api/list-transactions?page=1",
        "next_page_url": null,
        "path": "{{base_url}}/api/list-transactions",
        "per_page": 50,
        "prev_page_url": null,
        "to": 5,
        "total": 5
    }
}

📘

Mind you, When making this request do not forget to pass in your credentials as highlighted in the first subsection above.

🚧

Please pass the transaction dates as shown in the requests, any other format will not be accepted & by default you will always get a chunk of 50 records per request.

Sample request with Date Range given would be along the lines of

cURL

{{base_url}}/api/list-transactions?start=2024-02-01&end=2024-04-01

🚧

Note:

If you want the results to be along these lines then, the dates must be in the format given and also you must provide both start & end fields like in the request above.

cURL

{{base_url}}/api/list-transactions?page=2&start=2024-02-01&end=2024-04-01

if there is pagination for the above then just append the page field to the request like shown above.