Reporting
Transactions
Retrieve transaction history for your merchant account. You can fetch a paginated list with optional filters, or look up a single transaction by its ID. Transaction records include settlement status, payment method details, and links to the payment link if applicable.
Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /transactions | Paginated list with optional filters |
| GET | /transactions/{id} | Single transaction with full details |
Query Parameters (List)
| Parameter | Type | Description |
|---|---|---|
page | integer | Page number. Default: 1. |
limit | integer | Records per page. Default: 20, max: 100. |
status | string | Filter: pending, success, or failed. |
payment_link_id | string | Filter transactions from a specific payment link. |
dgs_reference | string | Find by your internal DGS reference. |
flw_reference | string | Find by Flutterwave reference. |
cURL — Paginated list, filtered by status
curl -X GET \ "https://pay.digitalservicescenter.rw/generation/v2/transactions?page=1&limit=20&status=success" \ -H "X-DGS-API-Key: YOUR_API_KEY"
cURL — Single transaction by ID
curl -X GET \ https://pay.digitalservicescenter.rw/generation/v2/transactions/dgs-reference \ -H "X-DGS-API-Key: YOUR_API_KEY"
List Response
JSON
{
"status": "success",
"data": [
{
"id": "uuid1",
"dgs_reference": "INV-123",
"amount": 100,
"currency": "USD",
"status": "success",
"payment_method_type": "card",
"created_at": "2026-04-03 11:00:00"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 50,
"pages": 3
}
}