Are you looking for test card numbers?

Would you like to contact support?

No momento, esta página não está disponível em português
Plugin icon

Salesforce Commerce Cloud - B2C Commerce and Quick Launch

Use Adyen Payments Cartridge to offer payments online, in-app, and in-store.

The Adyen Payments Cartridge - B2C Commerce and Quick Launch is a full payment solution for your Salesforce Commerce Cloud ecommerce site. One integration gives you access to all features of the Adyen payments platform, including all global and preferred local payment methods, recurring payments, risk management, and conversion optimization. 

For older versions of the Adyen Payments Cartridge, see our older documentation.

The cartridge can be used with:

  • Commerce Cloud's Storefront Reference Architecture (SFRA) 
  • a controller-based SiteGenesis
  • Deprecated a pipeline-based SiteGenesis

For a list of frequently asked questions, refer to our FAQs.

Quick Launch

Adyen is certified as an official Quick Launch solution for Salesforce Commerce Cloud B2C Commerce, reducing training and implementation time. When setting up the Payments Cartridge, follow our documentation for SFRA users.


  • Credit cards: accept credit card payments on your website and mobile application, without redirecting to an external website. Sensitive cardholder data is collected securely using our Card Component, which reduces your PCI DSS-compliance requirements.
  • Dynamic 3D Secure 2 authentication, including AVS checks.
  • Local payment methods: accept local payment methods including iDEAL, Sofort, Klarna, giropay, Google Pay, and many others.
  • POS payments: accept in-person payments at the point of sale using payment terminals.
  • Tokenization: offer returning shoppers a faster checkout experience by saving their card details, or implement subscription payments.
  • Revenue Protect: use our risk management system to identify and block fraudsters, while reducing friction for legitimate shoppers. You can either fully automate the risk management process, or add manual review for certain payments.
  • Adyen Giving : allow shoppers to donate to a chosen charity at checkout. This feature is available with card payments and iDeal payments.

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 and 6.

We may be unable to provide support if you are not using the default Salesforce 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.

Support levels

We provide three levels of support for major versions of the plugin:

  • Level 1: Full support.
  • Level 2: High priority bug fixes and security updates.
  • Level 3: Security updates only.
Major version Release date Level 1 support until Level 2 support until Level 3 support until
V18 April 2018 30 September 2023 30 September 2023 30 September 2023
V19 July 2019 30 September 2023 30 September 2023 30 September 2023
V20 July 2020 31 December 2023 31 December 2023 31 December 2023
V21 August 2021 31 December 2023 31 December 2023 31 December 2023
V22 May 2022 30 November 2023 31 May 2024 30 November 2024
V23 1 2 February 2023 12 months after release 18 months after release 24 months after release
V24 soon in development 12 months after release 18 months after release 24 months after release

1 From this version onward, we do not provide any level of support for SiteGenesis integrations.
2 From this version onward, all major releases will follow the V23 support schedule.

When the level 3 support period has ended, security updates will no longer be provided and Adyen support ends. You should upgrade to a later version or consider the plugin your own custom integration.
For SiteGenesis integrations, no new features are released and Adyen support ends from version 22.2.2 onward. You can still process with Adyen, but you are responsible for maintaining your code and ensuring that your integration is PCI DSS compliant.

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 required if you are using SiteGenesis: Update your storefront code
  3. Set up the cartridge
  4. Set up the payment methods
  5. Use our test card numbers to make test payments for all payment methods that you want to offer.

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

If you are experiencing an issue with your integration, have a look at our Troubleshooting guide.

See also

Próximas etapas