Retrieve QR Code

Overview

This endpoint retrieves detailed information about a specific QR Code by its unique identifier. It provides metadata such as payment amount, merchant details, QR Code payload, image, and configuration attributes.

Endpoint Details

Definition	Description
Endpoint	https://api.paas.sandbox.co.passportfintech.com/v1/qrcodes/:qr_code_id
Method	GET
Headers	Content-Type: application/json, Authorization
Authentication	Access Token (Bearer Token)

Request Body

This endpoint does not require a request body.

Example Request

JSON
    
curl --location --request GET 'https://api.paas.sandbox.co.passportfintech.com/v1/qrcodes/ffd0d013-1fe9-4b36-bf3f-9d9850b5b63' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
Copy

Response

HTTP Status Code: 200 OK.

Example of Response

JSON
    
    
 
{
    "customer_id": "31eb66c3-f309-48ce-8b12-086f9e76b84c",
    "status": "ACTIVE",
    "key": {
        "key_type": "ID",
        "key_value": "36606864"
    },
    "type": "STATIC",
    "qr_code_data": "00020101021126310015CO.COM.VISI.LLA01083660686449270015CO.COM.VISI.RED0104VISI5204578253031705802CO5914Merchant CWSPZ6006Bogota61059827362120808PURCHASE80280017CO.COM.VISI.CANAL0103POS90310017CO.COM.VISI.TRXID010600000063045CB4",
    "acquirer_network_identifier": "VISI",
    "created_at": "2025-10-10T11:47:52.365840Z",
    "additional_info": {
        "transaction_purpose": "PURCHASE"
    },
    "key_id": "e7f75ffc-22b8-4cfe-884b-8ebcb008b680",
    "merchant": {
        "merchant_category_code": "0412",
        "merchant_country": "CO",
        "merchant_name": "Merchant CWSPZ",
        "merchant_city": "Medellin",
        "merchant_post_code": "101010"
    },
    "qr_code_image": "b'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'",
    "channel": "POS",
    "id": "ffd0d013-1fe9-4b36-bf3f-9d9850b5b638"
}
Copy

Common Errors and Handling

HTTP Status Code	Meaning	Description
400	Bad Request	Malformed `id` or invalid request
401	Unauthorized	Missing/expired bearer token, or token lacks `paas.core.qrcodes.get` scope
403	Forbidden	Caller not permitted to retrieve this QR Code
404	Not Found	QR Code with the given `id` does not exist
500	Server Error	Unexpected error; retry or contact support

Best Practices

Use qr_code_image (Base64) when embedding in mobile apps or web UIs; decode it into a PNG/JPEG for rendering.
Pair this with Cancel QR Code (DELETE /qrcodes/{id}) to revoke compromised or unused QR Codes.

Last updated on