{"id":23154977,"url":"https://github.com/Adyen/adyen-salesforce-commerce-cloud","last_synced_at":"2025-08-17T22:31:49.119Z","repository":{"id":27770256,"uuid":"31258689","full_name":"Adyen/adyen-salesforce-commerce-cloud","owner":"Adyen","description":"Salesforce Commerce Cloud (formerly Demandware)","archived":false,"fork":false,"pushed_at":"2025-08-11T09:07:13.000Z","size":31328,"stargazers_count":98,"open_issues_count":20,"forks_count":84,"subscribers_count":30,"default_branch":"main","last_synced_at":"2025-08-11T11:19:42.329Z","etag":null,"topics":["adyen","cartridge","payment","payment-gateway","payment-integration","payment-module","payment-processing","payments","salesforce-commerce-cloud","sfcc","sfra","sitegenesis"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Adyen.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2015-02-24T12:19:11.000Z","updated_at":"2025-08-11T09:00:54.000Z","dependencies_parsed_at":"2023-09-27T17:39:15.771Z","dependency_job_id":"30c02dcc-b4a2-446c-9153-e8e64f9f1ff0","html_url":"https://github.com/Adyen/adyen-salesforce-commerce-cloud","commit_stats":null,"previous_names":[],"tags_count":54,"template":false,"template_full_name":null,"purl":"pkg:github/Adyen/adyen-salesforce-commerce-cloud","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adyen%2Fadyen-salesforce-commerce-cloud","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adyen%2Fadyen-salesforce-commerce-cloud/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adyen%2Fadyen-salesforce-commerce-cloud/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adyen%2Fadyen-salesforce-commerce-cloud/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Adyen","download_url":"https://codeload.github.com/Adyen/adyen-salesforce-commerce-cloud/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adyen%2Fadyen-salesforce-commerce-cloud/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270918296,"owners_count":24667664,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-17T02:00:09.016Z","response_time":129,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adyen","cartridge","payment","payment-gateway","payment-integration","payment-module","payment-processing","payments","salesforce-commerce-cloud","sfcc","sfra","sitegenesis"],"created_at":"2024-12-17T20:15:09.269Z","updated_at":"2025-08-17T22:31:49.111Z","avatar_url":"https://github.com/Adyen.png","language":"JavaScript","funding_links":[],"categories":["Open Source"],"sub_categories":["Integrations"],"readme":"# Salesforce Commerce Cloud Adyen Cartridge\n\nAdyen provides a LINK cartridge to integrate with [Salesforce Commerce Cloud (SFCC)](https://docs.adyen.com/plugins/salesforce-commerce-cloud). This cartridge enables an SFCC storefront to use the Adyen payment service.  \n\n## Compatibility with SFCC architectures\n- SFRA version 5.x.x, 6.x.x. \u0026 7.x.x.: [Supported in all cartridge versions, see the latest](https://github.com/Adyen/adyen-salesforce-commerce-cloud/releases)    \n- SiteGenesis JS-Controllers version 103.1.11 and higher: Hosted in a separate repo - see cartridge [v22.2.3](https://github.com/Adyen/adyen-salesforce-commerce-cloud-site-genesis/releases/tag/22.2.3)\n\n## Integration\nThis cartridge allows you to integrate with Adyen without the need for any development work from your end. \n- Online payments are processed on the back-end using the [Checkout API](https://docs.adyen.com/api-explorer/Checkout/latest/overview), and on the client side, Adyen’s [Web Components](https://docs.adyen.com/online-payments/components-web) are used to render payment methods. \n- Point of Sale (POS) payments are processed using a cloud-based [Terminal API](https://docs.adyen.com/point-of-sale/terminal-api-fundamentals).\n\nThis cartridge contains 2 folders, /src and /cartridges. The /src folder is the origin, while the /cartridges folder contains the transpiled code.\n\n### Transpilation \nSome files in the /src directory contain modern JavaScript (ES6, MobX) that Salesforce Commerce Cloud does not natively support. \nTo make the code compatible, we downgrade the ES6 to ES5 by transpiling, compiling, and uploading the auto-generated code to the /cartridges directory, see [more in our Docs](https://docs.adyen.com/plugins/salesforce-commerce-cloud/install-the-cartridge-and-import-the-metadata/#step-3-build-the-code).\n\n### Customization Best Practices\nAfter [v 23.2.1]((https://github.com/Adyen/adyen-salesforce-commerce-cloud/releases/tag/23.2.1))\n- **Best practice!** Modularizing customizations is the recommended approach, as [outlined by Salesforce](https://developer.salesforce.com/docs/commerce/sfra/guide/b2c-customizing-sfra.html).\n- To customize Adyen payments, create a new cartridge in your /cartridges directory or leverage `int_custom_cartridge`, which is already set up in this repository.\n- Customizations added to a separate cartridge will not be transpiled and will be preserved when you [upgrade to a new cartridge version](https://docs.adyen.com/plugins/salesforce-commerce-cloud/upgrade/#customized-integration).\n- For more guidance on customization, refer to [Adyen Customization Guide](https://docs.adyen.com/plugins/salesforce-commerce-cloud/customization-guide/#add-custom-code).\n\nBefore v 23.2.1\n- **Best practice!** Modularizing customizations is also the recommended approach for older versions, as [noted by Salesforce](https://developer.salesforce.com/docs/commerce/sfra/guide/b2c-customizing-sfra.html).\n- Customizations added to a separate cartridge will not be transpiled and will be preserved when you [upgrade to a new cartridge version](https://docs.adyen.com/plugins/salesforce-commerce-cloud/upgrade/#customized-integration).\n- For more guidance on customization, refer to [Adyen Customization Guide](https://docs.adyen.com/plugins/salesforce-commerce-cloud/customization-guide/#add-custom-code).\n\n**Not Recommended**\n- We strongly discourage adding changes directly to /cartridges or /src/cartridges.\n- Customizations made in these directories cannot be easily separated from your codebase once deployed to production, leading to a more complex and costly upgrade process.\n\n## Requirements\n\nIt is required to have an Adyen TEST and, later, LIVE account to use the cartridge. You can set it up [here](https://www.adyen.com/signup) or [contact Adyen](https://www.adyen.com/contact/sales).\n\n## Installation, Usage and Configuration\n\nInstallation, Usage and Configuration is explained in Adyen's [online documentation](https://docs.adyen.com/plugins/salesforce-commerce-cloud/).\n\nApple Pay configuration for both Adyen certificate and Apple certificate using Salesforce cartridge can be found [here](https://docs.adyen.com/plugins/salesforce-commerce-cloud/set-up-payment-methods/#set-up-apple-pay-on-the-web). \nWe recommend using Apple pay with Adyen certificate.\n\n## Testing\nEnd-to-End tests can be found in the `adyen-salesforce-commerce-cloud/tests/e2e` directory. \nThey are run automatically via Github Actions using the `E2E.yml` workflow.\nTo run the tests locally use the following command:\n```\n`npm run test:e2e`\n```\nNote: Please make sure to fill in the environment variables in the `fixtures` directory before running the tests locally.\n\nAs 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.\nTo run SFRA unit tests locally use the following command:\n```\n`npm run test`\n```\n## Support \u0026 Maintenance\n\nWe provide specialized cartridge support for 2 years for major versions, following the [SFCC B2C Support policy](https://docs.adyen.com/plugins/salesforce-commerce-cloud#support-levels), along with permanent Adyen support. \n\nWhen a major cartridge version is no longer under cartridge support, it will be treated as a custom merchant integration. From version 23 onward, we do not provide any level of support for SiteGenesis integrations.\n\n[Migration and Upgrade Guide](https://docs.adyen.com/plugins/salesforce-commerce-cloud/upgrade)\n\n[SFCC Cartridge Support Schedule for SFRA and SiteGenesis](https://docs.adyen.com/plugins/salesforce-commerce-cloud/#support-levels)\n\n## Contributing\nWe strongly encourage you to join us in contributing to this repository so everyone can benefit from:\n* New features and functionality\n* Resolved bug fixes and issues\n* Any general improvements\n\nRead our [**contribution guidelines**](CONTRIBUTING.md) to find out how.\n\n## Platform\n\nRead more information about the [Adyen platform](https://www.adyen.com/platform).\n\n## Licence\n\nMIT license see LICENSE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAdyen%2Fadyen-salesforce-commerce-cloud","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAdyen%2Fadyen-salesforce-commerce-cloud","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAdyen%2Fadyen-salesforce-commerce-cloud/lists"}