# Gửi mã băm giao dịch 

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

[Ví dụ yêu cầu ↓](https://epusdt.com/vi/api/endpoints/submit-hash#request-example)

Gửi `block_transaction_id` trong JSON cho đơn on-chain đang chờ thanh toán (trạng thái 1). Máy chủ xác minh giao dịch trước khi cập nhật đơn.

## Tham số 

`trade_id` · `string` · PATH

Mã giao dịch EPUSDT trả về khi tạo đơn.

## Nội dung JSON 

| Trường bắt buộc        | Kiểu   | Ví dụ |
| ---------------------- | ------ | ----- |
| block\_transaction\_id | string | 0x…   |

## Tài liệu liên quan 

* [Kiểm tra trạng thái đơn](https://epusdt.com/vi/api/endpoints/order-status)
* [Thông báo cho người bán](https://epusdt.com/vi/api/payment#callbacks)

## Phản hồi

application/jsonTrường phản hồi
* `status_code` integer  
Mã kết quả nghiệp vụ.
* `message` string  
Thông báo kết quả.
* `data` object  
Dữ liệu trả về; null khi có lỗi.

  * `trade_id` string
  * `block_transaction_id` string
  * `status` integer
* `request_id` string  
Mã yêu cầu dùng để tra cứu nhật ký.

application/jsonTrường phản hồi
* `status_code` integer  
Mã kết quả nghiệp vụ.
* `message` string  
Thông báo kết quả.
* `data` null  
Dữ liệu trả về; null khi có lỗi.
* `request_id` string  
Mã yêu cầu dùng để tra cứu nhật ký.

application/jsonTrường phản hồi
* `status_code` integer  
Mã kết quả nghiệp vụ.
* `message` string  
Thông báo kết quả.
* `data` null  
Dữ liệu trả về; null khi có lỗi.
* `request_id` string  
Mã yêu cầu dùng để tra cứu nhật ký.

application/jsonTrường phản hồi
* `status_code` integer  
Mã kết quả nghiệp vụ.
* `message` string  
Thông báo kết quả.
* `data` null  
Dữ liệu trả về; null khi có lỗi.
* `request_id` string  
Mã yêu cầu dùng để tra cứu nhật ký.

application/jsonTrường phản hồi
* `status_code` integer  
Mã kết quả nghiệp vụ.
* `message` string  
Thông báo kết quả.
* `data` null  
Dữ liệu trả về; null khi có lỗi.
* `request_id` string  
Mã yêu cầu dùng để tra cứu nhật ký.

application/jsonTrường phản hồi
* `status_code` integer  
Mã kết quả nghiệp vụ.
* `message` string  
Thông báo kết quả.
* `data` null  
Dữ liệu trả về; null khi có lỗi.
* `request_id` string  
Mã yêu cầu dùng để tra cứu nhật ký.

application/jsonTrường phản hồi
* `status_code` integer  
Mã kết quả nghiệp vụ.
* `message` string  
Thông báo kết quả.
* `data` null  
Dữ liệu trả về; null khi có lỗi.
* `request_id` string  
Mã yêu cầu dùng để tra cứu nhật ký.

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

**Ví dụ yêu cầu**

URL cổng thanh toán 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"
}'
```

**Ví dụ phản hồi**200 · Thành công400 · 10009 · Tham số không hợp lệ400 · 10008 · Không tìm thấy đơn hàng400 · 10013 · Đơn hàng không ở trạng thái chờ400 · 10038 · Xác minh hash giao dịch không thành công.400 · 10039 · Việc kiểm tra thủ công đòi hỏi một đơn hàng trên chuỗi.400 · 10007 · Đã xử lý rồi

application/json · Một số trường phản hồi

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