Create Instant-Billing Dynamic QR Code
POST/pix/deposits/qr-codes/dynamic/instant-billing
Generate a new instant-billing dynamic QR Code for the user.
Request
Header Parameters
The transaction ID is a UUID (v4) used to uniquely identify the object that will be created. All objects must have an identifier.
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.
- application/json
Body
required
PIX Key.
Value in R$ cents
Expiration date to pay dynamic QR Code.
User friendly dynamic QR Code identifier.
User defined payment description.
Payer request.
Responses
- 201
- 400
- 401
- 422
The created dynamic QR Code returned successfully.
- application/json
- Schema
- Example (from schema)
Schema
Dynamic QR Code ID.
Associated key ID.
Possible values: [PENDING, READY, ERROR, PAID]
Dynamic QR Code state.
User defined payment ID.
User defined payment description.
Expiration date to pay dynamic QR Code.
Dynamic QR Code created at.
{
"id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"key_id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"state": "PENDING",
"summary": "party-payment",
"description": "The party payment.",
"expiration_date": "2024-07-29T15:51:28.071Z",
"created_at": "2026-04-10T18:12:01.643Z"
}
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.