TukuPay Docs

Your account

Statement and transactions

The account's statement as TukuPay shows it, and the payments your app made.

GET/v1/statementSigned · read

SeeSigning requestsKeys and scopesErrors

QueryMeaning
start_date, end_dateThe period (YYYY-MM-DD)
wallet_idOne wallet
paypoint_idOnly what was paid through one of your paypoints (e.g. an embedded one)
directionin or out
type, status, channelAs in TukuPay's statement
min_amount, max_amountAmount range
searchWords in a line: reference, M-Pesa code, name, phone
page, limitPaging
only_this_app=trueOnly 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

GET/v1/transactionsSigned · read

SeeSigning requestsKeys and scopesErrors

Payments 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.

GET/v1/transactions/{reference}Signed · read

SeeSigning requestsKeys and scopesErrors

GET/v1/transactions/external/{externalReference}Signed · read

SeeSigning requestsKeys and scopesErrors

One 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": "…"
}