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

Upgrade the cartridge

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

We recommend that you upgrade when we have a major release, such as 23.1.0.

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

If you are on a version older than 21.2.0, we recommend that you update to the latest release available for your integration:

There are different steps to follow for:

Default Integration

  1. Check which SFRA version is required for this upgrade and migrate if necessary. We recommend you use the highest available 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. 
    2. Include your customizations in the metadata file.
  4. Open the package/metadata/site_import/sites/ folder.
  5. Rename the yourSiteId folder to the ID of your site in the Business Manager.
  6. Zip the site_import folder. 
  7. In the Business Manager, go to Administration > Site Development > Site Import & Export and import the zipped file.
  8. Run to following command from the root directory to transpile, compile and upload the compatible, auto-generated code: 
    npm run build

Customized Integration

  1. Extract any custom code you have added to the cartridge and add them to a custom cartridge. For example, int_custom_cartridge.
  2. Check which SFRA version is required for this upgrade and migrate if necessary. We recommend you use the highest available version of SFRA.
  3. Download the Adyen cartridge version that you want to install from GitHub. Create a folder with the downloaded cartridge.
  4. Re-upload the metadata:
    1. Download the installation package on our GitHub page. 
    2. 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 the 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 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
  10. 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
  11. Check if the custom code is compatible with the new version and apply changes if needed.
  12. Change the cartridge path to include your customizations:
    1. In the Business Manager, go to Administration > Sites > Manage Sites > [yourSite] > Settings.
    2. In the Cartridges field for SFRA, enter: int_custom_cartridge:int_adyen_SFRA:int_adyen_overlay:app_storefront_base.

Different versions include different changes that affect custom code. The changes between versions that you need to consider depends on which version you are upgrading from:

  • New Checkout API version: v70.
  • New WebComponent version: v5.40.0.