Listar Códigos 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://api.paas.sandbox.co.passportfintech.com/v1/qrcodes
Método	GET
Encabezados	Content-Type: application/json, Authorization
Autenticación	Token de Acceso (Bearer Token)

Cuerpo de la Solicitud

No requiere cuerpo de solicitud.

Ejemplo de Solicitud

JSON
    
 
curl --location --request GET 'https://api.paas.sandbox.co.passportfintech.com/v1/qrcodes' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
Copy

Cuerpo de la Respuesta

Código HTTP: 200 OK

Ejemplo de Respuesta

JSON
    
 
{
  "pagination_info": {
    "total_pages": 1,
    "total_elements": 2,
    "first_request_timestamp": "2025-09-10T21:57:12.844Z",
    "current_page": 1
  },
  "qr_codes": [
    {
      "amount": {
        "currency": "COP",
        "value": "100000"
      },
      "additional_info": {
        "transaction_purpose": "COLLECTION",
        "merchant_name": "Merchant VVMDQ",
        "invoice_number": "123",
        "mobile_phone_number": "3503503456",
        "store_label": "sasc0193",
        "loyalty_label": "1234",
        "reference_label": "pago impuesto",
        "channel_presentation": "400",
        "customer_info": "EMAIL",
        "terminal_label": "01",
        "customer_label": "0001"
      },
      "qr_code_data": "0002010102122641...6304D0DF",
      "acquirer_network_identifier": "VISI",
      "merchant": {
        "country": "CO",
        "merchant_name": "Merchant VVMDQ",
        "merchant_city": "Bogota",
        "merchant_zip_code": "98273",
        "merchant_category_code": "1234"
      },
      "inc": {
        "inc_type": "FIXED",
        "inc_value": "10.00"
      },
      "key": {
        "key_type": "E",
        "key_value": "Daron3@hotmail.com"
      },
      "vat": {
        "vat_type": "FIXED",
        "vat_value": "100.00",
        "vat_base_value": "100.00"
      },
      "account_key_id": "088bf1bb-1fee-4ff8-9031-4cce4e3e392c",
      "entity_customer_id": "7cb9de1b-d4b4-4036-9b7d-a49104a8f7f9",
      "channel": "MPOS",
      "created_at": "2025-09-10T21:57:01.240743Z",
      "type": "DYNAMIC",
      "status": "ACTIVE",
      "id": "882b8f77-55de-4fd7-939c-eb99e57f1e96"
    },
    {
      "amount": {
        "currency": "COP",
        "value": "100000"
      },
      "additional_info": {
        "transaction_purpose": "PURCHASE",
        "merchant_name": "Merchant VVMDQ"
      },
      "qr_code_data": "0002010102112641...04931A",
      "acquirer_network_identifier": "VISI",
      "merchant": {
        "country": "CO",
        "merchant_name": "Merchant VVMDQ",
        "merchant_city": "Bogota",
        "merchant_zip_code": "98273",
        "merchant_category_code": "1234"
      },
      "key": {
        "key_type": "E",
        "key_value": "Daron3@hotmail.com"
      },
      "account_key_id": "088bf1bb-1fee-4ff8-9031-4cce4e3e392c",
      "entity_customer_id": "7cb9de1b-d4b4-4036-9b7d-a49104a8f7f9",
      "channel": "POS",
      "created_at": "2025-09-10T21:57:05.493966Z",
      "type": "STATIC",
      "status": "ACTIVE",
      "id": "438b69a4-f5c5-4a3f-beac-5a5fc635bedc"
    }
  ]
}
Copy

Errores Comunes y Manejo

Código HTTP	Significado	Descripción
400	Bad Request	Parámetros inválidos o solicitud malformada.
401	Unauthorized	Token Bearer ausente, expirado o sin el alcance `paas.core.qrcodes.list.get`.
403	Forbidden	El solicitante no tiene permisos para listar Códigos QR.
404	Not Found	No existen Códigos QR para la entidad.
500	Server Error	Error inesperado; reintente o contacte soporte.

Buenas Prácticas

Utiliza pagination_info para iterar entre múltiples páginas cuando existan muchos Códigos QR.
Apóyate en el campo type (STATIC vs DYNAMIC) para determinar los casos de uso (POS, MPOS, recaudo con factura).
Registra los valores de created_ate id para conciliación con los logs de transacciones.
Controla el acceso a esta información ya que contiene datos sensibles de clientes y comercios.

Última actualización el