Loyalty Program

Overview

The Reponse loyalty program lets contacts **earn points** on purchases and actions, **progress through tiers** for increasing benefits, and **refer friends** for bonus rewards. Points balances, tier status, and redemption history are fully accessible through the API and SDK.

Prerequisites

Step 1 — Enable the loyalty program

1. Open Dashboard → Loyalty → Settings.
2. Toggle Enable Loyalty Program.
3. Set the program name (e.g. "Rewards Club") and point currency name (e.g. "Stars").

Step 2 — Configure earn rules

Earn rules define how contacts accumulate points:

Configure earn rules in **Dashboard → Loyalty → Earn Rules**, or via the API:

await reponse.loyalty.createEarnRule({
  body: {
    type: 'purchase',
    pointsPerUnit: 1,
    currency: 'EUR',
    description: '1 Star per €1 spent',
  },
});

Step 3 — Set up tiers

Tiers reward your most loyal customers with escalating benefits:

Configure tiers in **Dashboard → Loyalty → Tiers**. Each tier specifies:

• Threshold — minimum lifetime points to qualify
• Earn multiplier — multiplied against the base earn rate
• Benefits — free-text description shown to the contact

Step 4 — Redemption

Contacts redeem points for discounts at checkout:

// Check balance
const { data: balance } = await reponse.loyalty.getBalance({
  path: { contactId: 'ctc_xxx' },
});
// balance → { available: 1250, lifetime: 3400, tier: "Gold" }

// Redeem points for a discount
const { data: redemption } = await reponse.loyalty.redeem({
  path: { contactId: 'ctc_xxx' },
  body: {
    points: 500,
    reason: 'checkout',
    orderId: 'ord_xxx',
  },
});
// redemption → { discountAmount: 5.00, currency: "EUR", remainingPoints: 750 }

Redemption rules

Step 5 — Referral program

Drive growth by letting contacts refer friends:

1. Enable referrals in Dashboard → Loyalty → Referral.
2. Each contact gets a unique referral code.
3. When a referred friend makes their first purchase, both parties earn bonus points.

// Get referral code for a contact
const { data: referral } = await reponse.loyalty.getReferral({
  path: { contactId: 'ctc_xxx' },
});
// referral → { code: "FRIEND-ABC12", referralUrl: "https://..." }

API reference

Troubleshooting