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
2
2
curl --location --request GET 'https://api.paas.sandbox.co.passportfintech.com/v1/qrcodes' \--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \Cuerpo de la Respuesta
- Código HTTP: 200 OK
Ejemplo de Respuesta
88
88
{ "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" } ]}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_infopara iterar entre múltiples páginas cuando existan muchos C��digos QR. - Apóyate en el campo type (
STATICvsDYNAMIC) para determinar los casos de uso (POS,MPOS, recaudo con factura). - Registra los valores de
created_ateidpara conciliación con los logs de transacciones. - Controla el acceso a esta información ya que contiene datos sensibles de clientes y comercios.