Loyalty and Promotional engine

The Loyalty and Promotional engine is the core of Loyal Guru. It lets companies build, stack, and execute any promotional logic across every customer touchpoint — in-store, online, or mobile — going beyond the technical limits of their POS or e-commerce checkout.

Rules are evaluated in real time at checkout: when a transaction arrives, the platform checks all active promotions against the cart and customer, applies qualifying effects, and returns the result in a single pass. No batch jobs, no delays.

The engine covers three sub-modules:

Sub-module	What it does
Discounts	Reduce prices at checkout — automatically for all customers or club members, or via a code delivered to a specific audience
Points & Wallet	Earn customers loyalty balance for qualifying purchases and events; burn balance as cashback at checkout or redeem in the rewards catalog
Rewards	Offer a catalog of physical, digital, or experiential prizes that customers exchange for earned balance outside the purchase flow

Use Cases

Use Case
→ Automatically apply a 10% member discount on all purchases for enrolled customers — no code required.
→ Run a 2x1 on a specific brand for customers who haven't bought in 60 days, delivered via a unique voucher.
→ Award 1 point per EUR on every purchase; Gold-tier customers earn 3x automatically.
→ Give a 500-point birthday bonus when an external scheduled process fires the birthday trigger.
→ Let customers redeem 500 points for a €5 discount at checkout in real time.
→ Offer a branded merchandise catalog — customers exchange points for products without buying anything.
→ Stack a member discount with a category multiplier on points in a single transaction.
→ Target inactive customers with a 15 EUR coupon and award 200 bonus points when they redeem it.
→ Run a co-funded CPG campaign: brand pays for the discount, Loyal Guru tracks partner ROI automatically.

How It Works

Loyalty and Promotional engine evaluates promotions at checkout in real time:

1. A transaction arrives at the Streaming API (POST /carts).
2. The engine fetches all active discounts, points campaigns, and rewards for the company.
3. Each promotion's conditions are evaluated against the cart and customer profile.
4. Qualifying promotions are applied — discounts reduce line values, points are accrued, cashback is applied if requested.
5. The response returns the adjusted cart and all loyalty effects in a single API call.

Promo Engine

Loyal Guru can act as the real-time promo engine for checkout. The cart API can first simulate a transaction, working like a promotion calculator before payment confirmation, and then apply the same logic when the cart is created.

Use the Promo Engine when the checkout needs one synchronous answer for discounts, points accrual, cashback burn, coupons, vouchers, stackability, and limits. See Promo Engine for the full flow and combined cart example.

Configuration

Each sub-module has its own section in the Owner App:

Sub-module	Owner App path
Discounts	Loyalty and Promotional engine → Discounts
Points & Wallet	Loyalty and Promotional engine → Points & Wallet
Rewards	Loyalty and Promotional engine → Rewards