Integrate with POS

Learn how to integrate a POS system with the Loyalty Engine to enable points earning, voucher redemptions, and seamless loyalty interactions at checkout.

Introduction

This guide outlines the recommended implementation for integrating a POS system with the Loyalty Engine, covering multiple use cases including user lookup, earning and spending points, and voucher validation.

Articles in this guide

These articles explain how to connect your POS system with the loyalty platform to handle transactions, offers, vouchers, discounts, and point redemptions.

Article	Summary
Reporting transactions	How to report completed sales to the Loyalty Engine.
Applying offers	How to identify and apply active Offers linked to a member’s account when their loyalty ID is scanned.
Redeeming vouchers	How to validate and redeem Vouchers issued by the Loyalty Engine at POS.
Redeeming points	How to let members spend loyalty points for discounts or rewards at POS.
Processing discount objects	How to interpret and apply the discounts object returned in offer or voucher responses.

Key Loyalty Engine concepts to review

Before proceeding, we recommend reviewing key Loyalty Engine concepts in our Product Docs to understand the platform architecture:

• Introduction

• Events

• Reactors

• Rewards

---

Relevant API Endpoints

The following API endpoints are referenced in this guide. Take some time to familiarise yourself with each.

Function	API	API endpoint
Submit an order For reporting a transaction	Receipts	POST /orders
Report an event For reporting a transaction or spending points	Rewards	POST /events
Retrieve a specific user For looking up a user and their authIdentifier	Rewards	GET /users/{id}
Retrieve a user’s wallet For retrieving a user's points balance and the voucher's in their wallet	Rewards	GET /users/{id}/wallet
Retrieve a user's offers For retrieving a list of offers a user is eligible for.	Rewards	GET /rewards
Redeem a benefit For redeeming a voucher	Rewards	POST /commands/redeem_benefi
Validate a voucher code For verifying or burning a voucher code	Rewards	POST /commands/validate_voucher