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 | ✅ | ❌ | Via Adyen webhooks |
| 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
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 |
Links and References
Norce Checkout API References
Adyen Checkout Adapter API
Norce Checkout Overview
- Norce Checkout Introduction
- Working with Norce Checkout
- Payment Adapters Overview
- Adyen Checkout Adapter Developer Guide