Get Transaction Status

Retrieve the latest state of a specific transaction by its internal id using your API key.

Request

GET /api/v1/transactions?id={transaction_id}
Headers: x-api-key: <your_api_key>

The id parameter is required.

Response Fields

Field	Description
amount	Amount in minor units
amount_with_fee	Amount including fee (minor units)
currency	Currency code (e.g. USDT)
description	Original description provided
env	Environment (prod or test)
error_description	Error details if status is rejected
finished	Finish timestamp (ISO) if terminal
id	Internal transaction identifier (UUID)
started	Start timestamp (ISO)
status	Current status (e.g. created, charging, charged, rejected)
txid	Client supplied external identifier
type	Transaction type (payment or payout)
widget_url	Widget link (if widget flow)
simple_auth_redirect_url	3DS / additional auth URL when applicable

Example

curl --location 'https://app.heth.me/api/v1/transactions?id=c033ceaa-3726-4479-8be3-c9af8a0b2336' \
  --header 'x-api-key: YOUR_KEY'

Usage Notes

• Poll with exponential backoff (e.g. 1s, 2s, 4s, 8s) until a terminal state.
• Treat missing finished as in-progress.
• txid should be idempotent per business operation.