The Adyen plugin connects SAP Commerce Cloud to Adyen. It provides the Adyen payment experience (Drop-in and Components) for the Accelerator storefront and for a React checkout, OCC endpoints for the Composable Storefront (Spartacus), webhook processing that drives the order process, and Backoffice configuration. Supported features include card payments with 3D Secure 2, local and redirect payment methods, express checkout, stored cards, gift cards with partial payments, Adyen Giving, and subscription billing with Recurly and Chargebee.
| Component | Version |
|---|---|
| Plugin | 13.6.0 |
| SAP Commerce | 2211-jdk21 (Java 21, Spring 6) |
| adyen-java-api-library | 42.0.1 |
| Adyen Checkout API | v71 |
| Adyen Web | 6.40.1 in the Accelerator storefront (loaded from the Adyen CDN), ^6.46.0 in the React checkout |
@adyen/adyen-spartacus |
1.6.0 (Angular 21, Spartacus 221121.7.0), versioned separately |
| Group | Extensions |
|---|---|
| Core | adyenv6core (payment logic, services, order process actions, base store attributes), adyenwebcommons (shared controller bases), adyenv6backoffice (Backoffice configuration and order actions) |
| Webhooks | adyenv6notificationv2 (event-driven, recommended), adyenv6notification (older, cron job based) |
| Order process | adyenv6fulfilmentprocess (standard Accelerator fulfilment), adyenv6ordermanagement (Order Management) |
| Storefront | adyenv6b2ccheckoutaddon (Accelerator checkout), adyencheckoutaddonapi and adyencheckoutaddonspa (React checkout), adyenocc (OCC for the Composable Storefront) |
| Subscriptions | adyensubscriptionconnector, adyenrecurlyconnector, adyenchargebeeconnector, adyensubscriptionb2caddon (billing platforms and My Subscriptions), adyenv6subscription (recurring orders for SAP Commerce subscription products) |
| SAP Digital Payments | adyensapdigitalpayment, adyensapdigitalpaymentbackoffice |
| Examples | examples/adyenmultiplemerchantexample, examples/adyenv6consignmentpartialcaptureexample |
- Download the release from GitHub Releases and unpack it into
hybris/bin/custom/adyen-sapcommercecloud. - Add the extensions to
config/localextensions.xml:adyenv6core,adyenwebcommons,adyenv6backoffice,adyenv6notificationv2, an order process extension, and the storefront extension for your setup (adyenv6b2ccheckoutaddon,adyencheckoutaddonapiwithadyencheckoutaddonspa, oradyenocc). - Set
is3DS2allowed=trueinconfig/local.properties, plus the CSRF patterns (Accelerator and React checkout) or the OCC and storefront URLs (Composable Storefront). - For the Accelerator storefront and the React checkout, run
ant addoninstallfor the add-ons. For the React checkout, also build the bundle withnpm run build-prod. - Run
ant clean all, then initialize or update the system. - In Backoffice, enter your Adyen credentials on the base store and set its checkout flow group (
adyenB2CResponsiveCheckoutGrouporadyenB2CReactCheckoutGroup). In the Adyen Customer Area, create the webhook.
The Installation page describes each step in detail, including the Adyen account preparation and a go-live checklist.
The documentation is in the wiki:
- Installation
- Upgrading
- Configuration
- Payment Methods and Features
- Subscription Billing
- Composable Storefront
- API Reference
- Troubleshooting
Release notes are on the Releases page.
If you have a feature request, or spotted a bug or a technical problem, create a GitHub issue. For other questions, contact the Adyen support team.
We encourage you to contribute to this repository, so everyone can benefit from new features, bug fixes and general improvements. Read the contribution guidelines to find out how.
MIT license. For more information, see the LICENSE file.