Decodificar un QR Pix mediante su URL de payload
Decodifica un QR Pix dinámico mediante la URL de payload JWS publicada por el beneficiario, normalizando los subtipos static / immediate-dynamic / cobv en una única respuesta segura ante nulos. A diferencia de la decodificación por escaneo, toma una urlPayloadJson que el upstream obtiene; el documento del pagador proviene del alias del CRM para el header de decodificación del upstream.
Autorizaciones
Autenticación con token JWT Bearer. Obtén el token desde el endpoint /v1/login/oauth/access_token
usando credenciales de cliente (clientId y clientSecret).
Incluye el token en el encabezado Authorization:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
El token expira después de 3600 segundos (1 hora).
Cuerpo
El id de cuenta del CRM del pagador que escanea (aporta el documento PI-PayerID).
La URL de payload JWS publicada por el beneficiario que se va a decodificar (urlPayloadJson; sin esquema).
Código de municipio del pagador (codMun; cálculo de feriados de cobv).
Fecha de pago prevista (dPP; aaaa-mm-dd; cálculo de valorFinal de cobv).
Respuesta
OK
El monto decodificado en reales.
El tipo de QR decodificado (STATIC o DYNAMIC; cobv se pliega sobre DYNAMIC).
El monto de Pix Troco en reales (solo troco).
El ISPB del participante PSS de saque/troco.
Datos adicionales (dadosAdicionais).
Fecha de vencimiento (opcional para cobv/static).
El end-to-end id del SPI.
Si el QR lleva un tramo de Pix Saque.
Si el QR lleva un tramo de Pix Troco.
La clave Pix del beneficiario.
Id de conciliación (idConciliacaoRecebedor).

