Loyalty Integration
Redeem loyalty points for a reward
Allows a customer to redeem their loyalty points for a specific reward option. This deducts points from their balance and generates a discount code or applies the reward.
Full behavior, validation rules, and side effects
What happens:
- Validates customer has enough points
- Deducts points from customer’s balance
- Generates discount code (for discount rewards)
- Records redemption in customer’s history
- Returns discount code or confirmation
Reward Types:
- Discount codes: Generates unique code customer can use at checkout
- Auto-apply discounts: Automatically applied to next order
- Free products: Adds free product to next order
- Free shipping: Waives shipping on next order
Important Notes:
- Points are deducted immediately and cannot be refunded
- Discount codes typically expire after 30 days
- Some rewards have minimum purchase requirements
- Rewards cannot be combined with other discounts (depends on configuration)
Use Cases:
- Customer clicks ‘Redeem’ button in customer portal
- Apply points at checkout
- Redeem points for subscription discount
Authentication: Customer must be logged in via Shopify customer session
POST
Redeem loyalty points for a reward
Documentation Index
Fetch the complete documentation index at: https://appstleinc-aeca3e0a.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.