Consultar el estado del pedido de pago

Consulta los detalles del pedido de pago por número de pedido de la plataforma y devuelve el status actual y la clave timestamp.

GET/openapi/payin/orders/{orderNo}

Encabezados

Campo	Tipo	Obligatorio	Descripción
x-api-key	string	Sí	Comerciante API Key. Utilice el valor que comienza con mch_ de la página de configuración del comerciante API.
x-merchant-uid	string	Sí	Merchant UID.
x-timestamp	string	Sí	Milisegundo de 13 dígitos timestamp. La desviación del reloj permitida por defecto es de 5 minutos.
x-nonce	string	Sí	Cadena aleatoria única para cada solicitud, hasta 128 caracteres. Se rechaza la reutilización.
x-signature	string	Sí	Firma hexadecimal generada con HMAC-SHA256. La carga útil contiene Merchant UID, timestamp, nonce, método, ruta, query canónico y body canónico.

Parámetros

Campo	Tipo	Obligatorio	Descripción
orderNo	string	Sí	Parámetro de ruta. El número de pedido de la plataforma devuelto al crear el pedido de pago.

Ejemplo de solicitud

GET /openapi/payin/orders/PI1776193200123ABCD1234

Campos de respuesta

Campo	Tipo	Obligatorio	Descripción
orderNo	string	Sí	Número de pedido de la plataforma.
merchantOrderNo	string \| null	Sí	Número de pedido del comerciante.
bindKey	string \| null	Sí	Clave vinculante para recarga de socios. Generalmente vacío para órdenes de pago compartido.
amount	string \| null	Sí	Importe del pedido.
paidAmount	string \| null	Sí	Monto pagado.
address	string \| null	Sí	Dirección de recepción.
cashierUrl	string \| null	Sí	Pagar URL.
paymentUri	string \| null	Sí	Pago de billetera URI.
expireAt	string \| null	Sí	Hora de vencimiento del pedido.
createdAt	string \| null	Sí	Tiempo creado.
detectedAt	string \| null	Sí	Hora de detección de pago.
confirmedAt	string \| null	Sí	Hora de confirmación.
completedAt	string \| null	Sí	Hora de finalización.
status	string	Sí	Orden status.

Ejemplo de respuesta

{
  "orderNo": "PI1776193200123ABCD1234",
  "merchantOrderNo": "M202604150001",
  "bindKey": "USER_90001",
  "amount": "100.000000",
  "paidAmount": "100.000000",
  "address": "TXYZ3x9nJ5J4xP2gh6mQW7rT31jB8Y2pA9",
  "cashierUrl": "https://open.uugate.com/SK/PI1776193200123ABCD1234",
  "paymentUri": "TRON:TXYZ3x9nJ5J4xP2gh6mQW7rT31jB8Y2pA9?token=USDT&amount=100.000000",
  "expireAt": "2026-04-18T06:30:00.000Z",
  "createdAt": "2026-04-18T06:00:00.000Z",
  "detectedAt": "2026-04-18T06:08:15.000Z",
  "confirmedAt": "2026-04-18T06:09:02.000Z",
  "completedAt": "2026-04-18T06:09:02.000Z",
  "status": "completed"
}

Ejemplos de código

cURL Ejemplo de solicitud

curl 'https://api.uugate.com/openapi/payin/orders/PI1776193200123ABCD1234' \
  -H 'x-api-key: mch_xxxxxxxxxxxxxxxxxxxx' \
  -H 'x-merchant-uid: 880001' \
  -H 'x-timestamp: 1776193500000' \
  -H 'x-nonce: 0d51f901bb7340ffb0cf70f5f0f26018' \
  -H 'x-signature: <SIGNATURE_HEX>'

Notas

Para el éxito empresarial final, utilice status=completed.