# 提交交易哈希 

**POST**`https://pay.example.com/pay/submit-tx-hash/{trade_id}`

[请求示例 ↓](https://epusdt.com/zh/api/endpoints/submit-hash#request-example)

在 JSON 请求体中提交 `block_transaction_id`。仅限等待付款的链上订单（状态 1），服务端核验转账后更新订单。

## 请求参数 

`trade_id` · `string` · PATH

创建订单时返回的 EPUSDT 交易号。

## JSON 请求体 

| 必填字段                   | 类型     | 示例  |
| ---------------------- | ------ | --- |
| block\_transaction\_id | string | 0x… |

## 相关文档 

* [查询订单状态](https://epusdt.com/zh/api/endpoints/order-status)
* [商户回调](https://epusdt.com/zh/api/payment#callbacks)

## 响应

application/json响应字段
* `status_code` integer  
业务结果码，商户可据此判断具体原因。
* `message` string  
便于阅读的结果说明。
* `data` object  
接口返回的数据，失败时为 null。

  * `trade_id` string
  * `block_transaction_id` string
  * `status` integer
* `request_id` string  
请求标识，可用于排查日志。

application/json响应字段
* `status_code` integer  
业务结果码，商户可据此判断具体原因。
* `message` string  
便于阅读的结果说明。
* `data` null  
接口返回的数据，失败时为 null。
* `request_id` string  
请求标识，可用于排查日志。

application/json响应字段
* `status_code` integer  
业务结果码，商户可据此判断具体原因。
* `message` string  
便于阅读的结果说明。
* `data` null  
接口返回的数据，失败时为 null。
* `request_id` string  
请求标识，可用于排查日志。

application/json响应字段
* `status_code` integer  
业务结果码，商户可据此判断具体原因。
* `message` string  
便于阅读的结果说明。
* `data` null  
接口返回的数据，失败时为 null。
* `request_id` string  
请求标识，可用于排查日志。

application/json响应字段
* `status_code` integer  
业务结果码，商户可据此判断具体原因。
* `message` string  
便于阅读的结果说明。
* `data` null  
接口返回的数据，失败时为 null。
* `request_id` string  
请求标识，可用于排查日志。

application/json响应字段
* `status_code` integer  
业务结果码，商户可据此判断具体原因。
* `message` string  
便于阅读的结果说明。
* `data` null  
接口返回的数据，失败时为 null。
* `request_id` string  
请求标识，可用于排查日志。

application/json响应字段
* `status_code` integer  
业务结果码，商户可据此判断具体原因。
* `message` string  
便于阅读的结果说明。
* `data` null  
接口返回的数据，失败时为 null。
* `request_id` string  
请求标识，可用于排查日志。

[error-codes.json ↓](https://epusdt.com/agent-setup/error-codes.json)

**请求示例**

网关地址 trade\_id 

```
curl -i -X POST \
  'https://pay.example.com/pay/submit-tx-hash/20260523171652123456001' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "block_transaction_id": "0xabababababababababababababababababababababababababababababababab"
}'
```

**响应示例**200 · 成功400 · 10009 · 无法解析参数400 · 10008 · 订单不存在400 · 10013 · 订单不是等待支付状态400 · 10038 · 交易哈希核验失败400 · 10039 · 仅支持对链上订单进行人工核验400 · 10007 · 订单区块已处理

application/json · 响应字段节选

```
{
  "status_code": 200,
  "message": "success",
  "data": {
    "trade_id": "20260523171652123456001",
    "block_transaction_id": "0xabababababababababababababababababababababababababababababababab",
    "status": 2
  },
  "request_id": "b1344d70-ff19-4543-b601-37abfb3b3686"
}
```
