Transaction Timeline

Retrieve the full event history for a transaction, ordered from earliest to latest.

Transaction Timeline

GET /v1/transactions/:reference/timeline

Returns an ordered list of events recorded against a transaction — from the moment the session was opened through to payment completion, failure, or cancellation.

Request

curl https://api.epayet.dev/v1/transactions/PAB12CD3420260813/timeline \
  -H "Authorization: Bearer sk_live_your_key_here"

Completed payment

{
  "reference": "PAB12CD3420260813",
  "events": [
    {
      "eventType": "session_created",
      "occurredAt": "2026-08-13T11:30:00.000Z",
      "errorCode": null,
      "errorMessage": null
    },
    {
      "eventType": "payment_initiated",
      "occurredAt": "2026-08-13T11:45:12.000Z",
      "errorCode": null,
      "errorMessage": null
    },
    {
      "eventType": "payment_completed",
      "occurredAt": "2026-08-13T11:47:00.000Z",
      "errorCode": null,
      "errorMessage": null
    }
  ]
}

Failed payment

{
  "reference": "PFF98AB1220260812",
  "events": [
    {
      "eventType": "session_created",
      "occurredAt": "2026-08-12T09:15:00.000Z",
      "errorCode": null,
      "errorMessage": null
    },
    {
      "eventType": "payment_failed",
      "occurredAt": "2026-08-12T09:18:44.000Z",
      "errorCode": "INSUFFICIENT_FUNDS",
      "errorMessage": "The customer's account does not have sufficient balance."
    }
  ]
}