Skip to main content
POST
Create an immediate dynamic composite PIX Automatico QR code

Authorizations

Authorization
string
header
required

JWT bearer token issued by the identity provider.

Body

application/json
accountId
string
required

The CRM account id of the recipient (sources name + city).

Example:

"acc-123"

jwkUrl
string
required

JWK Set URL (urlJwk; no scheme).

Example:

"example.com/jwks"

key
string
required

The recipient PIX key the composite QR pays into.

Example:

"fulano.tal@provedor.com.br"

originalAmount
integer<int64>
required

Original charge amount in centavos (valorOriginal).

Example:

100001

paymentPayloadUrl
string
required

Payment JWS host URL (urlPayloadJson; no scheme).

Example:

"pix.example.com/cob/abc"

recurrence
object
required

The embedded recurrence configuration (dadosRecorrencia).

recurrencePayloadUrl
string
required

Recurrence JWS host URL (urlPayloadJsonRec; no scheme).

Example:

"pix.example.com/rec/def"

txId
string
required

Conciliation id (idConciliacaoRecebedor).

Example:

"JDPI2020010300000000000000000000001"

certificateIspb
string

Indirect-PSP certificate ISPB (ispbCertificadoJws, string).

Example:

"04358798"

description
object[] | null

Optional additional-data entries (dadosAdicionais).

expirationTime
integer<int64>

QR expiration in seconds (0 = JDPI default).

Example:

86400

payer
object

Optional payer block.

zipCode
string

Recipient postal code (cep).

Example:

"01227200"

Response

Created

qrCode
string
required

The generated EMV composite-QR payload (base64-decoded, ready to render).

Example:

"00020126..."

documentId
string

The recurrence/charge document id (idDocumento, GUID).

Example:

"52c43361-caa1-4ddb-9152-708426a25db3"

recurrencePayload
string

The signed recurrence JWS (payloadJwsRecorrencia).

Example:

"eyJhbGciOiJQUzUxMi..."