Get Transaction Status

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

Request

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

{transaction_id} is the transaction's internal id (UUID), passed as a path segment.

Field	Description
amount	Amount in minor units
amount_with_fee	Amount including fee (minor units)
amount_dest	Destination amount for conversion (minor units), if applicable
currency	Currency code (e.g. USDT)
currency_dest	Destination currency for conversion, if applicable
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)
route	Processing route used
started	Start timestamp (ISO)
status	Current status (see Status Lifecycle in Field Conventions; e.g. created, charging, charged, refunded, rejected, failed)
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

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