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)

Parámetros de Consulta

Parámetros de Paginación

Parámetro	Descripción
page_params.page_size	Cantidad de registros a retornar por página.
page_params.page_number	Número de página a consultar.
page_params.first_request_timestamp.seconds	Segundos UTC desde Unix epoch (`1970-01-01T00:00:00Z`). Debe estar en el rango de `0001-01-01T00:00:00Z` a `9999-12-31T23:59:59Z` (inclusive).
page_params.first_request_timestamp.nanos	Fracción en nanosegundos (0 a 999,999,999). Debe ser un valor no negativo y representa la fracción de segundo con resolución de nanosegundos.

Parámetros de Ordenamiento

Parámetro	Descripción
order_params.order_key	Campo utilizado para ordenar los resultados (por ejemplo, por fecha de creación o actualización, según los valores soportados por el backend).
order_params.order_direction	Dirección del ordenamiento. Valores permitidos: `ORDER_DIRECTION_ENUM_UNSPECIFIED`, `ASC`, `DESC`.

Filtros de Códigos QR

Parámetro	Descripción
qr_code_id	Filtra por el identificador único del código QR.
customer_id	Filtra por el identificador del cliente asociado al código QR.
key_id	Filtra por el identificador de la llave asociada al código QR.
type	Filtra por el tipo de código QR (por ejemplo, según el tipo soportado por la integración).
key_value	Filtra por el valor de la llave asociada al código QR.
key_type	Filtra por el tipo de llave asociada al código QR.

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