Customer Points
Loyalty points system and point balance management.
Updated
On this page
Overview
DashForDevs includes a built-in loyalty points system. Customers earn points on purchases and can redeem them for discounts in the discount store.
Reading Points
import dash from "@/lib/dash"
const { customer } = await dash.auth.getProfile()
console.log(customer.loyalty_points) // 250
console.log(customer.loyalty_balance) // "$12.50"
console.log(customer.tier) // "gold"
console.log(customer.tier_name) // "Gold Member"
Earning Points
Points are earned automatically through:
- Purchases — Points per dollar spent (configured in dashboard)
- Social tasks — Follow on Instagram, share products, etc. See Earn Points
- Referrals — Points for referring new customers. See Referrals
Social Earn Tasks
// List available earn tasks
const { completed_tasks } = await dash.earnPoints.list()
// Complete a task
const { success, points_awarded, points_remaining } = await dash.earnPoints.complete("task_instagram_follow")
Redeeming Points
Customers redeem points in the discount store:
// List discount store products
const { products, customer_points } = await dash.discountStore.list()
// Redeem a product for a discount code
const { success, discount_code, points_remaining } = await dash.discountStore.redeem("product_id")
Points Display Example
export function LoyaltyBanner({ customer }) {
return (
<div className="bg-gradient-to-r from-yellow-600 to-amber-600 p-4 rounded">
<p className="font-bold">{customer.tier_name}</p>
<p>{customer.loyalty_points} points ({customer.loyalty_balance} value)</p>
<a href="/rewards">Redeem Points →</a>
</div>
)
}
Tiers
Loyalty tiers are configured in the dashboard. As customers accumulate points, they automatically advance through tiers which can unlock benefits like better earn rates or exclusive discounts.
Next Steps
- Customer Addresses — Managing addresses
- Discount Codes — Discount store and codes
- Tracking Referrals — Referral points