Get Dynamic QR Code by ID
GET/pix/deposits/qr-codes/dynamic/:id
Retrieve a specific dynamic QR Code associated with the user using its unique identifier.
Request
Path Parameters
Dynamic QR Code ID.
Header Parameters
The nonce ID is a UUID (v4) used to uniquely identify the request. All requests must have an identifier.
Possible values: [pt-BR, en-US]
Indicates the preferred language. Defaults to Brazilian Portuguese if unspecified.
UUID (v4) of the product that the request should use. Send it explicitly when the authenticated user has more than one product or when the integration must select a specific product. If omitted and the endpoint does not require it, the API uses the authenticated user's default product.
UUID (v4) of the user on whose behalf the request should run within the selected product. If omitted, the request runs as the authenticated user. Requires x-product-uuid.
Responses
- 200
- 400
- 401
- 422
The dynamic QR Code returned successfully.
- application/json
- Schema
- Example (from schema)
Schema
Dynamic QR Code ID.
Dynamic QR Code txID.
EMV code.
Dynamic QR Code expiration date.
Associated key ID.
Value in R$ cents.
User defined dynamic QR Code description.
Possible values: [PENDING, READY, ERROR, PAID]
Dynamic QR Code state.
Dynamic QR Code created at.
{
"id": "abf6c3c6-f54b-4fbf-83ee-75ecf5f36c66",
"txid": "f6e2e084-29b9-4935-a059-5473b13033aa",
"emv": "00020101021226910014br.gov.bcb.pix2569bankaddress.com.br/pix/v2/cob/8b358702141e4162bd68eedfe7fb45f4520400005303986540523.005802BR5924USER",
"expiration_date": "2026-04-10T18:12:01.644Z",
"key_id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"value": 1299,
"description": "Dynamic QR Code to receive payment.",
"state": "READY",
"created_at": "2026-04-10T18:12:01.644Z"
}
If any required params are missing or has invalid format or type.
User authentication failed.
If any required params are missing or has invalid format or type.