Your account
Statement and transactions
The account's statement as TukuPay shows it, and the payments your app made.
/v1/statementSigned · read| Query | Meaning |
|---|---|
start_date, end_date | The period (YYYY-MM-DD) |
wallet_id | One wallet |
paypoint_id | Only what was paid through one of your paypoints (e.g. an embedded one) |
direction | in or out |
type, status, channel | As in TukuPay's statement |
min_amount, max_amount | Amount range |
search | Words in a line: reference, M-Pesa code, name, phone |
page, limit | Paging |
only_this_app=true | Only payments made through this app |
The answer has period, opening_balance, closing_balance, movement (money_in, money_out, unlisted), totals (count, settled_count, money_in, money_out, fees) and rows. Each row has id, reference, mpesa_code, date, completed_at, type, status, channel, direction (in, out, neutral), description, counterparty, amount, fee, money_in, money_out and settled.
const statement = await tukupay.statement({ start_date: "2026-11-01", end_date: "2026-11-06", direction: "in" });Your app's payments
/v1/transactionsSigned · readPayments this app made on the account, newest first: limit (1 to 100, default 25), offset. Answers { items, total, has_more }. With a sandbox key, the sandbox's simulated payments.
/v1/transactions/{reference}Signed · read/v1/transactions/external/{externalReference}Signed · readOne payment, by TukuPay's reference or by your external_reference. Check it every 30 seconds to follow a payment: see Checking a payment.
{
"reference": "TP8K2M4Q9X",
"external_reference": "order-1042",
"status": "pending",
"kind": "collection",
"amount": "1500.00",
"bank_charges": "0.00",
"currency": "KES",
"wallet_id": 7,
"customer_id": null,
"failure_reason": null,
"completed_at": null,
"created_at": "2026-11-06T09:30:00.000Z",
"livemode": true,
"approval": null,
"message": "…"
}