Upgrade the cartridge

We recommend that you upgrade when we have a major release.

If you are on a version that is not maintained according to our cartridge support schedule, we recommend that you upgrade to the latest release available for your integration:

• SFRA: Upgrade to the latest version available.
• SiteGenesis: Upgrade to v22.2.3.

To stay up to date on the released fixes and features, subscribe to our releases on GitHub.

The integration effort involved in upgrading depends on whether you have made any customizations to the cartridge.

There are different steps to follow for:

• Default integration
• Customized Integration

Default Integration

1. Check which SFRA version is required for this upgrade and migrate if necessary. We recommend you use the latest version of SFRA.
2. Download the Adyen cartridge version that you want to install from GitHub.
3. Reupload the metadata:
   1. Download the installation package on our GitHub page. 
4. Include your customizations in the metadata file.
5. Open the package/metadata/site_import/sites/ folder.
6. Rename the yourSiteId folder to the ID of your site in your Salesforce Business Manager.
7. Zip the site_import folder. 
8. In the Business Manager, go to Administration > Site Development > Site Import & Export and import the zipped file.
9. Run to following command from the root directory to transpile, compile and upload the compatible, auto-generated code:

   npm run build

Customized Integration

Before you begin, check if there are any breaking changes that affect your custom code.

1. Extract any custom code you have added to the cartridge.
2. Add the extracted custom code in a separate cartridge. For example, int_custom_cartridge.
3. Check which SFRA version is required for this upgrade and migrate if necessary. We recommend you use the latest version of SFRA.
4. Download the Adyen cartridge version that you want to install from GitHub. Create a folder with the downloaded cartridge.
5. Re-upload the metadata:
   1. Download the installation package on our GitHub page. 
6. Include your customizations in the metadata file.
7. Open the package/metadata/site_import/sites/ folder.
8. Rename the yourSiteId folder to the ID of your site in your Salesforce Business Manager.
9. Zip the site_import folder. 
10. In the Business Manager, go to Administration > Site Development > Site Import & Export and import the zipped file.
11. Run the following command from the root directory of the unmodified Adyen cartridge to transpile, compile and upload the compatible, auto-generated code:

    npm run build

12. Run the following command from the root directory of your customized cartridge to transpile, compile and upload the compatible, auto-generated code:

    npm run build

13. Check if the custom code is compatible with the new version and apply changes if needed.
14. Change the cartridge path to include your customizations:
    1. In the Salesforce Business Manager, go to Administration > Sites > Manage Sites > [yourSite] > Settings.
    2. In the Cartridges field for SFRA, enter: int_custom_cartridge:YOUR_CARTRIDGE_PATH
       • YOUR_CARTRIDGE_PATH: The cartridge path that you have set up.

Watch how to upgrade your customized SFCC cartridge:

Breaking changes for customized integrations

New versions may include changes that affect custom code, these are documented in our release notes as Breaking Changes. To see an overview of all breaking changes introduced between versions, use the What's changed? feature in our release notes.

The changes you must consider depends on the cartridge version you are upgrading from. For example, when upgrading from v21.2.0 to v23.1.0, you must not only consider the breaking changes in the v23.1.0, but all the breaking changes that were introduced between these versions.