Overview
Authentication
Bank Account
Webhooks
Get QRCode by ID
Copy
curl --request GET \
--url https://api.owem.com.br/v4/i/pix/in/dynamic-qrcode/{txId} \
--header 'Authorization: <authorization>'Copy
{
"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/f9a0b1c2d3e4f5a6b7c8d9e05204000053039865802BR5909CLIENT6008SAOPAULO62070503***6304ABCD",
"pixKey": "abc12345-6789-0abc-def0-123456789abc",
"amount": 197.99,
"updatedAt": 1766523045000,
"uid": "7c4f3a2d8e1248a6b9c71f45e2"
}
}
PIX IN
Get QRCode by ID
Returns data of a previously created dynamic QRCode. Check status, amount and PIX charge details.
GET
https://api.owem.com.br
/
v4
/
i
/
pix
/
in
/
dynamic-qrcode
/
{txId}
Get QRCode by ID
Copy
curl --request GET \
--url https://api.owem.com.br/v4/i/pix/in/dynamic-qrcode/{txId} \
--header 'Authorization: <authorization>'Copy
{
"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/f9a0b1c2d3e4f5a6b7c8d9e05204000053039865802BR5909CLIENT6008SAOPAULO62070503***6304ABCD",
"pixKey": "abc12345-6789-0abc-def0-123456789abc",
"amount": 197.99,
"updatedAt": 1766523045000,
"uid": "7c4f3a2d8e1248a6b9c71f45e2"
}
}
Purpose
Returns data of a dynamic QR Code (PIX IN) previously created. ThetxId is the unique charge identifier and equals the entryId used in Ledger queries.
Authentication
Basic Auth required in format:
Basic {Base64(API_KEY:API_SECRET)}Path Parameters
Dynamic QR identifier generated at creation.
Response
UUID for tracking
Operation status
Number of returned items
Descriptive message (e.g., “QR Code consultado”)
Show data
Show data
Dynamic QR txId (=
entryId in Ledger)EMV-Co payload (copy-and-paste)
PIX key associated with the charge
Charge amount in BRL
Expiration date/time (ISO-8601)
Creation timestamp (ms)
Update timestamp (ms)
Internal alias (usually equals
id)Copy
{
"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/f9a0b1c2d3e4f5a6b7c8d9e05204000053039865802BR5909CLIENT6008SAOPAULO62070503***6304ABCD",
"pixKey": "abc12345-6789-0abc-def0-123456789abc",
"amount": 197.99,
"updatedAt": 1766523045000,
"uid": "7c4f3a2d8e1248a6b9c71f45e2"
}
}
Status Codes
| HTTP | Description |
|---|---|
| 200 | QR found |
| 400 | Invalid txId |
| 401 | Invalid credentials |
| 403 | IP not allowlisted |
| 404 | txId nonexistent/expired |
| 429 | Rate limit exceeded |
| 500 | Internal error |
If the QR is expired, regenerate the charge with
POST /v4/i/pix/in/dynamic-qrcode.The
txId of this resource is the identifier used for accounting confirmation
via GET /v4/i/ledger/entry-id/:entryId (where entryId = txId).Was this page helpful?
⌘I