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 |
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.
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 |
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, 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.
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
- Read about Adapter Configuration for setup details