Decodificar QR code Pix pela URL de payload
Decodifica um QR code Pix dinâmico pela URL de payload JWS publicada pelo recebedor, normalizando os subtipos estático / dinâmico-imediato / cobv em uma única resposta null-safe. Diferente da decodificação por scan, ele recebe uma urlPayloadJson que o upstream busca; o documento do pagador vem do alias do CRM para o cabeçalho de decodificação do upstream.
Autorizações
Autenticacao por token JWT Bearer. Obtenha o token no endpoint /v1/login/oauth/access_token
usando credenciais do cliente (clientId e clientSecret).
Inclua o token no header Authorization:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
O token expira apos 3600 segundos (1 hora).
Corpo
O id da conta no CRM do pagador que escaneia (fonte do documento PI-PayerID).
A URL de payload JWS publicada pelo recebedor a decodificar (urlPayloadJson; sem esquema).
Código do município do pagador (codMun; cálculo de feriado da cobv).
Data pretendida de pagamento (dPP; aaaa-mm-dd; cálculo de valorFinal da cobv).
Resposta
OK
O valor decodificado em reais.
O tipo de QR decodificado (STATIC ou DYNAMIC; cobv se dobra em DYNAMIC).
O valor do Pix Troco em reais (somente troco).
O ISPB do participante PSS de saque/troco.
Dados adicionais (dadosAdicionais).
Data de vencimento (cobv/estático opcional).
O id ponta a ponta do SPI.
Se o QR carrega uma perna de Pix Saque.
Se o QR carrega uma perna de Pix Troco.
A chave Pix do recebedor.
Id de conciliação (idConciliacaoRecebedor).

