Skip to navigation

Fetch Single VTU Transaction

View as Markdown

Fetch one VTU purchase by its transaction ID.

Path: id (string, required) — the transactionId returned by a purchase endpoint. Use this to poll a PENDING purchase. Returns the full stored record (minus provider references/raw response), with the category and product. Note: the utility token is not included here — it is only returned in the purchase response.

Error format: body validation failures (Joi) return { "status": "error", "message": "Validation error", "details": [ ... ] }; all other errors return { "success": false, "message": "..." }. Money fields (amount, fee) are Prisma Decimals and are serialized as strings (e.g. "1000").

Authentication

AuthorizationBearer

Access token from Generate Access Token (valid 15 minutes).

Path parameters

idstringRequired
The VTU transaction ID.

Response

OK
successbooleanOptional
dataobjectOptional

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error