Skip to main content
Render a scannable QR code for a payment’s hosted checkout page. The endpoint returns a PNG image encoding https://flarehq.xyz/checkout/{reference} — the exact checkout URL built from NEXT_PUBLIC_BASE_URL (falling back to https://flarehq.xyz), so the QR always points at the same domain as the copy-link text shown next to it. The reference is validated against the payment ledger before any QR is generated. This endpoint is public — no authentication is required — and can be dropped straight into an <img> tag.

​
Endpoint

​
Request

​
Headers

​
Query Parameters

​
string
required
The payment reference (e.g. arc_ref_k7x2m9lp4d8f1q2z) that must already exist in the payment ledger. Unknown references are rejected with HTTP 404.

​
Response

A successful request returns a PNG image (Content-Type: image/png), 400×400 px with a 2-unit margin, dark #0f172a modules on a white background, and a public cache lifetime of 1 hour. The QR encodes: https://flarehq.xyz/checkout/{reference}

​
Examples

​
Success Response

​
Error Responses

​
Notes

The reference is validated against the payment ledger before a QR is generated, so arbitrary or typo’d references return HTTP 404 instead of a meaningless code.
Because the response is cached publicly for 1 hour, the endpoint is safe to render directly in <img> tags on your checkout or order pages — repeated views of the same reference hit the cache rather than regenerating the PNG.