Skip to main content
POST
Decode a scanned PIX QR code

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"

qrCode
string
obrigatório

The scanned EMV QR-code payload to decode.

Exemplo:

"00020126..."

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"