Transaction History

The Transaction History endpoint provides merchants with a robust way to retrieve logs of all financial activities associated with their account. This includes successful payments, pending checkouts, and virtual account generations.

Endpoint Details

Base URL https://merchant.finovopay.com/v1/index.php

Method POST

Request Parameters

Field	Type	Description
action	String	Must be set to `transaction_history`
limit	Integer	Number of records per request (Default: 20).
offset	Integer	The starting point (Used for pagination).

Implementation Example

Sample Request Payload

{
  "action": "transaction_history",
  "limit": 10,
  "offset": 0
}

JSON Success Response

{
  "success": true,
  "count": 1,
  "data": [
    {
      "txn_id": 15,
      "customer_email": "[email protected]",
      "customer_name": "ReignHost Technologies LTD",
      "provider_ref": "FP_CH_1FF9F0E1_1767443388",
      "amount": "5000.00",
      "currency": "NGN",
      "status": "success",
      "txn_type": "checkout",
      "created_at": "2026-01-03 13:45:12"
    }
  ]
}

Developer Best Practices

Pagination: Increment the offset by your limit value to load the next set of results.