Adyen Checkout Adapter

Overview

The Adyen Checkout Adapter integrates Adyen's payment platform with Norce Checkout, enabling merchants to offer Adyen's comprehensive payment solution within the Norce Commerce platform. Adyen provides a unified payment gateway supporting a wide range of payment methods including card payments, digital wallets, bank transfers, and buy-now-pay-later options through a single integration.

This adapter is part of Norce Checkout (NCO) and implements Adyen's Advanced Flow integration using the Drop-in component. The adapter handles the complete payment flow from checkout initialization through order completion, including webhook handling for asynchronous payment events.

Capabilities and Supported Flows

Payment Operations

Feature	Full	Partial
Capture	✅	❌	Captured by Adyen per the merchant account capture setting; NCO is updated via the `CAPTURE` webhook
Refund	❌	❌	Via Adyen Customer Area only
Cancel / Void	✅	—	Supported before capture

Supported Payment Methods

Method
One-time Payment	✅	Standard checkout flow
Recurring Payment	✅	Subscription tokenization
Card Payments	✅	Visa, Mastercard, Amex, etc.
Digital Wallets	✅	Apple Pay, Google Pay, Swish
Bank Transfers	✅	Trustly, iDEAL
Buy Now Pay Later	✅	Klarna (via Adyen)
PayPal	✅	Via Adyen integration

Advanced Features

Feature
Drop-in Component	✅	Adyen's embedded checkout UI
3D Secure	✅	Automatic handling
Webhook Events	✅	AUTHORISATION, CAPTURE, RECURRING_CONTRACT
Payment Method Config	✅	Customizable per merchant

Limitations:

Only Drop-in component is supported (individual payment components are not supported)
Refund operations are handled through Adyen's Customer Area, not directly through this adapter
Partial capture is not supported through this adapter
The Adyen Checkout Adapter has no auto-capture setting. Auto-capture is configured in the Adyen Customer Area. With Adyen's default immediate automatic capture, Adyen sends no CAPTURE webhook, so the Norce Checkout payment stays reserved after Adyen has captured the funds. Use delayed automatic capture or manual capture, with the CAPTURE event code enabled on the Adyen webhook, to have the Norce Checkout payment set to captured.

Configuration

The Adyen Checkout Adapter is configured through Norce Checkout Admin. The following settings are required:

Setting	Description
`ApiUrl`	Adyen Checkout API URL (e.g., `https://checkout-test.adyen.com` for test)
`AdyenApiKey`	Your Adyen API key from the Customer Area
`AdyenClientKey`	Your Adyen Client key for frontend integration
`MerchantAccount`	Your Adyen merchant account name
`IsLiveEnvironment`	Set to `true` for production, `false` for test
`ReturnUrl`	URL to redirect after payment completion

Optional settings include:

Setting	Description
`WebhookHmacKey`	HMAC key for webhook signature verification
`UseRecurringPayment`	Enable recurring payment token generation
`PaymentMethodsConfiguration`	Custom configuration object for Adyen payment methods