Consultar status do pedido de pagamento

Consulta detalhes do pedido de pagamento por número de pedido da plataforma, retornando os status atuais e os timestamps principais.

GET/openapi/payin/orders/{orderNo}

Cabeçalhos

Campo	Tipo	Obrigatório	Descrição
x-api-key	string	Sim	Comerciante API Key. Use o valor que começa com mch_ na página de configurações do comerciante API.
x-merchant-uid	string	Sim	Merchant UID.
x-timestamp	string	Sim	Milissegundos de 13 dígitos timestamp. O desvio padrão permitido do relógio é de 5 minutos.
x-nonce	string	Sim	String aleatória exclusiva para cada solicitação, com até 128 caracteres. A reutilização é rejeitada.
x-signature	string	Sim	Assinatura hexadecimal gerada com HMAC-SHA256. A carga útil contém Merchant UID, timestamp, nonce, método, caminho, query canônico e body canônico.

Parâmetros

Campo	Tipo	Obrigatório	Descrição
orderNo	string	Sim	Parâmetro de caminho. O número do pedido da plataforma retornado ao criar a ordem de pagamento.

Exemplo de requisição

GET /openapi/payin/orders/PI1776193200123ABCD1234

Campos da resposta

Campo	Tipo	Obrigatório	Descrição
orderNo	string	Sim	Número de pedido da plataforma.
merchantOrderNo	string \| null	Sim	Número do pedido do comerciante.
bindKey	string \| null	Sim	Chave vinculativa para recarga de associado. Geralmente vazio para ordens de pagamento compartilhadas.
amount	string \| null	Sim	Valor do pedido.
paidAmount	string \| null	Sim	Valor pago.
address	string \| null	Sim	Endereço de recebimento.
cashierUrl	string \| null	Sim	Confira URL.
paymentUri	string \| null	Sim	Pagamento de carteira URI.
expireAt	string \| null	Sim	Prazo de validade do pedido.
createdAt	string \| null	Sim	Tempo criado.
detectedAt	string \| null	Sim	Hora de detecção do pagamento.
confirmedAt	string \| null	Sim	Hora de confirmação.
completedAt	string \| null	Sim	Hora de conclusão.
status	string	Sim	Pedido status.

Exemplo de resposta

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

Exemplos de código

cURL Exemplo de solicitação

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 o sucesso final do negócio, use status=completed.