Get Invoice QR Code

Retrieve the QR code for a specific invoice, including encrypted invoice data and base64-encoded QR image.

GET {{baseUrl}}/{{stage}}/external/businesses/{{businessId}}/invoices/{{invoiceIrn}}/qr

Request

Headers

Header	Value	Required
`Content-Type`	`application/json` or `/`	Yes
`Accept`	`application/json` or `/`	Yes
`X-Business-Key`	`businessKey`	Yes

Path Parameters

Parameter	Type	Required	Description
`businessId`	string (UUID)	Yes	Your business FIRS ID
`invoiceIrn`	string	Yes	Invoice Reference Number

Example: INV237-1070ECE8-20250826

Response

Success (200)

{
  "responseCode": "00",
  "responseMessage": "QR code retrieved successfully",
  "data": {
    "irn": "INV237-1070ECE8-20250826",
    "qrCodeBase64": "iVBORw0KGgoAAAANSUhEUgAAAQAAAAEA...",
    "encryptedDataBase64": "eyJpbnZvaWNlSWQiOiIxMjMi...",
    "timestamp": 1693046835000
  }
}

Field	Type	Description
`qrCodeBase64`	string	Base64-encoded PNG image of QR code
`encryptedDataBase64`	string	Encrypted invoice data (for verification)
`irn`	string	Invoice Reference Number (confirmation)
`timestamp`	number	Unix timestamp of generation

Errors

404 - Invoice Not Found

{
  "responseCode": "404",
  "responseMessage": "Invoice not found with IRN: INV999-INVALID"
}

→ Verify invoiceIrn exists and belongs to businessId

403 - QR Code Disabled

{
  "responseCode": "403",
  "responseMessage": "QR code generation disabled for this business"
}

→ Enable QR code feature in business settings or contact support

422 - Invoice Not Eligible

{
  "responseCode": "422",
  "responseMessage": "Invoice not eligible for QR code generation"
}

→ Invoice must be finalized and not cancelled

Example Request

Using the QR Code

Display in HTML

Display in JavaScript

Save to File (Node.js)

QR Code Contents

The QR code contains encrypted invoice data that can be scanned for verification:

Invoice Reference Number (IRN)

Invoice amount and currency

Supplier TIN

Issue date

Digital signature for authenticity

Decryption: Requires your business's QR code certificate (configured in business settings)

Prerequisites

✅ Business must have QR code generation enabled in settings
✅ QR code public key and certificate configured
✅ Invoice must be finalized (not draft or cancelled)

Enable QR Codes: POST /businesses/{businessId}/settings with qrCodePublicKey and qrCodeCertificate

Common Issues

QR code not generating
→ Check business settings have QR certificate configured

"Invoice not eligible"
→ Invoice must be in PENDING, PAID, or APPROVED status

QR code not displaying
→ Verify base64 string is complete and properly formatted

Security Notes

⚠️ QR codes contain encrypted invoice data
⚠️ Always use HTTPS to retrieve QR codes
⚠️ Validate business ownership before generating QR codes
⚠️ QR codes are generated on-demand (not cached)

Get Invoice QR Code

Request#

Headers#

Path Parameters#

Response#

Success (200)#

Errors#

Example Request#

Using the QR Code#

Display in HTML#

Display in JavaScript#

Save to File (Node.js)#

QR Code Contents#

Prerequisites#

Common Issues#

Security Notes#

Request

Responses

Request

Headers

Path Parameters

Response

Success (200)

Errors

Example Request

Using the QR Code

Display in HTML

Display in JavaScript

Save to File (Node.js)

QR Code Contents

Prerequisites

Common Issues

Security Notes