List and Filter Virtual Account Transactions by Date

Retrieve a paginated list of all inbound transactions received by virtual accounts on your merchant account. Filter by a specific account reference, status, or date range to support reconciliation and reporting workflows.

GET https://sandbox.lyseis-pay.com/merchants/virtual-accounts/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 results to transactions received by a specific virtual account. If omitted, transactions across all your virtual accounts are returned.

string

Filter by transaction status. Common values: success, processing, failed. Omit to include all statuses.

string

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

string

ISO 8601 datetime (inclusive) marking 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 to return per page. Minimum 1, maximum 100.

Example Request

GET https://sandbox.lyseis-pay.com/merchants/virtual-accounts/transactions?account_reference=customer_123&status=success&page=1&page_size=10
X-Key-Id: mk_sandbox_xxxxxxxxxx
X-Timestamp: 1751234567
X-Signature: <hmac-sha256-signature>

Response

string

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

integer

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

integer

The current page number returned.

integer

Number of records included on this page.

array

Array of virtual account transaction objects.

Show Transaction object fields

string

Paylink’s internal unique identifier for this inbound transfer.

string

The merchant-defined reference of the virtual account that received the funds.

string

The virtual account number that received the transfer.

number

The transfer amount received, in the smallest currency unit (e.g. kobo for NGN).

string

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

string

The status of this inbound transfer (e.g. success, processing, failed).

string

The name of the individual or entity that sent the transfer, as reported by the banking rail.

string

The bank name from which the transfer originated.

string

The payment narration or description provided by the sender.

object

Metadata key-value pairs associated with the virtual account at the time of this transaction.

string

ISO 8601 timestamp when the transaction was recorded.

string

ISO 8601 timestamp of the most recent status update.

Example Response

{
  "status": "success",
  "total": 38,
  "page": 1,
  "pageSize": 10,
  "data": [
    {
      "transaction_id": "vat_00abc123def",
      "account_reference": "customer_123",
      "account_number": "0123456789",
      "amount": 15000.00,
      "currency": "NGN",
      "status": "success",
      "sender_name": "Ngozi Okafor",
      "sender_bank": "First Bank of Nigeria",
      "narration": "Payment for invoice #INV-00789",
      "metadata": { "customer_id": "123" },
      "created_at": "2026-09-10T14:32:00Z",
      "updated_at": "2026-09-10T14:32:45Z"
    },
    {
      "transaction_id": "vat_00abc123deg",
      "account_reference": "customer_123",
      "account_number": "0123456789",
      "amount": 5000.00,
      "currency": "NGN",
      "status": "success",
      "sender_name": "Emeka Eze",
      "sender_bank": "Access Bank",
      "narration": "Wallet top-up",
      "metadata": { "customer_id": "123" },
      "created_at": "2026-09-12T09:15:00Z",
      "updated_at": "2026-09-12T09:15:30Z"
    }
  ]
}

Payments

Virtual Accounts

Direct Debits

Refunds

Transfers

Banks

List and Filter Virtual Account Transactions by Date

Headers

Query Parameters

Example Request

Response

Example Response

​Headers

​Query Parameters

​Example Request

​Response

​Example Response

Headers

Query Parameters

Example Request

Response

Example Response