Decode a Pix QR code via its payload URL
Decodes a dynamic Pix QR code by the payee-published JWS payload URL, normalizing static / immediate-dynamic / cobv sub-types into one null-safe response. Unlike the scan decode it takes a urlPayloadJson the upstream fetches; the payer document is sourced from the CRM alias for the upstream decode header.
Authorizations
JWT Bearer token authentication. Obtain token from /v1/login/oauth/access_token endpoint
using client credentials (clientId and clientSecret).
Include token in Authorization header:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Token expires after 3600 seconds (1 hour).
Body
The CRM account id of the scanning payer (sources the PI-PayerID document).
The payee-published JWS payload URL to decode (urlPayloadJson; schema-less).
Payer municipality code (codMun; cobv holiday calc).
Intended payment date (dPP; aaaa-mm-dd; cobv valorFinal calc).
Response
OK
The decoded amount in reais.
The decoded QR type (STATIC or DYNAMIC; cobv folds onto DYNAMIC).
The Pix Troco amount in reais (troco only).
The saque/troco PSS participant ISPB.
Additional data (dadosAdicionais).
Due date (cobv/static optional).
The SPI end-to-end id.
Whether the QR carries a Pix Saque leg.
Whether the QR carries a Pix Troco leg.
The recipient Pix key.
Conciliation id (idConciliacaoRecebedor).

