Skip to main content
POST
Decode a PIX QR code via its payload URL

Autorizações

Authorization
string
header
obrigatório

JWT bearer token issued by the identity provider.

Corpo

application/json
accountId
string
obrigatório

The CRM account id of the scanning payer (sources the PI-PayerID document).

Exemplo:

"acc-123"

payloadUrl
string
obrigatório

The payee-published JWS payload URL to decode (urlPayloadJson; schema-less).

Exemplo:

"example.com/pix/8b3da2f3"

municipalityCode
string

Payer municipality code (codMun; cobv holiday calc).

Exemplo:

"3550308"

paymentDate
string

Intended payment date (dPP; aaaa-mm-dd; cobv valorFinal calc).

Exemplo:

"2026-01-30"

Resposta

OK

amount
integer<int64>
obrigatório

The decoded amount in centavos.

Exemplo:

10050

payee
object
obrigatório

The decoded recipient identity.

qrCodeType
string
obrigatório

The decoded QR type (STATIC or DYNAMIC; cobv folds onto DYNAMIC).

Exemplo:

"DYNAMIC"

amountTroco
integer<int64>

The Pix Troco amount in centavos (troco only).

Exemplo:

0

city
string

Recipient city (cidade; §8.3.3 Obrg=Sim on every block).

Exemplo:

"Sao Paulo"

createdAt
string

When the dynamic charge was created (dtHrCriacao; §8.3.3 Obrg=Sim).

Exemplo:

"2020-01-20T12:29:15.043Z"

description
string

Additional data (dadosAdicionais).

Exemplo:

"Invoice 42"

dueDate
string

Due date (cobv/static optional).

Exemplo:

"2026-12-31"

endToEndId
string

The SPI end-to-end id.

Exemplo:

"E1234567890"

isPixSaque
boolean

Whether the QR carries a Pix Saque leg.

Exemplo:

false

isPixTroco
boolean

Whether the QR carries a Pix Troco leg.

Exemplo:

false

ispbPss
string

The saque/troco PSS participant ISPB (a v5.5.0 string; leading zeros are significant).

Exemplo:

"00360305"

key
string

The recipient PIX key.

Exemplo:

"recipient@bank.com"

presentedAt
string

When the payer captured the QR, i.e. the moment of this decode (dtHrApresentacao; §8.3.3 Obrg=Sim).

Exemplo:

"2020-01-23T10:21:34.107Z"

revision
integer<int64>

Charge revision counter (revisao). Always present on a DYNAMIC decode, including at its initial value 0; absent on a STATIC one, whose §8.3.3 block declares no revisao.

Exemplo:

0

txId
string

Conciliation id (idConciliacaoRecebedor).

Exemplo:

"TX-001"