/adyen-salesforce-commerce-cloud

Salesforce Commerce Cloud (formerly Demandware)

Primary LanguageJavaScriptMIT LicenseMIT

Salesforce Commerce Cloud Adyen Cartridge

Adyen provides a LINK cartridge to integrate with Salesforce Commerce Cloud (SFCC). This cartridge enables a SFCC storefront to use the Adyen payment service.
This cartridge supports SFRA version 5.x.x & 6.x.x.
and SiteGenesis JS-Controllers version 103.1.11 and higher (no features in cartridges higher than v22.2.2)

Integration

This cartridge allows you to integrate with Adyen without the need for any development work from your end.
Online payments are processed on the back-end using the Checkout API, on the client side Adyen’s Web Components are used to render payment methods.
Point of Sale (POS) payments are processed using a cloud-based Terminal API.

Requirements

It is required to have an Adyen account to use the cartridge. You can do this here.

Installation, Usage and Configuration

Installation, Usage and Configuration is explained in Adyen's online documentation.

Apple Pay configuration for both Adyen certificate and Apple certificate using Salesforce cartridge can be found here.

Testing

End-to-End tests can be found in the adyen-salesforce-commerce-cloud/tests/e2e directory. They are run automatically via Github Actions using the E2E.yml workflow. To run the tests locally use the following command:

`npm run test:e2e`

Note: Please make sure to fill in the environment variables in the fixtures directory before running the tests locally.

As for Unit tests, they are currently only available for SFRA. Test files can be found next to the files they are testing. Mocks are kept in the jest directory. To run SFRA unit tests locally use the following command:

`npm run test`

Support & Maintenance

We provide three levels of support for major versions of the plugin as per SFCC B2C Support policy:

  • Level 1: Full support. Keep in mind that some new features are not possible on older versions, therefore this is not inclusive of ALL new features that are built.
  • Level 2: High priority bug fixes and security updates.
  • Level 3: Security updates only.

After Level 3 End-of-support date, there is no support or maintenance from Adyen on the cartridge, and it will be treated as a custom integration.

Migration and Upgrade Guide

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.

Contributing

We strongly encourage you to join us in contributing to this repository so everyone can benefit from:

  • New features and functionality
  • Resolved bug fixes and issues
  • Any general improvements

Read our contribution guidelines to find out how.

Platform

Read more information about the Adyen platform.

Licence

MIT license see LICENSE.