Website
Loyalty / Spaarpunten
Per-shop configureerbaar spaarprogramma. Vaste punten per product (seed bij aanmaak, daarna bevroren) of rate-based.
Endpoints (11)
Haal de loyalty-configuratie van deze shop op. Leeg = programma niet actief.
No input parameters required.
Sla de loyalty-configuratie op (upsert). Vereist mode (per_product of rate_based).
No input parameters required.
Haal de vaste punten van een product op (alle varianten + product-default).
No input parameters required.
Zet de vaste punten voor een product of variant (handmatig, bevroren). variant_id weglaten = product-default.
No input parameters required.
Zet punten voor meerdere producten/varianten tegelijk (max 500). Voor backfill van bestaande catalogus.
No input parameters required.
Saldo (beschikbare punten) van een klant op e-mail.
No input parameters required.
Ledger-historie van een klant (nieuwste eerst).
No input parameters required.
Reserveer punten voor een checkout (earmark met TTL). Valideert tegen beschikbaar saldo + redeem-regels.
No input parameters required.
Geef gereserveerde punten van een checkout weer vrij (betaling mislukt/afgebroken).
No input parameters required.
Boek definitief bij geslaagde betaling: reserve → committed + verdiende punten. Idempotent op order_id.
No input parameters required.
Handmatige correctie of verjaardagsbonus (+/−). Debit verbruikt FIFO.
No input parameters required.
MCP Tool Names
When using this integration through an AI assistant (Claude, ChatGPT, Cursor, etc.), the endpoints are available as MCP tools:
| Endpoint | MCP Tool Name |
|---|---|
| get-config | loyalty_get_config |
| set-config | loyalty_set_config |
| get-product-points | loyalty_get_product_points |
| set-product-points | loyalty_set_product_points |
| bulk-set-product-points | loyalty_bulk_set_product_points |
| get-balance | loyalty_get_balance |
| list-transactions | loyalty_list_transactions |
| reserve | loyalty_reserve |
| release | loyalty_release |
| commit | loyalty_commit |
| adjust | loyalty_adjust |