Consultar PIX

GET/v1/pix/{pixTransactionId}

Consulta o andamento de um pagamento Pix utilizando o identificador retornado na criação do QR Code.

Consultar Status do Pagamento Pix

Parâmetros

Exemplo de requisição

curl --request GET \
  --url 'https://api.enoqpay.com.br/gateway/v1/pix/{pixTransactionId}' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json'

Retorno (200)

Exemplo de resposta

{
  "statusCode": "05",
  "statusDescription": "Aguardando pagamento",
  "pixTransactionId": "bec7361e36349a3bdad466b73e10d10365ac0da6880d8aadd15b5f2590ff2d9c",
  "authorizationCode": "SE000ES182492Z591CTQOHZEYDNDVAHUVC",
  "amount": 1,
  "releaseAt": "2026-03-20T11:07:00"
}

Dicionário de dados

Erros

As respostas de erro conhecidas estão abaixo. Os retornos observados em homologação estão identificados separadamente dos exemplos documentados; as respostas podem variar conforme o ambiente e a configuração.

Observado em homologação

Requisição com corpo JSON vazio ou identificador sintético. O retorno abaixo mostra a validação realizada em homologação.

[
  {
    "tag": "PixTransactionId",
    "description": "PixTransactionId deve ter exatamente 64 caracteres"
  }
]

Campos da resposta de erro

A tabela reúne os campos presentes nos exemplos acima. Uma resposta HTTP sem corpo não inclui esses campos.