Get Wallet Transactions

Get merchant wallet transactions with pagination

IMPORTANT: Returns internal wallet operations (settlements, balance movements, internal transfers).
NOT customer payment transactions. For customer-facing transactions, use /merchants/customer/transactions.

Query Parameters:

currency_code (optional): Filter by currency code (case-insensitive, e.g., USD, usd, Usd)

If provided: Returns wallet transactions for that specific currency

If not provided: Returns all wallet transactions across all currencies

Returns error if currency code is invalid

page: Page number (starts from 1, default: 1)

size: Number of transactions per page (default: 50, max: 100)

Returns:
Internal wallet transactions ordered by created_at (newest first) with pagination metadata including:

transaction_type: settlement, payout, refund, adjustment, etc.

amount: Transaction amount

balance_before: Balance before transaction

balance_after: Balance after transaction

settlement_status: unsettled, settled, or not_applicable

total: Total number of transactions

page: Current page number

size: Items per page

total_pages: Total number of pages

has_more: Whether more pages are available

Examples:

Get all wallet transactions: GET /api/v1/merchants/wallet/transactions

Get USD wallet transactions: GET /api/v1/merchants/wallet/transactions?currency_code=USD

Get EUR wallet transactions page 2: GET /api/v1/merchants/wallet/transactions?currency_code=EUR&page=2&size=20

Request

Responses