API ReferencePayments
Get transaction by ID
Retrieve a specific transaction with all its payment events.
GET
/v1/payments/transactions/{id}Authorization
bearer AuthorizationBearer <token>
In: header
Path Parameters
id*string
Response Body
application/json
curl -X GET "https://example.com/v1/payments/transactions/string"{ "success": true, "statusCode": 200, "message": "Request processed successfully", "timestamp": "2025-10-20T16:30:00.000Z", "path": "/v1/auth/register", "data": { "id": "txn_abc123", "reference": "TXN_1634567890123_ABC123", "type": "DEPOSIT", "status": "SUCCESS", "amount": 10000, "currency": "NGN", "fee": 150, "netAmount": 9850, "gateway": "paystack", "gatewayRef": "1234567890", "channel": "card", "customerEmail": "customer@example.com", "customerName": "John Doe", "description": "Wallet funding", "metadata": { "source": "web" }, "initiatedAt": "2025-10-20T12:00:00.000Z", "completedAt": "2025-10-20T12:05:00.000Z", "failedAt": "2025-10-20T12:05:00.000Z", "createdAt": "2025-10-20T12:00:00.000Z", "updatedAt": "2025-10-20T12:05:00.000Z", "events": [ { "id": "evt_abc123", "event": "charge.success", "status": "success", "gateway": "paystack", "processed": true, "processedAt": "2025-10-20T12:05:00.000Z", "errorMessage": null, "createdAt": "2025-10-20T12:05:00.000Z" } ] }}