Skip to main content
GET
Get payment history

Authorizations

Authorization
string
header
required

Your secret key as a Bearer token. The key prefix selects the environment: sk_test_... (staging) or sk_live_... (production); a key on the wrong host is refused with 403 Unauthorized Access. Each key is limited to 10 requests per minute (429 beyond that) and, on production, to the IP addresses on your dashboard allowlist when one is configured.

Headers

customer-id
string
required

The merchant customer this request acts on behalf of.

Query Parameters

page
integer
default:1

Page number for the paginated (unfiltered) response. 1-based: the first page is 1.

Required range: x >= 1
limit
integer
default:10

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

Required range: 1 <= x <= 100
type
enum<string>

Filter by transaction type. delivery is an escrow's additional (delivery) fee paid out to the merchant.

Available options:
deposit,
withdrawal,
transfer,
wallet_transfer,
escrow,
delivery
reference
string

Filter by a specific reference. Returns a flat array.

fromDate
string<date>

Start of a date range (inclusive). Returns a flat array.

toDate
string<date>

End of a date range (inclusive). Returns a flat array.

Response

Transactions retrieved. Paginated by default; a flat array when a filter is supplied.