> For the complete documentation index, see [llms.txt](https://docs.omnichat.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.omnichat.ai/en/features/loyalty-engine/qr-code-loyalty-points-add-on-module.md).

# QR code loyalty points (Add-on Module)

Brands can now use the QR Code loyalty point collection mechanism to generate one-time loyalty point redemption links, convert them into QR codes, and distribute them at retail stores or event venues.

{% hint style="info" %}
If you are interested in using these features, please contact your **account consultant or online customer support** for further assistance.
{% endhint %}

#### **Key Highlights**

* **Loyalty point collection via QR code**: Supports WhatsApp and LINE. Customers scan the QR code to receive points.
* **Unique point codes**: Each point link can only be redeemed once, preventing duplicate use.
* **Flexible campaign setup**: You can set redemption limits per person and auto-apply tags to customers who successfully collect points.
* **No POS system required**: Ideal for global brands—bypass time-consuming POS integration and quickly launching point collection campaigns.

#### **Use Cases**

* **In-store campaigns**: Scan on-site to collect points instantly—turn one-time purchases into long-term engagement.
* **With shipments**: Include QR codes in shipped packages to allow customers across channels to join the campaign, boosting repurchase and loyalty.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2Fddvw3tjFeHmzxgvzENXD%2F%E6%88%AA%E5%9C%96%202026-09-13%20%E4%B8%8B%E5%8D%882.04.53.png?alt=media&amp;token=e31b0f77-1e23-4c96-8640-c4d399a51937" alt=""><figcaption></figcaption></figure>

1. Search: Search for campaigns by name.
2. New Campaign
3. Campaign Name
4. Campaign Dates
5. Creation Date
6. Loyalty Points Per Set: The number of points a customer receives each time they scan the QR Code.
7. Claimed Sets / Total Sets
8. Status & Action: Available actions vary depending on the campaign status, as shown in the table below.

<table><thead><tr><th width="105.08984375">Status</th><th>Available Actions</th></tr></thead><tbody><tr><td>Draft</td><td>Edit, Copy, Duplicate, Delete</td></tr><tr><td>Scheduled</td><td>Edit, Copy, Download Loyalty Points Link, Pause</td></tr><tr><td>Active</td><td>Edit, Copy, Claim Records, Download Loyalty Points Link, Pause</td></tr><tr><td>Paused</td><td>Edit, Copy, Claim Records, Download Loyalty Points Link</td></tr><tr><td>Ended</td><td>Edit, Duplicate, Claim Records, Download Loyalty Points Link, DeleteCopy</td></tr></tbody></table>

### Create a QR Code Loyalty Point Campaign

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FpyaYiFjvWyFv1LZ49EDs%2F%E6%88%AA%E5%9C%96%202026-09-13%20%E4%B8%8B%E5%8D%882.19.17.png?alt=media&amp;token=3c61ba03-6adc-4c42-9317-a3431e556a3f" alt=""><figcaption></figcaption></figure>

1. **Campaign Name**
2. **Campaign Time**: The period during which customers can scan the QR Code to receive points.
3. **Loyalty Point Collection Channel**: Currently supports **LINE and WhatsApp** only.
4. **Points**:&#x20;
   * **Loyalty Points Per Set** is the number of points a customer receives each time they scan the QR Code.&#x20;
   * **Total** is the total number of point codes to be distributed in the campaign.
5. **Loyalty Point Distribution Success Message**: Click the **「{...}」** button in the bottom-right corner to add the **Loyalty Points Value** parameter.\
   ![](https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FUOz5yUL9I3hL6oPoIdX7%2F%E6%88%AA%E5%9C%96%202026-09-13%20%E4%B8%8B%E5%8D%882.27.32.png?alt=media\&token=47f2dfc6-fd00-4df7-911f-a07aa1e39cb8)
6. **Already Claimed Message**: The message displayed when a customer has already redeemed the points.
7. **Customer Claim Limit**: Set how many times each customer can redeem points.
8. **Campaign Paused Message**: The message displayed when the campaign is paused.
9. **Out-of-Campaign Timeframe Message**: The message displayed when customers scan the QR Code outside the campaign period.
10. **Customer Tagging**: Add tags to customers who successfully redeem points.
11. **Save**: Click **Save** to keep the campaign in **Draft** or **Paused** status.
12. **Publish**: Click **Publish** to set the campaign status to **Scheduled**, **Active**, or **Ended**, based on the configured campaign period.

### Claim Records

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FsoWPRjTDoMqEp3gcLQty%2F%E6%88%AA%E5%9C%96%202026-09-13%20%E4%B8%8B%E5%8D%882.36.14.png?alt=media&amp;token=99d20435-4517-45be-9ce7-cd5a47cc47a6" alt=""><figcaption></figcaption></figure>

1. Campaign Name & Channel
2. Filter by Redemption Status: Filter records by All status, Claimed, Assigned, or Unclaimed.
3. Search by Field: Search by Recipient Name, Redemption Code, Channel Contacts ID, or Bound Phone Number.
4. Redeem Random Code: Enter the last six digits of the code entered by the customer after scanning the QR Code.
5. Redemption Status: Includes All status, Claimed, Assigned, or Unclaimed.
   * Unclaimed: The point code has not yet been claimed by a customer.
   * Claimed: The point code has been claimed by a customer but has not yet been linked to a customer account.
   * Assigned: Customers must complete **phone number binding** before their points can be linked to their account.
6. Recipient Name / Channel Contact ID
   * LINE: Name and LINE User ID
   * WhatsApp: Name, BSUID, and Phone Number
7. Redemption Time: The time when the customer scanned the QR Code.
8. Binding Time: The time when the points were linked to the customer account.
9. Bound Phone Number
10. Export List: Export a CSV file containing all fields displayed on the page.

{% hint style="info" %}
**Please note:**\
Only records with the **Assigned** status are included in **Points History** statistics. Customers can also redeem their points only after the points have been completed **phone number binding**.
{% endhint %}

### Download Loyalty Point Links

Once the campaign is published, click **Download Loyalty Point Links** to export the file. Customers can then click the links or scan the QR Codes to receive the designated points through the specified channel.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FO4zglEW90dNhOEdMZoHv%2F%E6%88%AA%E5%9C%96%202026-09-13%20%E4%B8%8B%E5%8D%883.23.07.png?alt=media&amp;token=7ae1473a-b794-4bf3-95bc-e9f8977bdd9b" alt=""><figcaption></figcaption></figure>