Search

Are you looking for test card numbers?

Would you like to contact support?

Plugin icon

Install the cartridge and import the metadata

For older versions of the Adyen Payments Cartridge, see our older documentation. You can also learn more about how to migrate to Adyen Payments Cartridge version 20.1.0.

Step 1: Install the cartridge

The Adyen LINK cartridge can be used with either Storefront Reference Architecture (SFRA), a controller-based SiteGenesis, or a pipeline-based SiteGenesis.

  • If you are using SFRA, install int_adyen_overlay and int_adyen_SFRA using Commerce Cloud UX-studio.
  • If you are using a controller-based integration, install int_adyen_overlaybm_adyen, and int_adyen_controllers cartridges using Commerce Cloud UX-studio.
  • Deprecated If you are using a pipeline-based integration, install int_adyen_overlaybm_adyen, and int_adyen_pipelines cartridges using Commerce Cloud UX-studio.

Step 2: Install Node modules

From your project's root directory, install Node modules using your command line: 

npm install

Step 3: Build the code

Some files in the /src directory contain modern Javascript (ES6, MobX) that Salesforce does not natively support. Because of this, you have to run the following command from the root directory to transpile, compile and upload the compatible, auto-generated code:

npm run build

After running this command, you can find the code in the /cartridges directory.

Step 4: Import the metadata

To add new configuration items, import the predefined metadata: 

  1. Download the installation package on our GitHub page. 
  2. Open the package/metadata/site_import/sites/ folder.
  3. Rename the yourSiteId folder to the ID of your site in the Business Manager.
  4. Zip the site_import folder. 
  5. In the Business Manager, go to Administration > Site Development > Site Import & Export and import the zipped file.

After the import, attributes named Adyen[attributeName] are added to: 

  • Administration > Site Development > System Object Types > Site Preferences > Attribute Definitions
  • Administration > Site Development > System Object Types > Order > Attribute Definitions
  • Administration > Site Development > Custom Object Types 

Also, the following services are added to Administration > Operations > Services:

  • AdyenPayment
  • AdyenRecurring
  • AdyenRecurringDisable
  • AdyenPosPayment
  • AdyenOriginKeys
  • AdyenCheckoutPaymentMethods
  • AdyenPaymentDetails

Make sure you don't change the version numbers of the endpoints in the above services. Doing so could lead to errors in your integration.

Next steps