Plugin icon

Composable Storefront package

Use the Adyen Payments Composable Storefront package to accept payments with a headless solution in your Salesforce store.


Watch our on-demand webinar to learn more about our Composable Storefront integration.

The Adyen Composable Storefront package is a headless payments integration for Salesforce B2C Commerce stores built with the Salesforce Progressive Web App (PWA) Kit. The package includes front-end and back-end components that enable payment processing using the Adyen Web Drop-in.

The Salesforce PWA Kit allows you to create custom storefronts. After you have built your storefront, you can use Managed Runtime to deploy, host, and monitor your integration.

Read more about Composable Storefront, PWA, and Managed Runtime in Salesforce Documentation.

Supported versions

You can find the latest version of the package on npm.

Our package supports:

  • Salesforce PWA Kit:
    • v1.2.0 and earlier supports PWA kit v3.1.1 and later
    • v2.0.0 and later supports PWA kit v2.7.0 and later
  • Node v18 or later
  • npm v9 or later

If you decide to customize your integration, we recommend that you:

  • Keep track of the custom code added to your integration.
  • Follow the customization best practices outlined in our Customization guide.

Get started

  Demo storefront

See the demo Composable Storefront site integrated with the Adyen payments package.

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 and set up the Composable Storefront integration.
  2. Set up payment methods.
  3. Customize the payment, order, and status processing of your PWA app with the Adyen payments integration.
  4. Use our test card numbers to make test payments with your integration.

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.

Migrate from SFRA or SiteGenesis

If you already have an SFRA or SiteGenesis integration with Adyen, you can migrate to the Composable Storefront architecture.

To migrate, you must follow the standard installation and setup guide and complete the step to migrate your store pages. We recommend you first migrate in the test environment.

Next steps