1. Mollie Support
  2. Connect Mollie to a website
  3. Pre-built integrations
  4. Mollie for Salesforce
  5. Salesforce: Get started

Salesforce: Install and connect

Enhance your storefront site's payment options by installing Mollie for Salesforce and connecting to Mollie.

What you need to do in advance

Install

  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 select 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, select Upload

    6. Choose metadata/metadata.zip.

    7. Select Upload.

  7. Configure Mollie service credentials.

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

    2. Enter your Mollie API credentials.

    3. Select Apply.

Connect

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. If your organization isn't already chosen, select it from the drop-down menu in the top-left corner of the dashboard's home page, next to the ID.

    Important

    To comply with UK regulations, UK-based merchants must select a UK-registered organisation to ensure use of the correct API keys.

  3. Go to Developers > API keys.

  4. Copy the API keys.

  5. Go to Settings > Website profiles.

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

  7. Log in to Salesforce Commerce Cloud Business Manager.

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

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

  10. Select the Test or Live environment.

  11. Paste the API keys into their respective fields.

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

  13. Save the changes.