Loyalty / Spaarpunten

⚡ Built-in — Platform Built-in

Per-shop configureerbaar spaarprogramma. Vaste punten per product (seed bij aanmaak, daarna bevroren) of rate-based.

⚡ Built-in — No Setup Required This integration is built into the WebsitePublisher platform. All endpoints are available immediately — no API key needed.

Endpoints (11)

GET get-config

Haal de loyalty-configuratie van deze shop op. Leeg = programma niet actief.

No input parameters required.

POST set-config

Sla de loyalty-configuratie op (upsert). Vereist mode (per_product of rate_based).

No input parameters required.

GET get-product-points

Haal de vaste punten van een product op (alle varianten + product-default).

No input parameters required.

POST set-product-points

Zet de vaste punten voor een product of variant (handmatig, bevroren). variant_id weglaten = product-default.

No input parameters required.

POST bulk-set-product-points

Zet punten voor meerdere producten/varianten tegelijk (max 500). Voor backfill van bestaande catalogus.

No input parameters required.

GET get-balance

Besteedbaar saldo = Σ points_remaining (onverlopen committed) − actieve reserves. NIET balance_cache (dat is enkel cache).

No input parameters required.

GET list-transactions

Ledger-historie van een klant (nieuwste eerst).

No input parameters required.

POST reserve

Reserveer punten voor een checkout (earmark met TTL). Valideert tegen beschikbaar saldo + redeem-regels.

No input parameters required.

POST release

Geef gereserveerde punten van een checkout weer vrij (betaling mislukt/afgebroken).

No input parameters required.

POST commit

Boek definitief bij geslaagde betaling: reserve → committed + verdiende punten. Idempotent op order_id.

No input parameters required.

POST adjust

Handmatige correctie of verjaardagsbonus (+/−). ENIGE juiste manier om een saldo te wijzigen: verbruikt points_remaining FIFO (oudste onverlopen lot eerst) en hercachet balance_cache. Nooit losse points-rijen of directe balance_cache-edits.

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`

← Back to all integrations