Skip to navigation

Generate blocked Pix Location QR for an account

Generates a Pix Location QR code blocked (status: BLOCKED). The emv can be printed or sent right away, but payment is refused until the charge is confirmed with PUT /v1/accounts/{accountId}/pix/qr-code/location/{identifier}/confirm. Requires the product to be enabled for the tenant (403 feature_disabled otherwise).

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

accountIdstringRequired
Account identifier.

Headers

X-Tenant-IdstringRequired
Tenant context used for authorization and routing.
Idempotency-KeystringRequired>=8 characters

Client-generated idempotency token.

Request

This endpoint expects an object.
pixKeystringRequired

PIX key of the receiving account (must be registered to the account).

identifierstringOptional<=38 characters

Unique identifier ([A-Za-z0-9._-], up to 38 characters), used to confirm, look up and cancel. When omitted the API generates one.

messagestringOptional<=140 characters
Message displayed to the payer.

Response

Location QR code generated, blocked until confirmation.
txidstring

QR code transaction ID (used as qrcodeId).

emvstring

EMV PIX copy-and-paste code (BR Code). Render this as the QR / “copia e cola”.

typeenum
Allowed values:
statusstring

QR status. ACTIVE right after creation; BLOCKED for a Location QR until it is confirmed.

identifierstring

Client-provided identifier (use for lookups).

valuedoubleOptional
Charge amount in BRL.
messagestringOptional
Message shown to the payer.
descriptionstringOptional

Same as message (alias).

accountIdstringOptional
Account that owns the charge.
pixKeystringOptional
PIX key used in the charge.
allowChangebooleanOptional
Whether the payer may change the amount.
createdAtdatetimeOptional
expiresAtdatetimeOptional

Last instant the QR accepts payment. For due-date and Location QR codes, the end of dueDate + daysAfterDueDate (Brasília).

locationIdstringOptional

Location QR identifier at the settlement bank (Location QR only). Accepted instead of identifier on confirmation.

dueDatedateOptional

Due day (due-date and confirmed Location QR only).

daysAfterDueDateintegerOptional

Days after the due date the QR still accepts payment (due-date and confirmed Location QR only).

deductiondoubleOptional

Deduction in BRL (due-date and confirmed Location QR only).

discountdoubleOptional

Discount in BRL (due-date and confirmed Location QR only).

interestdoubleOptional

Interest in BRL (due-date and confirmed Location QR only).

penaltydoubleOptional

Penalty in BRL (due-date and confirmed Location QR only).

finalValuedoubleOptional

Amount to pay up to the due date (due-date and confirmed Location QR only).

debtorobjectOptional

Debtor given at issuance (due-date and confirmed Location QR only).

receiverNamestringOptional

Receiver name shown to the payer (due-date and confirmed Location QR only).

Errors

400
Bad Request Error
403
Forbidden Error
500
Internal Server Error
502
Bad Gateway Error