Loyalty Adapters Overview

Loyalty adapters integrate customer loyalty and CRM platforms with Norce Checkout. They let a signed-in loyalty member apply their promotions and reward vouchers to a Norce Checkout order.

For general requirements and access details, see How to access Norce Checkout.

API Environments and URLs

All Norce Checkout loyalty adapters use the same URL pattern:

Replace {slug} with your unique Norce instance slug and {adapter} with the provider-specific name (e.g. voyado).

How Loyalty Adapters Work

Loyalty adapters read and write order.customer.loyalty on the Norce Checkout order. A typical flow is:

1. The storefront identifies the customer in the loyalty platform and obtains an external contact id.
2. The storefront calls the loyalty adapter's "set loyalty" endpoint with that contact id. The adapter validates the contact against the loyalty platform and stores it on order.customer.loyalty.id together with the correct provider value.
3. The storefront calls the adapter's promotions and rewardvouchers endpoints to list what the customer is entitled to.
4. The customer selects items to apply. The storefront calls the adapter's apply and remove endpoints. The adapter writes the selection to order.customer.loyalty.promotions[] and order.customer.loyalty.rewardVouchers[].
5. The Norce Adapter reacts to those loyalty changes and adds the corresponding discount line items to the cart in Norce Commerce.

All promotion and reward-voucher endpoints require order.customer.loyalty.id to be set first. If it is missing, the adapter returns loyalty-id-missing.

Available Loyalty Adapters

• Voyado Loyalty Adapter