Transaction History

The Transaction History endpoint provides merchants with a robust way to retrieve logs of all financial activities. In V2, records are automatically scoped to your merchant profile via **Intelligent Header Resolution**, ensuring data privacy and simplified integration.

Automatic Scoping

The platform identifies your account using the Authorization: Bearer header. You no longer need to pass an internal ID to fetch your own transaction logs.

Endpoint Details

Base URL https://merchant.servinux.com/v2/history

Method POST

Request Parameters

Field	Required	Description
limit	No	Number of records per page (Default: 20, Max: 100).
offset	No	The starting index for pagination (Default: 0).

Implementation Example

Sample Body (JSON)

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

JSON Success Response

{
  "success": true,
  "count": 1,
  "data": [
    {
      "txn_id": 105,
      "customer_email": "[email protected]",
      "provider_ref": "FP_9B_VA_3_1767443388",
      "amount": "5000.00",
      "currency": "NGN",
      "status": "success",
      "txn_type": "transfer",
      "created_at": "2026-01-12 14:12:05"
    }
  ]
}

Developer Best Practices

Efficient Polling: For real-time updates, we recommend using Webhooks. However, if using history polling, avoid intervals shorter than 30 seconds.