Retrieve Transaction

Fetch a single transaction by its ID or reference number. Useful for checking status, displaying receipts, or reconciling payments.

GEThttps://api.auraxpay.net/v1/payments/:idRequires payments.read permission

Path parameter

Parameter	Description
:id	Transaction ID (e.g. `txn_01j2k3m4n5p6`) or reference number (e.g. `AXP-SXSZF5H6`). Both work.

Example request

By transaction ID

curl https://api.auraxpay.net/v1/payments/txn_01j2k3m4n5p6q7r8s9t0 \
  -H "x-api-key: axp_live_YOUR_KEY"

By reference number

curl https://api.auraxpay.net/v1/payments/AXP-SXSZF5H6 \
  -H "x-api-key: axp_live_YOUR_KEY"

Response

Response 200

{
  "success": true,
  "transaction": {
    "id": "txn_01j2k3m4n5p6q7r8s9t0",
    "reference": "AXP-SXSZF5H6",
    "type": "COLLECTION",
    "amount": 25000,
    "fee": 0,
    "netAmount": 25000,
    "channel": "MPESA",
    "status": "COMPLETED",
    "buyerPhone": "+255712345678",
    "buyerName": "Amina Hassan",
    "description": "Subscription - Pro Plan",
    "metadata": { "orderId": "ORD-1042" },
    "providerReference": "MP2506091430001",
    "createdAt": "2025-06-09T14: 30: 00.000Z",
    "completedAt": "2025-06-09T14: 30: 45.000Z",
    "statusLogs": [
      { "status": "PENDING", "timestamp": "2025-06-09T14: 30: 00.000Z" },
      { "status": "PROCESSING", "timestamp": "2025-06-09T14: 30: 30.000Z" },
      { "status": "COMPLETED", "timestamp": "2025-06-09T14: 30: 45.000Z" }
    ]
  }
}

✅The statusLogs array gives you a full audit trail of how the transaction progressed — useful for debugging or displaying to customers.