List Payment Transactions — GET /merchants/transactions

Retrieve a paginated list of all payment transactions on your merchant account. Use the query parameters to narrow results by status, payment method, customer email, or date range. This endpoint is suitable for reconciliation dashboards and support workflows.

GET https://sandbox.lyseis-pay.com/merchants/transactions

Replace sandbox.lyseis-pay.com with live.lyseis-pay.com when moving to production.

Headers

Header	Value
`X-Key-Id`	Your merchant key ID
`X-Timestamp`	Unix timestamp of the request (seconds)
`X-Signature`	HMAC-SHA256 signature of the payload

Query Parameters

string

Filter by payment status. Accepted values: success, processing, failed, abandoned, reversed, expired. Omit to return transactions of all statuses.

string

Filter by the payment method used. Accepted values: card, bank_transfer, ussd, direct_debit. Omit to include all methods.

string

Filter transactions to those initiated by a specific customer email address.

string

ISO 8601 datetime (inclusive) for the start of the date range, e.g. 2026-09-01T00:00:00Z. Filters on created_at.

string

ISO 8601 datetime (inclusive) for the end of the date range, e.g. 2026-09-30T23:59:59Z. Filters on created_at.

integer

default:"1"

The page number to retrieve, starting from 1.

integer

default:"10"

Number of records per page. Minimum 1, maximum 100.

Example Request

GET https://sandbox.lyseis-pay.com/merchants/transactions?status=success&start_date=2026-09-01T00:00:00Z&page=1&page_size=25
X-Key-Id: mk_sandbox_xxxxxxxxxx
X-Timestamp: 1751234567
X-Signature: <hmac-sha256-signature>

Response

string

Top-level API response status. "success" means the request was processed and results are returned.

integer

Total number of transactions matching the applied filters, across all pages.

integer

The current page number returned.

integer

Number of records included in this page.

array

Array of transaction objects.

Show Transaction object fields

string

The merchant-facing transaction reference.

string

Paylink’s internal unique identifier for this transaction.

string

Email address of the customer who initiated the transaction.

number

Transaction amount in the smallest currency unit (e.g. kobo for NGN).

number

Processing fee charged for this transaction, in the smallest currency unit.

string

ISO 4217 currency code (e.g. NGN).

string

Payment status. See Payment Statuses for the full list of values.

string

The method used for payment, e.g. card, bank_transfer, ussd.

object

Metadata key-value pairs attached to the transaction at initialization.

string

ISO 8601 timestamp when the payment session was created.

string

ISO 8601 timestamp of the most recent status update.

Example Response

{
  "status": "success",
  "total": 142,
  "page": 1,
  "pageSize": 25,
  "data": [
    {
      "reference": "order_12345",
      "transaction_id": "txn_98765abcde",
      "customer_email": "customer@example.com",
      "amount": 2500.00,
      "fee": 37.50,
      "currency": "NGN",
      "status": "success",
      "payment_method": "card",
      "metadata": { "order_id": "12345" },
      "created_at": "2026-09-15T10:22:00Z",
      "updated_at": "2026-09-15T10:23:45Z"
    },
    {
      "reference": "order_12346",
      "transaction_id": "txn_98765abcdf",
      "customer_email": "another@example.com",
      "amount": 5000.00,
      "fee": 75.00,
      "currency": "NGN",
      "status": "success",
      "payment_method": "bank_transfer",
      "metadata": {},
      "created_at": "2026-09-15T11:05:00Z",
      "updated_at": "2026-09-15T11:07:22Z"
    }
  ]
}

Payments

Virtual Accounts

Direct Debits

Refunds

Transfers

Banks

List Payment Transactions — GET /merchants/transactions

Headers

Query Parameters

Example Request

Response

Example Response

​Headers

​Query Parameters

​Example Request

​Response

​Example Response

Headers

Query Parameters

Example Request

Response

Example Response