Transactions
Retrieve a Transaction
Fetch the current status and details of a transaction using its ePay reference.
Retrieve a Transaction
GET /v1/transactions/:reference
Returns the current state of a transaction. Use this to poll for status updates or reconcile payments against your records.
Request
curl https://api.epayet.dev/v1/transactions/PAB12CD3420260813 \
-H "Authorization: Bearer sk_live_your_key_here"Response
{
"reference": "PAB12CD3420260813",
"merchantReference": "order_123",
"status": "completed",
"amount": "250.00",
"currencyCode": "ETB",
"paidAt": "2026-08-13T11:47:00.000Z",
"createdAt": "2026-08-13T11:30:00.000Z"
}Path Parameters
Prop
Type
Response
Prop
Type
Transaction statuses
| Status | Description |
|---|---|
pending | Session created; customer has not yet interacted with the checkout. |
processing | Customer is actively on the checkout page. |
completed | Payment was successful. |
failed | Payment attempt failed. |
cancelled | Transaction was cancelled via the API or by the customer. |
Errors
| Status | Description |
|---|---|
401 | Missing or invalid API key. |
404 | No transaction found for the given reference under your account. |
Next: Transaction Timeline — see every event recorded against this transaction.