# Crear un pedido GMPay 

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

[Ejemplo de solicitud ↓](https://epusdt.com/es/api/endpoints/create-order#request-example)

Firma la solicitud en tu servidor y dirige al comprador a `payment_url`. Envía `token` y `network` juntos u omite ambos para que el comprador elija.

## Parámetros 

| Campo         | Tipo   | Obligatorio | Descripción                                                                                                                                                                                           |
| ------------- | ------ | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| pid           | Cadena | Sí          | El identificador de proceso (PID) del comerciante se utilizaba anteriormente para buscar la clave de firma.                                                                                           |
| order\_id     | Cadena | Sí          | Identificador único de pedido de comercio, hasta 32 caracteres.                                                                                                                                       |
| currency      | Cadena | Sí          | Moneda fiduciaria, por ejemplo usd o cny.                                                                                                                                                             |
| token         | Cadena | Condicional | Activo recibido. Asociar con la red o omitir ambos.                                                                                                                                                   |
| network       | Cadena | Condicional | ID de red desde la configuración pública, por ejemplo, binance.                                                                                                                                       |
| amount        | Número | Sí          | Monto de Fiat mayor que 0.01.                                                                                                                                                                         |
| notify\_url   | Cadena | Sí          | URL de devolución de llamada asíncrona.                                                                                                                                                               |
| redirect\_url | Cadena | No          | URL de retorno del navegador.                                                                                                                                                                         |
| name          | Cadena | No          | Nombre del producto o pedido.                                                                                                                                                                         |
| payment\_type | Cadena | No          | Se asigna GMPay de forma predeterminada. EPay (insensible a mayúsculas) selecciona el formato de llamada de retorno de EPay y requiere un PID numérico. Incluir cualquier valor no vacío en la firma. |
| signature     | Cadena | Sí          | Firma HMAC-SHA256 de 64 caracteres en minúsculas.                                                                                                                                                     |

La firma del ejemplo usa la clave de demostración `epusdt_secret_key`. Vuelve a calcularla en tu servidor si cambian los parámetros o la clave.

## Recursos relacionados 

* [Abrir la página de pago](https://epusdt.com/es/api/endpoints/open-checkout)
* [Firmas](https://epusdt.com/es/api/payment#signing)

## Respuestas

application/jsonCampos de respuesta
* `status_code` integer  
Código de resultado de la aplicación.
* `message` string  
Descripción del resultado.
* `data` object  
Datos devueltos; null en caso de error.

  * `trade_id` string
  * `order_id` string
  * `status` integer
  * `expiration_time` integer
  * `payment_url` string
* `request_id` string  
Identificador para rastrear la solicitud.

application/jsonCampos de respuesta
* `status_code` integer  
Código de resultado de la aplicación.
* `message` string  
Descripción del resultado.
* `data` null  
Datos devueltos; null en caso de error.
* `request_id` string  
Identificador para rastrear la solicitud.

application/jsonCampos de respuesta
* `status_code` integer  
Código de resultado de la aplicación.
* `message` string  
Descripción del resultado.
* `data` null  
Datos devueltos; null en caso de error.
* `request_id` string  
Identificador para rastrear la solicitud.

application/jsonCampos de respuesta
* `status_code` integer  
Código de resultado de la aplicación.
* `message` string  
Descripción del resultado.
* `data` null  
Datos devueltos; null en caso de error.
* `request_id` string  
Identificador para rastrear la solicitud.

application/jsonCampos de respuesta
* `status_code` integer  
Código de resultado de la aplicación.
* `message` string  
Descripción del resultado.
* `data` null  
Datos devueltos; null en caso de error.
* `request_id` string  
Identificador para rastrear la solicitud.

application/jsonCampos de respuesta
* `status_code` integer  
Código de resultado de la aplicación.
* `message` string  
Descripción del resultado.
* `data` null  
Datos devueltos; null en caso de error.
* `request_id` string  
Identificador para rastrear la solicitud.

application/jsonCampos de respuesta
* `status_code` integer  
Código de resultado de la aplicación.
* `message` string  
Descripción del resultado.
* `data` null  
Datos devueltos; null en caso de error.
* `request_id` string  
Identificador para rastrear la solicitud.

application/jsonCampos de respuesta
* `status_code` integer  
Código de resultado de la aplicación.
* `message` string  
Descripción del resultado.
* `data` null  
Datos devueltos; null en caso de error.
* `request_id` string  
Identificador para rastrear la solicitud.

application/jsonCampos de respuesta
* `status_code` integer  
Código de resultado de la aplicación.
* `message` string  
Descripción del resultado.
* `data` null  
Datos devueltos; null en caso de error.
* `request_id` string  
Identificador para rastrear la solicitud.

application/jsonCampos de respuesta
* `status_code` integer  
Código de resultado de la aplicación.
* `message` string  
Descripción del resultado.
* `data` null  
Datos devueltos; null en caso de error.
* `request_id` string  
Identificador para rastrear la solicitud.

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

**Ejemplo de solicitud**

URL de la pasarela 

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

**Ejemplo de respuesta**200 · Éxito401 · Firma no válida400 · 10009 · Parámetros inválidos.400 · 10041 · URL de notificación inválida.400 · 10002 · El pedido ya existe400 · 10004 · Cantidad por debajo de la precisión del pago.400 · 10014 · Red desactivada400 · 10016 · El activo no se encontró.400 · 10003 · No se dispone de dirección de entrega.400 · 10005 · No hay combinación disponible de dirección/cantidad.

application/json · Campos de respuesta seleccionados

```
{
  "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"
}
```
