Norce Checkout

Norce Checkout is a composable, adapter-based checkout solution designed for headless e-commerce environments. Norce Checkout handles the payment, shipping, and order completion phases of the checkout process, allowing you to mix and match payment providers, shipping services, and platform integrations through its flexible adapter architecture.

Checkout Path

Norce Checkout is one of two checkout paths available when using Norce Commerce. The alternative is the legacy checkout path using the Commerce Services Shopping Service. Both paths start with creating a basket in Norce Commerce, but they diverge after that point. This documentation covers the Norce Checkout path. For the legacy checkout path, see Working with the Checkout Process.

How Norce Checkout Fits Into Your Solution

Every checkout flow begins with a basket created in Norce Commerce using the Shopping Service. When the customer is ready to check out, the Norce Adapter creates a Norce Checkout order from that basket. From this point, Norce Checkout orchestrates the checkout process through its adapter system.

The Norce Adapter maintains synchronization between Norce Commerce and Norce Checkout. Payment adapters (such as Klarna, Adyen, or Svea) handle payment processing. Shipping adapters (such as Ingrid) manage delivery options. All adapters communicate through Norce Checkout's hooks and notifications system, ensuring they stay synchronized as the order progresses.

When the checkout completes, the Norce Adapter exports the finalized order back to Norce Commerce with all payment and shipping details.

Why Use Norce Checkout

Norce Checkout provides several advantages over traditional checkout implementations:

Adapter Flexibility: Choose from a growing library of payment, shipping, and voucher adapters. Switch providers or add new ones without rebuilding your checkout flow.

Automatic Synchronization: Adapters stay in sync automatically through hooks and notifications. When the cart changes, payment amounts update. When shipping options change, totals recalculate.

Microservice Architecture: Each adapter runs independently, enabling faster updates and reducing the impact of changes to individual components.

Headless Design: Norce Checkout provides APIs that work with any frontend, giving you full control over the checkout user experience.

Getting Started

Get started with implementation guidance when building your application, see Working with Norce Checkout in the Developer Portal.

Core

There are currently four core APIs in Norce Checkout that enable your solutions.

Order

The Order API is the most important part, enabling you to manage orders. Each order contains key details such as cart information, customer data, delivery options, payments, and more — including any notifications associated with the order.

Notification

The Notification API allows you to ensure notifications have reached their destinations. Read all notifications for a specific order or all notifications for a specific event across all orders.

Configuration

For any checkout that uses adapters, as we expect all checkouts to do, another vital API is the Configuration API. Adapters expect to find their configurations here for the given channel you're in. You can set up the configurations using the API or by using the Norce Checkout Admin.

Tip

If you're using Norce Commerce, you can quickly find the Norce Checkout Admin under 'Shopping' by selecting 'Checkout'. Note that you may need to enable this component in your client settings.

Translation

In some cases, adapters are asked to provide messages directly to the end customer and this is where they'll find it. The Translation API allows you to set up your own translations if needed.

Adapters

Adapters are the building blocks of Norce Checkout. Each adapter connects Norce Checkout to an external service or platform, handling the integration details so you can focus on building your checkout experience. Adapters communicate through hooks and notifications, ensuring they stay synchronized as the order progresses.

Norce provides a growing library of adapters, and you can also build custom adapters for your specific needs. Read more about adapters in the Adapters Overview.

The Platform Adapter

The primary platform adapter is the Norce Adapter, which connects Norce Commerce to Norce Checkout. It creates Norce Checkout orders from Norce Commerce baskets and exports completed orders back to Norce Commerce.

Read more about the Norce Platform Adapter.

Provider Adapters

Provider adapters integrate Norce Checkout with payment, shipping, and voucher services. These adapters handle the communication with external providers, mapping Norce Checkout orders to provider-specific sessions and formats.

Payment Adapters:

Klarna (klarna_checkout_adapter, klarna_payments_adapter)
Adyen (adyen_dropin_adapter)
Walley (walley_checkout_adapter)
Avarda (avarda_checkout_adapter)
Svea (svea_checkout_adapter)
PayPal (paypal_adapter)
Qliro (qliro_checkout_adapter)

Shipping Adapters:

Ingrid (ingrid_adapter)

Voucher Adapters:

Awardit (awardit_adapter)