Odoo 19 Loyalty Programs:
Points, Gift Cards & Coupons for E-commerce and POS

Loyalty Programs Are No Longer a Retail Luxury—They're a Revenue Engine

Every e-commerce store and point-of-sale terminal competes for repeat purchases. Acquiring a new customer costs 5–7x more than retaining an existing one, yet most Odoo implementations leave the Loyalty module untouched. The default installation ships with the feature disabled, buried under the Sales → Configuration menu where it quietly waits for someone to flip the switch.

The business impact of not using it is measurable. Stores without loyalty programs see lower average order values, higher churn rates, and zero insight into which customers are one purchase away from becoming high-value accounts. Meanwhile, competitors hand out points, gift cards, and coupons that create switching costs and emotional attachment.

Odoo 19's loyalty engine is surprisingly powerful—it supports four distinct program types, flexible reward structures, conditional triggers, and native integration with both the Website and POS apps. This guide covers everything: how each program type works, how to configure rewards and trigger rules, how loyalty surfaces in e-commerce and POS, how to track performance, and the mistakes that silently break programs in production.

The Four Loyalty Program Types in Odoo 19

Odoo 19 organizes loyalty under four distinct program types. Each serves a different commercial purpose, and choosing the wrong type for your use case creates configuration headaches later. Here's what each one does and when to use it.

Enabling the Loyalty Module

The loyalty engine lives in the loyalty module, which is auto-installed when you enable loyalty features via Sales → Configuration → Settings → Pricing. For e-commerce, also ensure website_sale_loyalty is installed. For POS, you need pos_loyalty.

# In the Odoo shell, verify which loyalty modules are installed
env['ir.module.module'].search([
    ('name', 'like', '%loyalty%'),
    ('state', '=', 'installed'),
]).mapped('name')

# Expected output for full coverage:
# ['loyalty', 'website_sale_loyalty', 'pos_loyalty']

Creating a Loyalty Program via Code

While most users configure programs through the UI, understanding the model structure helps when automating program creation or debugging issues:

program = env['loyalty.program'].create({
    'name': 'VIP Rewards Club',
    'program_type': 'loyalty',
    'applies_on': 'both',          # 'current' | 'future' | 'both'
    'trigger': 'auto',             # 'auto' | 'with_code'
    'portal_visible': True,
    'rule_ids': [(0, 0, {
        'reward_point_mode': 'money',   # earn points per $ spent
        'reward_point_amount': 1.0,     # 1 point per $1
        'minimum_amount': 25.00,        # min order to earn
    })],
    'reward_ids': [(0, 0, {
        'reward_type': 'discount',
        'discount': 10.0,              # 10% off
        'discount_mode': 'percent',
        'discount_applicability': 'order',
        'required_points': 100,        # costs 100 points
    })],
})

E-commerce Integration: How Loyalty Programs Appear on Your Odoo Website

Installing website_sale_loyalty connects the loyalty engine to the shopping cart, checkout flow, and customer portal. But "installed" doesn't mean "visible"—several configuration steps determine what your customers actually see.

Cart-Level Coupon and Promo Code Entry

When a Coupon or Promotion program has trigger = 'with_code', a promo code input field appears on the cart page. Customers enter their code, the system validates it against the program's rules, and if valid, the reward is applied as a negative line on the order.

<!-- The promo code input is injected by website_sale_loyalty
     into the cart template via this xpath: -->
<template id="reduction_code_form"
          inherit_id="website_sale.cart">
  <xpath expr="//div[@id='cart_total']" position="before">
    <div class="o_reward_code_form mt-3">
      <form method="post"
            action="/shop/cart/coupon">
        <input type="hidden" name="csrf_token"
               t-att-value="request.csrf_token()"/>
        <div class="input-group">
          <input type="text" name="promo"
                 class="form-control"
                 placeholder="Enter promo code"/>
          <button type="submit"
                  class="btn btn-secondary">
            Apply
          </button>
        </div>
      </form>
    </div>
  </xpath>
</template>

Loyalty Points Display in Customer Portal

When portal_visible = True on a loyalty program, customers can see their points balance in the portal under My Account → Loyalty Cards. This is critical for engagement—customers can't redeem points they don't know they have.

# Find all loyalty cards for a specific customer
cards = env['loyalty.card'].search([
    ('partner_id', '=', customer.id),
    ('program_id.program_type', '=', 'loyalty'),
])

for card in cards:
    print(f"Program: {{card.program_id.name}}")
    print(f"  Points: {{card.points}}")
    print(f"  Code:   {{card.code}}")

Gift Card Purchase Flow

Gift cards are sold as regular products on the website. The key is linking the product to the gift card program:

# The gift card product must be a service with specific settings
gift_product = env['product.product'].create({
    'name': '$50 Gift Card',
    'type': 'service',
    'list_price': 50.00,
    'sale_ok': True,
    'purchase_ok': False,
    'taxes_id': [(5, 0, 0)],  # Gift cards are typically tax-exempt
})

# Link it to the gift card program
gift_program = env['loyalty.program'].create({
    'name': 'Gift Cards',
    'program_type': 'gift_card',
    'trigger': 'with_code',
    'applies_on': 'future',
    'rule_ids': [(0, 0, {
        'reward_point_mode': 'money',
        'reward_point_amount': 1,
        'product_ids': [(6, 0, [gift_product.id])],
    })],
    'reward_ids': [(0, 0, {
        'reward_type': 'discount',
        'discount_mode': 'per_point',
        'discount': 1.0,           # $1 discount per point
        'discount_applicability': 'order',
        'required_points': 1,
    })],
})

Loyalty Program Reporting and Analytics

Running a loyalty program without tracking its performance is like running ads without conversion metrics. Odoo 19 provides several reporting angles, but you need to know where to look—and what to build yourself.

Built-in Reports

Custom Analytics: Measuring Program ROI

The built-in reports show operational data but not business intelligence. Here's a SQL query pattern for measuring the actual ROI of your loyalty program:

-- Compare average order value: loyalty members vs. non-members
WITH loyalty_customers AS (
    SELECT DISTINCT partner_id
    FROM loyalty_card
    WHERE program_id IN (
        SELECT id FROM loyalty_program
        WHERE program_type = 'loyalty'
    )
    AND points > 0
)
SELECT
    CASE
        WHEN lc.partner_id IS NOT NULL THEN 'Loyalty Member'
        ELSE 'Non-Member'
    END AS segment,
    COUNT(DISTINCT so.id) AS total_orders,
    ROUND(AVG(so.amount_total), 2) AS avg_order_value,
    ROUND(SUM(so.amount_total), 2) AS total_revenue,
    COUNT(DISTINCT so.partner_id) AS unique_customers
FROM sale_order so
LEFT JOIN loyalty_customers lc
    ON so.partner_id = lc.partner_id
WHERE so.state IN ('sale', 'done')
    AND so.date_order >= NOW() - INTERVAL '90 days'
GROUP BY
    CASE
        WHEN lc.partner_id IS NOT NULL THEN 'Loyalty Member'
        ELSE 'Non-Member'
    END;

Tracking Outstanding Liability

Gift cards and unredeemed loyalty points represent a financial liability. For accounting compliance, you should track the total outstanding value:

# Total unredeemed gift card value
gift_cards = env['loyalty.card'].search([
    ('program_id.program_type', '=', 'gift_card'),
    ('points', '>', 0),
])

total_liability = sum(card.points for card in gift_cards)
print(f"Outstanding gift card liability: ${{total_liability:,.2f}}")

3 Loyalty Program Mistakes That Silently Cost You Revenue

Optimization Metadata