Salesforce Commerce Cloud: Install and connect Mollie for Salesforce

Install Mollie for Salesforce and connect it to your Mollie account to offer your customers a wide variety of payment methods in your storefront site.

What you need to do in advance

• Create a Mollie account

• Make sure you are running SFRA version 6.0.0 or earlier (compatibility mode 21.2)

  Note

  Mollie for Salesforce does not support SiteGenesis.

• In Salesforce Business Manager:

  • Make sure that you have created customer groups↗.

  • Make sure that you have configured supported shipping countries↗.

  • Make sure that you have configured allowed currencies↗.

• Install NPM and node

Install Mollie for Salesforce

1. Download the Mollie for Salesforce link catridges from its GitHub repo.

2. In your IDE, upload the link cartridges using a Salesforce extension.

3. Log into Salesforce Business Manager.

4. Set up the store front cartridges.

   Important

   Add the store front cartridges before the business manager cartridges, and in the order given.

   Cartridge name	Description
   mollie_sfra_changes	Overwritten SFRA controllers and templates
   int_mollie_sfra	Payment and checkout controllers and templates
   int_mollie	Business logic for order and payment management

   1. Go to Administration > Sites > Manage sites > [store front site] > Settings.

   2. Copy the following string into the Cartridges field:

      mollie_sfra_changes:int_mollie_sfra:int_mollie:app_storefront_base

5. Set up the business manager cartridges.

   Important

   Add the business manager cartridges in the order given.

   Cartridge name	Description
   bm_mollie	A job that fails orders that have not been completed within the configured period (default: 24 hours). Business logic for custom actions↗ related to the maintenance of a particular order in the Salesforce Commerce Cloud Customer Service Center.
   int_mollie	Business logic for order and payment management
   app_storefront_base	Business logic for custom actions↗ related to the maintenance of a particular order in the Salesforce Commerce Cloud Customer Service Center.

   1. Go to Administration > Sites > Manage sites and click Business manager to access the business manager settings

   2. Copy the following string into the Cartridges field:

      bm_mollie:int_mollie:app_storefront_base

6. Import the Mollie metadata.

   The Mollie project in your IDE includes a metadata folder with jobs, custom attributes, services, payment processors and payment methods that you need to upload to Salesforce.

   1. Extract metadata/metadata.zip and make the following changes, where [site_name] is the name of your store front site:

      • Change the name of the sites/RefArch directory to sites/[site_name]

      • In the access-roles.xml file's resource-path parameter, replace RefArch with [site_name].

      • In jobs.xml file's site-id parameter, replace RefArch with [site_name].

   2. Archive the changed contents to create a new metadata/metadata.zip file.

   3. Log in to Salesforce Commerce Cloud Business Manager.

   4. Go to Administration > Operations > Import & Export.

   5. Under Import & Export Files click Upload

   6. Choose metadata/metadata.zip.

   7. Click Upload.

7. Configure Mollie service credentials.

   1. Go to Administration > Operations > Services and click Mollie in the Credentials column of one of the services.

   2. Enter your Mollie API credentials.

   3. Select Apply.

Connect to Mollie

Mollie provides you with two API keys to authenticate requests from your storefront site:

• Your test key is available after you set up your Mollie account. Use this key to connect and set up the plugin. You can also use it to test your payment methods and payment statuses.

• Your live key is available after Mollie has approved your account. You can use this key to run your storefront site in live mode and accept real payments.

Use these API keys to connect to Mollie after installing the plugin.

1. Log in to your Mollie Dashboard.

2. Go to Developers > API keys.

3. Copy your API keys.

4. Go to Settings > Website profiles.

5. Copy the name of the website. This is your Mollie profile ID.

6. Log in to Salesforce Commerce Cloud Business Manager.

7. Open Select a site, and select a site from the list.

8. Go to Merchant Tools > Mollie > Mollie General Settings.

9. Select the Test or Live environment.

10. Paste the API keys into their respective fields.

11. Paste the Mollie profile ID into the Profile ID field.

12. Select Save.