POST /members/{id}/earn command bearer
Awards loyalty points to a member account based on a completed purchase, applying the active earn-rate rules.
ID earn-points-api
Method POST
Path /members/{id}/earn
Classification command
Domain loyalty
Capability loyalty
Service issue-points
Application loyalty-platform — Loyalty Platform
Auth bearer
Business Object order
Description Confirmed commercial commitment created from checkout or assisted selling.
Classification aggregate-root
Lifecycle draft → confirmed → in-fulfilment → partially-fulfilled → completed → return-in-progress → cancelled
Business Object loyalty-account
Description Account used to track loyalty participation state, balances, benefits, and point activity.
Event
Classification
Object
Description
loyalty-points-earnedupdatedloyalty-accountLoyalty points were awarded to a member account following a completed purchase, updating the balance.
Pattern
Flow
Style
Description
POS → Loyalty Platform Earn/Redeem pos → loyalty-platformsynchronous-apiAt transaction close, the POS triggers loyalty point accrual and handles redemption requests. Both operations are synchronous for immediate receipt display.
loyalty
Scenario
Description
Clienteling SaleA store associate uses a clienteling application to identify a known customer, review their purchase
Customer RegistrationA new customer creates a unified identity that can be recognised consistently across digital and phy
Loyalty EnrollmentA customer is enrolled into the retailer's loyalty programme during or after a transaction — in-stor
Loyalty Tier UpgradeA customer's loyalty standing is reviewed after new qualifying activity and may be promoted to a hig
Scan and GoCustomer scans items using a mobile app while shopping, receives promotions and loyalty benefits in
loyalty domain