> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qtap.qa/llms.txt
> Use this file to discover all available pages before exploring further.

# Generating QR Codes

> How to create a new QR code that stamps a card, awards points, or redeems a reward.

Each QR code you generate encodes a unique link. When a customer scans it, Qtap runs the action you configured — issuing a stamp, adding points, or processing a redemption.

## Creating a QR Code

Go to **QR Codes** in the sidebar and click **Generate QR Code**.

<Frame caption="The QR Codes page lists every code with its type, action, and scan count. Generate QR Code opens the builder.">
  <img src="https://mintcdn.com/qtap/CgxDdxdXtxUVA3mD/images/merchants/qr-codes/01-qr-codes-list.png?fit=max&auto=format&n=CgxDdxdXtxUVA3mD&q=85&s=cf0b0c8fccdd62ac107f7265c5e0d501" alt="QR Codes list page with the Generate QR Code button highlighted" width="1440" height="900" data-path="images/merchants/qr-codes/01-qr-codes-list.png" />
</Frame>

<Steps>
  <Step title="Give it a name">
    Enter a name in the **Name** field. This is for your reference only — customers do not see it. Use something like "Counter — Stamp Card A" so you can tell codes apart.
  </Step>

  <Step title="Choose the type">
    Select the **Type**:

    * **Reusable** — the same QR code can be scanned any number of times (or up to a limit you set)
    * **Batch** — generates multiple single-use QR codes at once, each with a unique code
  </Step>

  <Step title="Set the action">
    Select what scanning this QR code should do:

    * **Stamp** — issues a stamp on a specific stamp card. You must also select which stamp card from the dropdown that appears.
    * **Points** — awards a set number of points to a points program. You must select the program and enter the points value.
    * **Redeem** — lets a customer redeem a reward they have already earned.
  </Step>

  <Step title="Assign a location (optional)">
    If you want this QR code to work only at a specific location, select it from the **Location** dropdown. Leave it set to **All locations** if the code should work anywhere.
  </Step>

  <Step title="Set limits (optional)">
    Toggle on **Max scans** if you want to cap how many times a reusable code can be scanned. Enter a number in the field that appears.

    Toggle on **Expiry date** and enter a date if the code should stop working after a certain point.
  </Step>

  <Step title="Customize the appearance (optional)">
    Change the **QR color** and **Background color** fields to match your branding. A preview updates immediately on screen.
  </Step>

  <Step title="Save it">
    Click **Save QR Code**. The code is added to your QR Codes list and is ready to use.
  </Step>
</Steps>

<Frame caption="Give the code a name, then choose how it can be scanned. The preview on the right updates as you go.">
  <img src="https://mintcdn.com/qtap/CgxDdxdXtxUVA3mD/images/merchants/qr-codes/02-generate-form.png?fit=max&auto=format&n=CgxDdxdXtxUVA3mD&q=85&s=ac11203c8947e65bf029eb88b87fd5e4" alt="Generate QR Code form showing the Name field and the QR code type options" width="1440" height="900" data-path="images/merchants/qr-codes/02-generate-form.png" />
</Frame>

<Frame caption="Pick what a scan should do. Award Points reveals the program and points-value fields shown here.">
  <img src="https://mintcdn.com/qtap/CgxDdxdXtxUVA3mD/images/merchants/qr-codes/03-action-points.png?fit=max&auto=format&n=CgxDdxdXtxUVA3mD&q=85&s=101722e58846e2aa8f8e3cf08e1d8309" alt="QR code action options with Award Points selected" width="1440" height="900" data-path="images/merchants/qr-codes/03-action-points.png" />
</Frame>

<Frame caption="Advanced settings let you cap scans and set an expiry date, and the customization section recolors the code.">
  <img src="https://mintcdn.com/qtap/CgxDdxdXtxUVA3mD/images/merchants/qr-codes/04-appearance.png?fit=max&auto=format&n=CgxDdxdXtxUVA3mD&q=85&s=f9af047ef9e337976b5f620c1ee770a0" alt="Advanced settings and customization section with QR color and background color fields" width="1440" height="900" data-path="images/merchants/qr-codes/04-appearance.png" />
</Frame>

## Downloading Your QR Code

After saving, find the code in your QR Codes list. Click the menu icon on the row and select **Download** to get a PNG file you can print or display on a screen.

<Frame caption="Each row's menu has Download, plus View Details, which opens a page with PNG and SVG export.">
  <img src="https://mintcdn.com/qtap/CgxDdxdXtxUVA3mD/images/merchants/qr-codes/05-download-menu.png?fit=max&auto=format&n=CgxDdxdXtxUVA3mD&q=85&s=57e912842834efaad2da7a860aa19ed4" alt="QR code row menu showing the Download option" width="1440" height="900" data-path="images/merchants/qr-codes/05-download-menu.png" />
</Frame>

<Note>
  You can also view your QR codes in gallery mode by clicking the grid icon near the top right of the QR Codes page. This makes it easier to visually distinguish codes at a glance.
</Note>

## Batch QR Codes

If you selected **Batch** as the type, enter the number of codes to generate in the **Quantity** field before saving. Qtap creates that many unique codes with the same action and settings. Download them all at once as a ZIP file or PDF from the QR Codes list.

<Warning>
  Batch codes are single-use — each code can only be scanned once. If you need codes that work multiple times, use the Reusable type with a max scans limit instead.
</Warning>

<CardGroup cols={2}>
  <Card title="QR Codes Overview" href="/merchants/qr-codes/overview">
    How QR codes work in the Qtap system
  </Card>

  <Card title="Batch QR Codes" href="/merchants/qr-codes/batch">
    Generating and managing large sets of single-use codes
  </Card>
</CardGroup>
