EdfaPay Logo

Query Transactions

Read the ledger with a paginated search (getTransactions) plus single-row convenience helpers by UUID, merchant orderId, or RRN. The single-row helpers return null when the call fails or no row matches.

Overview

getTransactions(filter) returns a paginated page (PageDto); the single-row helpers return one transaction (or null). The single-row helpers are equivalent to getTransactions(TransactionFilter(pageSize = 1, … = …)).content.firstOrNull().

Safe to retry

Queries are idempotent — retry them freely on network errors, unlike sale / applePay / recurring.

Query Helpers

Fetch a page with a filter, or a single row by UUID, your merchant orderId, or the RRN.

Loading...

TransactionFilter

TransactionFilter narrows the paginated search. All fields are optional except paging.

FieldTypeMeaning
pageNumberIntZero-based page index.
pageSizeIntRows per page.
statusString?Gateway status filter (e.g. APPROVED).
idString?Filter by the gateway transaction UUID.
orderIdString?Filter by your merchant order id.
rrnString?Filter by Retrieval Reference Number.