Skip to main content

Transactions

List Transactions (JWT)

GET /business/transactions
curl "https://api.nexapay.ng/api/v1/business/transactions" \
  -H "Authorization: Bearer <token>"

Response

{
  "success": true,
  "transactions": [
    {
      "id": "NEXA-...",
      "amount": 5000,
      "status": "completed",
      "channel": "EXTERNAL_PAYMENT",
      "customer": "Jane Smith",
      "createdAt": "2026-03-13T10:12:00.000Z",
      "description": "March invoice",
      "reference": "NEXA-..."
    }
  ]
}

Error Response

{
  "success": false,
  "msg": "No token, authorization denied"
}

Transaction Details (JWT)

GET /business/transactions/:transactionId
curl "https://api.nexapay.ng/api/v1/business/transactions/txn_123" \
  -H "Authorization: Bearer <token>"

Response

{
  "success": true,
  "transaction": {
    "id": "txn_123",
    "amount": 5000,
    "status": "completed",
    "channel": "EXTERNAL_PAYMENT",
    "customer": "Jane Smith",
    "createdAt": "2026-03-13T10:12:00.000Z",
    "description": "March invoice",
    "reference": "txn_123",
    "payer": {
      "name": "Jane Smith",
      "email": "jane@example.com"
    },
    "metadata": {}
  }
}

Invalid Example (Not Found)

{
  "success": false,
  "msg": "Transaction not found"
}