Get merchant transactions
Returns your own merchant ledger, as opposed to GET /v1/payment/history, which answers for one of your customers.
These are the movements on your merchant wallet: commission (your share of an escrow fee), delivery (a delivery fee you charged a buyer), and any withdrawals you made. Your customers’ escrow and wallet activity is not included; read that per customer from GET /v1/payment/history.
By default the response is paginated ({ pagination, data }). Supplying any filter (reference, fromDate, or toDate) instead returns a flat array of the matching transactions.
Must not carry a customer-id header.
Authorizations
Your secret key as a Bearer token. The key prefix selects the environment: sk_test_... (test) or sk_live_... (live).
Query Parameters
Page number for the paginated (unfiltered) response. 1-based: the first page is 1.
x >= 1Transactions per page, between 1 and 100. Defaults to 10. A larger value is capped at 100, and an unusable one falls back to the default. Applies to the paginated response only: a filtered response is a flat array and is not paged.
1 <= x <= 100Filter by transaction type. commission is your share of an escrow fee; delivery is a delivery fee you charged a buyer.
deposit, withdrawal, transfer, wallet_transfer, escrow, commission, delivery Filter by a specific reference. Returns a flat array.
Start of a date range (inclusive). Returns a flat array.
End of a date range (inclusive). Returns a flat array.
Response
Transactions retrieved. Paginated by default; a flat array when a filter is supplied.