# Submit a transaction hash 

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

[Request example ↓](https://epusdt.com/api/endpoints/submit-hash#request-example)

Submit `block_transaction_id` in the JSON body for an on-chain order awaiting payment (status 1). The server verifies the transfer before updating the order.

## Parameters 

`trade_id` · `string` · PATH

The EPUSDT transaction ID returned when the order was created.

## JSON body 

| Required field         | Type   | Example |
| ---------------------- | ------ | ------- |
| block\_transaction\_id | string | 0x…     |

## Related resources 

* [Poll order status](https://epusdt.com/api/endpoints/order-status)
* [Merchant callbacks](https://epusdt.com/api/payment#callbacks)

## Responses

application/jsonResponse fields
* `status_code` integer  
Application result code.
* `message` string  
Human-readable result.
* `data` object  
Response payload; null on error.

  * `trade_id` string
  * `block_transaction_id` string
  * `status` integer
* `request_id` string  
Request identifier for tracing.

application/jsonResponse fields
* `status_code` integer  
Application result code.
* `message` string  
Human-readable result.
* `data` null  
Response payload; null on error.
* `request_id` string  
Request identifier for tracing.

application/jsonResponse fields
* `status_code` integer  
Application result code.
* `message` string  
Human-readable result.
* `data` null  
Response payload; null on error.
* `request_id` string  
Request identifier for tracing.

application/jsonResponse fields
* `status_code` integer  
Application result code.
* `message` string  
Human-readable result.
* `data` null  
Response payload; null on error.
* `request_id` string  
Request identifier for tracing.

application/jsonResponse fields
* `status_code` integer  
Application result code.
* `message` string  
Human-readable result.
* `data` null  
Response payload; null on error.
* `request_id` string  
Request identifier for tracing.

application/jsonResponse fields
* `status_code` integer  
Application result code.
* `message` string  
Human-readable result.
* `data` null  
Response payload; null on error.
* `request_id` string  
Request identifier for tracing.

application/jsonResponse fields
* `status_code` integer  
Application result code.
* `message` string  
Human-readable result.
* `data` null  
Response payload; null on error.
* `request_id` string  
Request identifier for tracing.

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

**Request example**

Gateway URL 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"
}'
```

**Example response**200 · Success400 · 10009 · Invalid parameters400 · 10008 · Order not found400 · 10013 · Order is not pending400 · 10038 · Transaction hash verification failed400 · 10039 · Manual verification requires an on-chain order400 · 10007 · Block already processed

application/json · Selected response fields

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