Create Static QR Code
POST/v1/pix/deposits/qr-codes/static
Generate a new static 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.
PIX txID.
Value in R$ cents.
User friendly static QR Code identifier.
User defined payment description.
Expiration date to pay static QR Code. Max date is 3 months ahead.
If it is true, static QR Code can be paid many times. When it is false, expiration date is required.
User defined payment merchant ID.
Responses
- 201
- 400
- 401
- 422
The static QR Code returned successfully.
- application/json
- Schema
- Example (from schema)
Schema
Static QR Code ID.
PIX txID.
EMV code.
Associated key UUID.
Value in R$ cents.
User defined payment ID.
User defined payment description.
Expiration date to pay qrCode. Max date is 3 months ahead.
If it is true, QrCode can be paid many times. When it is false, expiration date is required.
Possible values: [PENDING, READY, DELETING, DELETED, ERROR]
Static QR Code state.
Static QR Code created at.
{
"id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"txid": "f6e2e08429b94935a0595473b",
"emv": "f6e2e084-29b9-4935-a059-5473b13033aa",
"key_id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"value": 1299,
"summary": "party-payment",
"description": "User defined description",
"expiration_date": "2026-03-26T14:02:58.715Z",
"payable_many_times": true,
"state": "PENDING",
"created_at": "2026-03-26T14:02:58.715Z"
}
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.