# Criar um pedido GMPay 

**POST**`https://pay.example.com/payments/gmpay/v1/order/create-transaction`

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

Assine a solicitação no servidor e direcione o comprador a `payment_url`. Envie `token` e `network` juntos ou omita ambos para permitir a escolha no checkout.

## Parâmetros 

| Campo         | Tipo   | Obrigatório | Descrição                                                                                                                                                                      |
| ------------- | ------ | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| pid           | String | Sim         | O PID do comerciante era usado para consultar a chave de assinatura.                                                                                                           |
| order\_id     | String | Sim         | Identificador único de pedido de comerciante, até 32 caracteres.                                                                                                               |
| currency      | String | Sim         | Moeda fiduciária, por exemplo usd ou cny.                                                                                                                                      |
| token         | String | Condicional | Ativo recebido. Combinar com a rede ou omitir ambos.                                                                                                                           |
| network       | String | Condicional | ID da rede a partir da configuração pública, por exemplo, binance.                                                                                                             |
| amount        | Número | Sim         | Valor do Fiat superior a 0,01.                                                                                                                                                 |
| notify\_url   | String | Sim         | URL de callback de sucesso assíncrono.                                                                                                                                         |
| redirect\_url | String | Não         | URL de retorno do navegador.                                                                                                                                                   |
| name          | String | Não         | Nome do produto ou pedido.                                                                                                                                                     |
| payment\_type | String | Não         | Utiliza GMPay por padrão. EPay (em qualquer formato de letra) seleciona o formato de callback de EPay e requer um PID numérico. Inclua qualquer valor não vazio na assinatura. |
| signature     | String | Sim         | Assinatura HMAC-SHA256 de 64 caracteres em minúsculas.                                                                                                                         |

A assinatura do exemplo usa a chave de demonstração `epusdt_secret_key`. Recalcule-a no servidor se alterar os parâmetros ou a chave.

## Recursos relacionados 

* [Abrir o checkout](https://epusdt.com/pt/api/endpoints/open-checkout)
* [Assinaturas](https://epusdt.com/pt/api/payment#signing)

## 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
  * `order_id` string
  * `status` integer
  * `expiration_time` integer
  * `payment_url` string
* `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.

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 

```
curl -i -X POST \
  'https://pay.example.com/payments/gmpay/v1/order/create-transaction' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "pid": "1000",
  "order_id": "ORD202605230001",
  "currency": "cny",
  "token": "usdt",
  "network": "tron",
  "amount": 100,
  "notify_url": "https://merchant.example/notify",
  "redirect_url": "https://merchant.example/return",
  "name": "VIP",
  "signature": "6f874b1919d95081835e2809b620e354a5866f5a6dbb2e432d1627f1eb10059d"
}'
```

**Exemplo de resposta**200 · Sucesso401 · Assinatura inválida400 · 10009 · Parâmetros inválidos400 · 10041 · URL de notificação inválida.400 · 10002 · O pedido já existe400 · 10004 · Valor abaixo da precisão do pagamento400 · 10014 · Rede desativada400 · 10016 · Recurso não encontrado400 · 10003 · Sem endereço de entrega disponível.400 · 10005 · Nenhuma combinação de endereço/valor disponível.

application/json · Campos selecionados da resposta

```
{
  "status_code": 200,
  "message": "success",
  "data": {
    "trade_id": "20260523171652123456001",
    "order_id": "ORD202605230001",
    "status": 1,
    "expiration_time": 1779530812,
    "payment_url": "https://pay.example.com/pay/checkout-counter/20260523171652123456001"
  },
  "request_id": "b1344d70-ff19-4543-b601-37abfb3b3686"
}
```
