Consultar Código QR

Visión General

Este endpoint permite crear un Cliente (Customer) dentro de la API de Passport proporcionando los datos de identificación necesarios. Una solicitud exitosa retorna el ID del cliente y la información de confirmación del recurso creado.

Detalles del Endpoint

Parámetro	Descripción
Endpoint	https://bre-b-sandbox.api.visionamos.passportfintech.com/v1/paas/entities/customers/qrcodes/{qr_code_id}
Método	GET
Encabezados	Content-Type: application/json, Authorization
Autenticación	Token de Acceso (Bearer Token)

Cuerpo de la Solicitud

Este endpoint no requiere cuerpo de solicitud (Response Body).

Ejemplo de Solicitud

JSON
    
curl --location 'https://bre-b-sandbox.api.visionamos.passportfintech.com/v1/paas/entities/customers/qrcodes/33585352-971b-41cd-a3c8-4a587c8a2a5c' \
--header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>'
Copy

Cuerpo de la Respuesta

Código HTTP: 200 OK

Ejemplo de Respuesta

JSON
    
    
 
{
    "amount": {
        "value": "100000",
        "currency": "COP"
    },
    "additional_info": {
        "transaction_purpose": "PURCHASE",
        "merchant_name": "Merchant VVMDQ"
    },
    "qr_code_data": "00020101021126410015CO.COM.VISI.LLA0318Daron3@hotmail.com49270015CO.COM.VISI.RED0104VISI5204578253031705802CO5914Merchant VVMDQ6006Bogota61059827362120808PURCHASE80280017CO.COM.VISI.CANAL0103POS90310017CO.COM.VISI.TRXID01060000006304931A",
    "qr_code_image": "b'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'",
    "id": "438b69a4-f5c5-4a3f-beac-5a5fc635bedc",
    "merchant": {
        "merchant_category_code": "1234",
        "country": "CO",
        "merchant_name": "Merchant VVMDQ",
        "merchant_city": "Bogota",
        "merchant_zip_code": "98273"
    },
    "created_at": "2025-09-10T21:57:05.493966Z",
    "status": "ACTIVE",
    "type": "STATIC",
    "account_key_id": "088bf1bb-1fee-4ff8-9031-4cce4e3e392c",
    "entity_customer_id": "7cb9de1b-d4b4-4036-9b7d-a49104a8f7f9",
    "key": {
        "key_value": "Daron3@hotmail.com",
        "key_type": "E"
    },
    "acquirer_network_identifier": "VISI",
    "channel": "POS"
}
Copy

Errores Comunes y Manejo

Código HTTP	Significado	Descripción
400	Bad Request	`qr_code_id` malformado o solicitud inválida.
401	Unauthorized	Token Bearer ausente, expirado o sin alcance `paas.core.qrcodes.get`.
403	Forbidden	El solicitante no tiene permisos para obtener este Código QR.
404	Not Found	El Código QR con el `id` proporcionado no existe.
500	Server Error	Error inesperado en el servidor; reintente o contacte soporte.

Buenas Prácticas

Utiliza qr_code_image (Base64) para integrarlo en apps móviles o interfaces web; decodifícalo a PNG/JPEG para su visualización.
Combina este endpoint con Cancelar Código QR (DELETE /qrcodes/{id}) para revocar códigos comprometidos o que ya no se utilicen.
Registra el campo created_at y el id para fines de auditoría y conciliación de transacciones.
Restringe el acceso a esta información, ya que puede incluir datos sensibles de clientes y comercios.

Última actualización el