# Enviar o hash da transação 

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

[Exemplo de requisição ↓](https://epusdt.com/pt/api/endpoints/submit-hash#request-example)

Envie `block_transaction_id` no corpo JSON para um pedido on-chain aguardando pagamento (status 1). O servidor verifica a transferência antes de atualizar o pedido.

## Parâmetros 

`trade_id` · `string` · PATH

ID da transação retornado pelo EPUSDT na criação do pedido.

## Corpo JSON 

| Campo obrigatório      | Tipo   | Exemplo |
| ---------------------- | ------ | ------- |
| block\_transaction\_id | string | 0x…     |

## Recursos relacionados 

* [Consultar status do pedido](https://epusdt.com/pt/api/endpoints/order-status)
* [Notificações ao lojista](https://epusdt.com/pt/api/payment#callbacks)

## Respostas

application/jsonCampos da resposta
* `status_code` integer  
Código de resultado da aplicação.
* `message` string  
Descrição do resultado.
* `data` object  
Dados retornados; null em caso de erro.

  * `trade_id` string
  * `block_transaction_id` string
  * `status` integer
* `request_id` string  
Identificador para rastrear a requisição.

application/jsonCampos da resposta
* `status_code` integer  
Código de resultado da aplicação.
* `message` string  
Descrição do resultado.
* `data` null  
Dados retornados; null em caso de erro.
* `request_id` string  
Identificador para rastrear a requisição.

application/jsonCampos da resposta
* `status_code` integer  
Código de resultado da aplicação.
* `message` string  
Descrição do resultado.
* `data` null  
Dados retornados; null em caso de erro.
* `request_id` string  
Identificador para rastrear a requisição.

application/jsonCampos da resposta
* `status_code` integer  
Código de resultado da aplicação.
* `message` string  
Descrição do resultado.
* `data` null  
Dados retornados; null em caso de erro.
* `request_id` string  
Identificador para rastrear a requisição.

application/jsonCampos da resposta
* `status_code` integer  
Código de resultado da aplicação.
* `message` string  
Descrição do resultado.
* `data` null  
Dados retornados; null em caso de erro.
* `request_id` string  
Identificador para rastrear a requisição.

application/jsonCampos da resposta
* `status_code` integer  
Código de resultado da aplicação.
* `message` string  
Descrição do resultado.
* `data` null  
Dados retornados; null em caso de erro.
* `request_id` string  
Identificador para rastrear a requisição.

application/jsonCampos da resposta
* `status_code` integer  
Código de resultado da aplicação.
* `message` string  
Descrição do resultado.
* `data` null  
Dados retornados; null em caso de erro.
* `request_id` string  
Identificador para rastrear a requisição.

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

**Exemplo de requisição**

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

**Exemplo de resposta**200 · Sucesso400 · 10009 · Parâmetros inválidos400 · 10008 · Pedido não encontrado400 · 10013 · O pedido não está pendente400 · 10038 · Verificação do hash da transação falhou.400 · 10039 · A verificação manual requer um pedido na blockchain.400 · 10007 · Bloco já processado.

application/json · Campos selecionados da resposta

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