Confirm Pix Location QR for an account
Confirms a blocked Pix Location QR code with the charge terms (amount,
due date, debtor and optional charges) and releases it for payment.
The emv does not change. The PIX key and the identifier are always
the ones from generation. When the settlement bank refuses the
confirmation, the error carries details.qrStatus: BLOCKED: the QR
stays blocked and can be confirmed again; the refusal is recorded in
the timeline as qrcode.location_confirm_failed. A confirmation
already in progress for the same QR returns 409 invalid_state. If
the settlement bank does not answer and its state cannot be checked,
the error comes without details.qrStatus: look the QR up before
confirming again.
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
The identifier used at generation, or the locationId returned by it.
Headers
Optional client-generated idempotency token (recommended for safe retries).
Unix seconds. Required on the signed host; tolerance is 300s either way (403 request_timestamp_skew).
Lowercase hex SHA-256 of the body. An empty body hashes the empty string, so the header is always present. Mismatch returns 400 body_hash_mismatch.
Detached JWS (<protected>..<signature>, ES256 or PS256) over METHOD\nPATH?QUERY\nTIMESTAMP\nIDEMPOTENCY_KEY_OR_EMPTY\nX_CONTENT_SHA256.
Request
Due day (YYYY-MM-DD, Brasília). Cannot be in the past.
Debtor of a due-date or Location charge. Who actually paid comes in payer after payment.
Amount to pay up to the due date. When omitted, value − deduction − discount.
Response
Location QR code confirmed; it now accepts payment.
QR code transaction ID (used as qrcodeId).
EMV PIX copy-and-paste code (BR Code). Render this as the QR / “copia e cola”.
QR status. ACTIVE right after creation; BLOCKED for a Location QR until it is confirmed.
Client-provided identifier (use for lookups).
Same as message (alias).
Last instant the QR accepts payment. For due-date and Location QR codes, the end of dueDate + daysAfterDueDate (Brasília).
Location QR identifier at the settlement bank (Location QR only). Accepted instead of identifier on confirmation.
Due day (due-date and confirmed Location QR only).
Days after the due date the QR still accepts payment (due-date and confirmed Location QR only).
Deduction in BRL (due-date and confirmed Location QR only).
Discount in BRL (due-date and confirmed Location QR only).
Interest in BRL (due-date and confirmed Location QR only).
Penalty in BRL (due-date and confirmed Location QR only).
Amount to pay up to the due date (due-date and confirmed Location QR only).
Debtor given at issuance (due-date and confirmed Location QR only).
Receiver name shown to the payer (due-date and confirmed Location QR only).