Visão Geral
Autenticação
Conta Bancária
Ledger
Buscar QRCode por ID
Copiar
curl --request GET \
--url https://api.owem.com.br/v4/i/pix/in/dynamic-qrcode/{txId} \
--header 'Authorization: <authorization>'Copiar
{
"requestId": "a111b222-c333-4d44-8e55-f66677788899",
"success": true,
"size": 1,
"message": "QR Code consultado",
"data": {
"createdAt": 1766523042000,
"id": "7c4f3a2d8e1248a6b9c71f45e2",
"dueDate": "2025-12-25T12:00:00.000Z",
"emv": "00020101021226840014br.gov.bcb.pix2562qrcode.owem.com.br/pix/f9a0b1c2d3e4f5a6b7c8d9e05204000053039865802BR5909CLIENTE6008SAOPAULO62070503***6304ABCD",
"pixKey": "abc12345-6789-0abc-def0-123456789abc",
"amount": 197.99,
"updatedAt": 1766523045000,
"uid": "7c4f3a2d8e1248a6b9c71f45e2"
}
}
PIX IN
Buscar QRCode por ID
Retorna os dados de um QRCode dinâmico previamente criado.
GET
https://api.owem.com.br
/
v4
/
i
/
pix
/
in
/
dynamic-qrcode
/
{txId}
Buscar QRCode por ID
Copiar
curl --request GET \
--url https://api.owem.com.br/v4/i/pix/in/dynamic-qrcode/{txId} \
--header 'Authorization: <authorization>'Copiar
{
"requestId": "a111b222-c333-4d44-8e55-f66677788899",
"success": true,
"size": 1,
"message": "QR Code consultado",
"data": {
"createdAt": 1766523042000,
"id": "7c4f3a2d8e1248a6b9c71f45e2",
"dueDate": "2025-12-25T12:00:00.000Z",
"emv": "00020101021226840014br.gov.bcb.pix2562qrcode.owem.com.br/pix/f9a0b1c2d3e4f5a6b7c8d9e05204000053039865802BR5909CLIENTE6008SAOPAULO62070503***6304ABCD",
"pixKey": "abc12345-6789-0abc-def0-123456789abc",
"amount": 197.99,
"updatedAt": 1766523045000,
"uid": "7c4f3a2d8e1248a6b9c71f45e2"
}
}
Finalidade
Retorna os dados de um QR Code dinâmico (PIX IN) previamente criado. OtxId é o identificador único da cobrança e equivale ao entryId usado nas consultas de Ledger.
Autenticação
Basic Auth obrigatório no formato:
Basic {Base64(API_KEY:API_SECRET)}Path Parameters
Identificador do QR dinâmico gerado na criação.
Resposta
UUID para rastreio
Status da operação
Quantidade de itens retornados
Mensagem descritiva (ex: “QR Code consultado”)
Mostrar data
Mostrar data
txId do QR dinâmico (=
entryId no Ledger)Payload EMV-Co (copia-e-cola)
Chave PIX associada à cobrança
Valor da cobrança em BRL
Data/hora de expiração (ISO-8601)
Timestamp de criação (ms)
Timestamp de atualização (ms)
Alias interno (geralmente igual ao
id)Copiar
{
"requestId": "a111b222-c333-4d44-8e55-f66677788899",
"success": true,
"size": 1,
"message": "QR Code consultado",
"data": {
"createdAt": 1766523042000,
"id": "7c4f3a2d8e1248a6b9c71f45e2",
"dueDate": "2025-12-25T12:00:00.000Z",
"emv": "00020101021226840014br.gov.bcb.pix2562qrcode.owem.com.br/pix/f9a0b1c2d3e4f5a6b7c8d9e05204000053039865802BR5909CLIENTE6008SAOPAULO62070503***6304ABCD",
"pixKey": "abc12345-6789-0abc-def0-123456789abc",
"amount": 197.99,
"updatedAt": 1766523045000,
"uid": "7c4f3a2d8e1248a6b9c71f45e2"
}
}
Códigos de Status
| HTTP | Descrição |
|---|---|
| 200 | QR encontrado |
| 400 | txId inválido |
| 401 | Credenciais inválidas |
| 403 | IP não allowlisted |
| 404 | txId inexistente/expirado |
| 429 | Rate limit excedido |
| 500 | Erro interno |
Se o QR estiver expirado, regenere a cobrança com
POST /v4/i/pix/in/dynamic-qrcode.O
txId deste recurso é o identificador usado para confirmação contábil via
GET /v4/i/ledger/entry-id/:entryId (onde entryId = txId).Esta página foi útil?
⌘I