Issue a composite QR (immediate charge + recurrence)
One QR that charges the first amount now and, when paid,
takes the payer to authorize the recurrence. Payment emits
pix.in.completed and pix.automatic.qrcode.paid; the authorization
result arrives as pix.automatic.recurrence.*. identifier is a UUID
unique per account; requestExpiration and recurrence.debtor are
required.
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
accountId
Account identifier.
Headers
X-Tenant-Id
Tenant context used for authorization and routing.
Idempotency-Key
Optional client-generated idempotency token (recommended for safe retries).
Request
This endpoint expects an object.
identifier
Your UUID for the QR. Unique per account.
pixKey
Pix key of the account that receives the payment.
value
Amount charged by the QR.
requestExpiration
Deadline of the recurrence offer: after today and up to 30 days ahead. Without an offset it is read in Brasília time.
recurrence
Send exactly one of value or maximumValue.
message
payer
Response
Composite QR issued
recurrenceId
recurrenceIdentifier
status
identifier
qrCodeId
pixCopyPaste
Pix copia e cola.
image
QR image (base64 PNG).
dueDate
daysAfterDueDate
requestExpiration
createdAt
Errors
400
Bad Request Error
403
Forbidden Error
409
Conflict Error
422
Unprocessable Entity Error
502
Bad Gateway Error