Loyalty Clover
Backend API for the Clover Duo loyalty app.
Sign in as admin to manage customers, rewards, ledger, and pending Clover order approvals.
Endpoints (for the device app)
| Method | Path | Purpose |
|---|---|---|
| POST | /api/customer/check-in | Begin a session by phone number |
| GET | /api/session/{id} | Fetch customer profile + eligible rewards + pending award |
| POST | /api/session/{id}/redeem | Redeem a reward (applies Clover discount + writes ledger) |
| POST | /api/session/{id}/clear | End the session |
| POST | /api/session/{id}/attach-order | Bind the session to a Clover order id |
All device endpoints require the X-Device-Key header.
Clover webhooks
Configure Clover to POST order-paid events to /api/webhooks/clover. Payloads are HMAC-verified.