Decodificar Código QR

Visión General

Este endpoint permite decodificar la cadena extraída de un Código QR y devolver la información estructurada necesaria para iniciar un pago (monto, clave destino, comercio, impuestos, canal, etc.).

Tipos de QR

Los tipos de QR soportados son: Dinámicos (DYNAMIC) y Estáticos (STATIC).

Detalles del Endpoint

Parámetro	Descripción
Endpoint	https://api.paas.sandbox.co.passportfintech.com/v1/qrcodes/decode
Método	POST
Encabezados	Content-Type: application/json, Authorization
Autenticación	Token de Acceso (Bearer Token)

Cuerpo de la Solicitud

Parámetro	Tipo	Requerido	Descripción
customer_id	String	Sí	Identificador del cliente que solicita la decodificación.
qr_code_data	String	Sí	Cadena EMVCo extraída del QR a decodificar.

Ejemplo de Solicitud

curl --location --request POST 'https://api.paas.sandbox.co.passportfintech.com/v1/qrcodes/decode' \

--header 'Content-Type: application/json' \

--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \

--data '{

"customer_id": "050e8ba8-e079-46bd-a052-427a38f35ef0",

"qr_code_data": "00020101021226330015CO.COM.VISI.LLA0210370222232949270015CO.COM.VISI.RED0104VISI52040412530317054130000014907.005802CO5914Merchant OW3BX6011Bucaramanga610610101062250808PURCHASE100911414310480290017CO.COM.VISI.CANAL0104MPOS81260016CO.COM.VISI.CIVA01020282240015CO.COM.VISI.IVA0101083250016CO.COM.VISI.BASE0101084260016CO.COM.VISI.CINC01020285240015CO.COM.VISI.INC0101090310017CO.COM.VISI.TRXID0106P1490791870015CO.COM.VISI.SEC0164474ba16e2433a928a69b7a6eb54efbabecba7c0aef862d39fca7b379d057ba1b63045B27"

Cuerpo de la Respuesta

Código HTTP: 200 OK.

Ejemplo de Respuesta

{

"amount": {

"currency": "COP",

"value": "14907"

"additional_info": {

"transaction_purpose": "PURCHASE"

"inc": {

"inc_type": "FIXED",

"inc_value": "0"

"key": {

"key_value": "3702222329",

"key_type": "PHONE"

Importante

La respuesta de Códigos QR no incluye la imagen en formato Base64 (qr_code_data).

Errores Comunes y Manejo

Código HTTP	Significado	Descripción
400 Bad Request	Datos inválidos	`customer_id` o `qr_code_data` ausentes/malformados; cadena EMVCo inválida.
401 Unauthorized	Token inválido	El token de acceso ha expirado o es inválido.
403 Forbidden	Acceso denegado	La solicitud no está autorizada para validar la entidad.
500 Server Error	Error del servidor	Se produjo un error inesperado al procesar la validación.

Buenas Prácticas

** Validación previa: verifica que qr_code_data no esté vacía y cumpla con el formato esperado antes de llamar al endpoint. **

Última actualización el