Skip to main content
POST
Decode a scanned PIX QR code

Autorizaciones

Authorization
string
header
requerido

JWT bearer token issued by the identity provider.

Cuerpo

application/json
accountId
string
requerido

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

Ejemplo:

"acc-123"

qrCode
string
requerido

The scanned EMV QR-code payload to decode.

Ejemplo:

"00020126..."

Respuesta

OK

amount
integer<int64>
requerido

The decoded amount in centavos.

Ejemplo:

10050

payee
object
requerido

The decoded recipient identity.

qrCodeType
string
requerido

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

Ejemplo:

"DYNAMIC"

amountTroco
integer<int64>

The Pix Troco amount in centavos (troco only).

Ejemplo:

0

city
string

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

Ejemplo:

"Sao Paulo"

createdAt
string

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

Ejemplo:

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

description
string

Additional data (dadosAdicionais).

Ejemplo:

"Invoice 42"

dueDate
string

Due date (cobv/static optional).

Ejemplo:

"2026-12-31"

endToEndId
string

The SPI end-to-end id.

Ejemplo:

"E1234567890"

isPixSaque
boolean

Whether the QR carries a Pix Saque leg.

Ejemplo:

false

isPixTroco
boolean

Whether the QR carries a Pix Troco leg.

Ejemplo:

false

ispbPss
string

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

Ejemplo:

"00360305"

key
string

The recipient PIX key.

Ejemplo:

"recipient@bank.com"

presentedAt
string

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

Ejemplo:

"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.

Ejemplo:

0

txId
string

Conciliation id (idConciliacaoRecebedor).

Ejemplo:

"TX-001"