Provider Adapters
Provider adapters connect Norce Checkout with external service providers for payments, shipping, and vouchers. They handle the communication between Norce Checkout and third-party APIs, ensuring orders stay synchronized as customers progress through checkout.
How Provider Adapters Work
When a customer interacts with a provider service during checkout (selecting a payment method, choosing shipping, applying a voucher), the provider adapter:
- Receives the request from your checkout frontend
- Translates the Norce Checkout order into the provider's expected format
- Communicates with the provider's API
- Updates the Norce Checkout order with the provider's response
- Registers hooks to stay informed of subsequent order changes
Provider adapters use hooks and notifications to maintain synchronization. When the cart changes, payment adapters automatically recalculate amounts. When shipping is selected, the order total updates to reflect shipping costs.
Payment Adapters
Payment adapters integrate payment service providers (PSPs) with Norce Checkout. They handle payment session creation, widget embedding, payment authorization, and capture.
| Adapter | Provider | Checkout Type |
|---|---|---|
klarna_checkout_adapter | Klarna | Hosted checkout |
klarna_payments_adapter | Klarna | Embedded widgets |
adyen_dropin_adapter | Adyen | Embedded drop-in |
svea_checkout_adapter | Svea | Hosted checkout |
walley_checkout_adapter | Walley | Hosted checkout |
paypal_adapter | PayPal | Redirect/embedded |
qliro_checkout_adapter | Qliro | Hosted checkout |
avarda_checkout_adapter | Avarda | Hosted checkout |
ledyer_checkout_adapter | Ledyer | Hosted checkout (B2B invoicing) |
nonpsp_adapter | None | Manual/invoice |
Each payment adapter supports the standard payment flow: create payment, authorize, and capture. Some adapters support additional features like partial captures, refunds, and recurring payments.
These are not separate Norce adapters — they're payment methods offered within a hosted PSP checkout. Vipps, Swish, and MobilePay are available as digital wallet options inside the Svea and Avarda checkout adapters. See Svea Checkout Adapter and Avarda Checkout Adapter for the full list of payment methods each provider offers.
Read more about Payment Adapters.
Shipping Adapters
Shipping adapters integrate delivery management services with Norce Checkout. They present shipping options to customers and calculate delivery costs based on cart contents and delivery address.
| Adapter | Provider | Features |
|---|---|---|
ingrid_adapter | Ingrid | Delivery options, pickup points, delivery dates |
nshift_adapter | nShift | Delivery options, pickup points, time-slot delivery, carrier tracking |
Shipping adapters register hooks on cart and customer address changes to recalculate shipping options and costs as the order evolves.
Read more about Shipping Adapters.
Voucher Adapters
Voucher adapters handle gift cards, discount codes, and promotional vouchers. They validate voucher codes, check balances, and apply discounts to the order total.
| Adapter | Provider | Features |
|---|---|---|
awardit_adapter | Awardit | Gift cards (redeem and sell), loyalty points |
Voucher adapters create payments of type voucher with an upperLimitAmount that caps how much of the order the voucher can cover. The remaining amount is paid through a regular payment adapter.
Read more about Voucher Adapters.
Loyalty Adapters
Loyalty adapters integrate customer loyalty and CRM platforms with Norce Checkout. They resolve a loyalty member, attach them to the order as customer.loyalty.id, and write applied loyalty promotions and reward vouchers to the order so that the Norce Adapter can translate them into discount line items in Norce Commerce.
| Adapter | Provider | Features |
|---|---|---|
voyado_checkout_adapter | Voyado Engage | Contact linking, Voyado promotions, reward vouchers |
Read more about Loyalty Adapters.
Norce Adapter
Unlike the payment, shipping, voucher, and loyalty adapters above — which each integrate a specific external provider — the Norce Adapter is a required platform adapter that syncs a Norce Commerce basket to a Norce Checkout order and keeps Norce Commerce updated as the order progresses, including creating the order in Norce Commerce once checkout completes.
These are easy to confuse but solve different problems. The Norce Adapter is not a payment method — every Norce Checkout order needs it (or an equivalent) to stay synchronized with Norce Commerce. The Non-PSP Adapter is a payment method — it lets a merchant complete an order without going through an external payment provider (e.g. invoicing handled entirely in the ERP). A single order can use the Norce Adapter for commerce sync alongside any payment adapter, including the Non-PSP Adapter.
Read more about the Norce Adapter.
Configuring Provider Adapters
Each provider adapter requires configuration through the Configuration API. Configuration typically includes:
- API Credentials: Keys, secrets, and merchant identifiers for the provider
- Environment: Production or sandbox/test environment
- Feature Flags: Enable or disable specific adapter features
- Localization: Default locale and supported languages
See the individual adapter documentation for specific configuration requirements.
Combining Multiple Adapters
Norce Checkout supports multiple provider adapters working together on a single order. Common combinations include:
- Payment + Shipping: Klarna Checkout with Ingrid for delivery options
- Payment + Voucher: Adyen with Awardit gift cards
- Multiple Payments: A voucher covering part of the order, with the remainder paid via Klarna
Adapters coordinate through the order's hooks and notifications system, ensuring all adapters stay synchronized as the order changes.
Next Steps
- Explore Payment Adapters for payment integration options
- Learn about Shipping Adapters for delivery management
- See Voucher Adapters for gift card integration
- See Loyalty Adapters for CRM and loyalty integration
- Read about Adapter Configuration for setup details