Plugin icon

Storefront Reference Architecture (SFRA) and SiteGenesis

Use our cartridge for SiteGenesis and SFRA to accept payments in your Salesforce store.

The Adyen payments cartridge is a full payment solution for your Salesforce Commerce Cloud site. With one integration, you get access to all features of the Adyen payments platform, including all global and preferred local payment methods, recurring payments, risk management, and conversion optimization.

You can integrate with Adyen as your payment processor for your Salesforce site with:

  • controller-based SiteGenesis
  • Storefront Reference Architecture (SFRA)  Recommended

Adyen is certified as an official Quick Start solution for Salesforce Commerce Cloud B2C Commerce, reducing training and implementation time for the SFRA storefronts.

Our cartridge is built using the Adyen Web Components.

Supported versions

This documentation reflects the latest version of the cartridge. You can find the latest version on GitHub.

Our plugin supports:

  • SFRA versions 5, 6, and 7
  • Node v14 or later

We may be unable to provide support if you are not using the default checkout. We do not recommend customizing the plugin, because this could make it harder to upgrade and maintain your integration.
If you decide to customize your integration, we recommend that you:

  • Keep track of the custom code added to your integration.
  • Create an issue on GitHub if you want to suggest a new feature for the plugin.
  • Follow the customization best practices outlined in our Customization guide.

Get started

Before you begin to integrate, make sure you have followed the Get started with Adyen guide to:

  • Get an overview of the steps needed to accept live payments.
  • Create your test account.

While you wait for your live account credentials, you can start integrating by using your test account:

  1. Install the cartridge and import the metadata.
  2. Only if you are using SiteGenesis, customize storefront code.
  3. Set up the cartridge.
  4. Set up payment methods.
  5. If you are using SFRA, you can optionally customize your integration.
  6. Use our test card numbers to make test payments.

Before going live, follow our go-live checklist to make sure you've got everything set up correctly.

If you experience any issues with your integration, follow our troubleshooting guide.

End of cartridge support

V18 - V21 have reached end of cartridge support in 2023.
We recommend upgrading to the latest version available for SFRA and to version 22.2.3 for SiteGenesis.

We are scaling down the amount of time that the Support Team provides for SFCC-related questions. After Level 3 cartridge support ends, we no longer provide:

  • In-depth technical assistance for the SFCC cartridge.
  • Cartridge bug fixes.
  • Minor security patches.

Check our FAQ for more details.

We will continue to address security vulnerabilities and impactful compliance fixes, so that you can implement the required changes.

We strongly recommend that you upgrade to a later version. Otherwise, we consider the plugin to be your own custom integration.

PCI DSS compliance

Your PCI DSS compliance scope doesn't change, as long as you use one of Adyen's pre-built solutions in your SFCC integration, for example, Web Drop-in or Component.

Adyen SFCC cartridges v19.0.0 or later are compliant because they use Web Component to process and encrypt cardholder data.

If you made any customizations that change the way cardholder data is processed by the cartridge, you must validate your PCI DSS compliance.

Next steps