Enroll Loyalty Member
POST /loyalty/members command bearer
Enrolls a Customer in the loyalty programme, creating a Loyalty Member and a zero-balance Loyalty Account.
Overview
|
|
| ID |
enroll-loyalty-api |
| Method |
POST |
| Path |
/loyalty/members |
| Classification |
command |
| Domain |
loyalty |
| Capability |
loyalty |
| Service |
enroll-member |
| Application |
crm — CRM |
| Auth |
bearer |
Request Body
|
|
| Business Object |
customer |
| Description |
Canonical party recognized by the enterprise as a customer. |
| Classification |
aggregate-root |
| Lifecycle |
anonymous → identified → registered → active → at-risk → churned → reactivated → blocked |
Response
|
|
| Business Object |
loyalty-member |
| Description |
A customer enrolled in a loyalty programme who accumulates and redeems points and benefits. |
| Lifecycle |
enrolled → active → tier-upgraded → tier-downgraded → lapsed → suspended → withdrawn |
Events Emitted
| Event |
Classification |
Object |
Description |
loyalty-member-enrolled |
created |
loyalty-member |
A new customer was enrolled in the loyalty programme. |
Scenarios using loyalty
| Scenario |
Description |
Clienteling Sale |
A store associate uses a clienteling application to identify a known customer, review their purchase |
Customer Registration |
A new customer creates a unified identity that can be recognised consistently across digital and phy |
Loyalty Enrollment |
A customer is enrolled into the retailer's loyalty programme during or after a transaction — in-stor |
Loyalty Tier Upgrade |
A customer's loyalty standing is reviewed after new qualifying activity and may be promoted to a hig |
Scan and Go |
Customer scans items using a mobile app while shopping, receives promotions and loyalty benefits in |
Related APIs — loyalty domain