Loyalty Adapters

Loyalty adapters connect Norce Checkout with customer loyalty and CRM platforms. They participate in the checkout flow so that a signed-in loyalty member can apply their available promotions and reward vouchers to a Norce Checkout order.

Their job is to:

1. Resolve a loyalty member against the external loyalty platform.
2. Attach that member to the Norce Checkout order as customer.loyalty.id.
3. Read the promotions and reward vouchers that the member is entitled to.
4. Write applied promotions and reward vouchers to the order's loyalty payload so that the Norce Adapter can translate them into discount line items in Norce Commerce.

Available Loyalty Adapters

Integration Flow

Loyalty adapters run inside the normal checkout flow, not as a post-purchase notification. The typical flow is:

1. The storefront identifies the customer in the loyalty platform (e.g. via login, phone number, or email) and obtains the external contact id.
2. The storefront calls the loyalty adapter's "set loyalty" endpoint with that contact id. The adapter validates the contact and stores it on order.customer.loyalty.id with the correct provider.
3. The storefront calls the adapter's promotions and rewardvouchers endpoints to list what the customer is entitled to.
4. The customer selects promotions and/or reward vouchers, and the storefront calls apply / remove on the adapter. The adapter writes these 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.

Configuration

Loyalty adapters are configured per merchant/channel in Norce Checkout Admin alongside other adapters. Each loyalty adapter needs:

• Credentials for the external loyalty platform (API key, client id, etc.).
• The adapter's internal and public URLs.
• Adapter-specific configuration such as Norce discount externalId mappings used when applying rewards to the Norce order. For the Voyado Loyalty Adapter this mapping is rewardVoucherLevels.

See the individual adapter pages for the required fields.