Ingenico Connect based Shopping Cart Extension for Salesforce Commerce Cloud
This extension can also be found on the Salesforce Commerce Cloud marketplace athttps://www.demandware.com/link-marketplace/ingenico-epayment-globalcollect-platform.
For detailed documentation including screenshots please see https://github.com/Ingenico-ePayments/connect-extension-salesforce-commerce-cloud/tree/master/documentation.
The below instructions cover the basic steps required to get the Ingenico Salesforce Cloud Commerce SDK with the reference implementation for Site Genesis installed on a sandbox.
The details required from Ingenico’s Configuration Center are:
- Merchant IDs
- API key ID
- API Secret key
- Webhook key
- Webhooks Secret key
- Import Site Genesis Demo site
Navigate to Administration > Site Development > Site Import & Export, select SiteGenesis Demo Site and click import and confirm.
- Upload SDK customisation
Navigate to Administration > Site Development > Site Import & Export, choose the file to upload site_import.zip located in the metadata folder. After upload completes, select site_import.zip from the list and click import and confirm.
- Upload SDK cartridges
The three cartridges that need to be uploaded into the sandbox are:
- int_ingenico
- int_ingenico_feature
- bm_ingenico
The code can be uploaded using WebDav on https://SANDBOX_URL/on/demandware.servlet/webdav/Sites/Cartridges and in the relevant version. If the version chosen is not the active one, it needs to be activated before it can be used. Activation is done through the Code Deployment screen found in Administration > Site Development > Code Deployment.
- Update cartridge path
Prepend “int_ingenico_feature:int_ingenico:” to Cartridges path on Administration > Sites > Manage Sites > SiteGenesis - Settings and Administration > Sites > Manage Sites > SiteGenesisGlobal - Settings. This will make sure that the plugin code will be used by the two sites in SiteGenesis.
The path once prepended should look like below in all lowercase.
int_ingenico_feature:int_ingenico:sitegenesis_storefront_controllers:sitegenesis_storefront_core
The business manager path in Administration > Sites > Manage Sites > Business Manager - Settings also needs changing to include the business manager plugin as below.
bm_ingenico:int_ingenico:int_ingenico_feature:sitegenesis_storefront_core
- Set API site preferences
Select a website from the list on the top left to add the API details in the site custom preferences. Once selected, navigate to Merchant Tools > Site Preferences > Custom Site Preference Groups > Ingenico API Credentials and fill in all the relevant fields, select the platform (GlobalCollect - WW only or Ogone - EU only) and the environment.
When using webhooks to get status updates, the URL used to receive the updates is specific to each site and account. The format of the URL is as shown below.
https:/**DOMAIN**/ on/demandware.store/Sites-**SITENAME**-Site/**LANGUAGE**/Ingenico-Feedback
The DOMAIN is the one that links to the instance (sandbox, staging or production). SITENAME refers to the name as shown in Business Manager for each site. LANGUAGE is one of the locals that are allowed on the specific site as defined in Merchant Tools > Site Preferences > Locales.
NOTE: Both endpoints (WW and EU) will automatically failover to a second datacenter in case the main datacenter isn't available.
NOTE: There is a one to one mapping between webhook URL, Ingenico account, Demandware site and orders. Orders placed in one site, need to receive the update on the specific URL for that site.
- Update role permissions
In order to manage the pending, a role needs to be given the permission Orders (Action pending) to do so. The instructions below explain how to give the permission to the Admin role. Navigate to Administration > Organization > Roles > Administrator - Business Manager Modules. When selecting the Business Manager module, select all sites from the pop-up window that will appear.
Scroll until the Orders section where you will find Orders (Action pending). Tick the box and save the settings.