获取交易状态
使用您的 API 密钥通过其内部 id 检索特定交易的最新状态。
请求
GET /api/v1/transactions/{transaction_id}?env=prod
Headers:
x-api-key: <your_api_key>
{transaction_id} 是交易的内部 id (UUID)，作为路径段传递。
响应字段
| 领域 | 描述 |
|---|---|
| amount | 以最小货币单位表示的金额 |
| amount_with_fee | 含费用金额（最小货币单位） |
| amount_dest | 转换的目标金额（最小货币单位）（如果适用） |
| currency | 货币代码（例如 USDT） |
| currency_dest | 用于转换的目标货币（如果适用） |
| description | 提供原始描述 |
| env | prod（默认）。打开并确认请求时保留该值。 |
| error_description | 如果状态被拒绝，则错误详细信息 |
| finished | 完成时间戳 (ISO) 如果终端 |
| id | 内部事务标识符（UUID） |
| route | 使用的加工路线 |
| started | 开始时间戳（ISO） |
| status | 当前状态（请参阅现场约定中的状态生命周期；例如创建、收费、收费、退款、拒绝、失败） |
| txid | 客户提供的外部标识符 |
| type | 交易类型（付款或支出） |
| widget_url | 小部件链接（如果小部件流） |
| simple_auth_redirect_url | 3DS / 附加授权 URL（适用时） |
示例
curl --location 'https://app.heth.me/api/v1/transactions/c033ceaa-3726-4479-8be3-c9af8a0b2336?env=prod' \
--header "x-api-key: $HETH_API_KEY"
使用说明
- 使用指数退避（例如 1s、2s、4s、8s）进行轮询，直到达到最终状态。
- 判断
status的结果；单独缺失或存在finished并不能证明结果。 txid对于每个业务操作应该是幂等的。
通过外部操作标识符恢复
curl --get 'https://app.heth.me/api/v1/transactions/example-order-001' \
--header "x-api-key: $HETH_API_KEY" \
--data-urlencode 'by=txid' \
--data-urlencode 'env=prod'