# 提交交易雜湊 

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

[請求範例 ↓](https://epusdt.com/zh-tw/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-tw/api/endpoints/order-status)
* [商戶回呼](https://epusdt.com/zh-tw/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"
}
```
