Salesforce: Install and connect

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. If the Mollie metadata was imported correctly, you should see these services:

      • Mollie.CancelOrder

      • Mollie.CancelOrderLineItem

      • Mollie.CancelPayment

      • Mollie.CreateCustomer

      • Mollie.CreateOrder

      • Mollie.CreateOrderRefund

      • Mollie.CreatePayment

      • Mollie.CreatePaymentRefund

      • Mollie.Create Shipment

      • Mollie.GetMethod

      • Mollie.GetMethods

      • Mollie.GetOrder

      • Mollie.GetPayment

      • Mollie.ValidateMerchant.

    2. For each service, select Mollie in the Credentials column.

    3. Enter your Mollie API credentials.

    4. Select Apply.

Connect

  1. Log in to your Mollie Dashboard.

  2. Important

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

  3. Go to More > Developers > API keys.

  4. Copy the API keys.

  5. Go to Organization settings > 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.

    We recommend enabling test mode until you are sure that everything works as you expect.

  11. Paste the API keys into their respective fields.

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

  13. Save the changes.