Salesforce: Get started

Available payment methods

Mollie for Salesforce offers a wide range of payment methods that your customers can use to pay during checkout.

For information on how to select the best payment methods for your business, refer to the Mollie Payment methods guide.

Features

Mollie for Salesforce offers the following features to effectively manage your online payments:

  • Customize the payment experience
  • Localize your payment methods
  • Offer and manage subscriptions
  • Manage orders and payments

Install and connect

Enhance your storefront site's payment options with Mollie.

What you need to do in advance:

  • Create a Mollie account.
  • Ensure that you use SFRA version 6.0.0 (compatibility mode 21.2) or an older release.

πŸ“˜

Note

Mollie for Salesforce does not support SiteGenesis.

Install

  1. Download the Mollie for Salesforce link cartridges 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 nameDescription
mollie_sfra_changesOverwritten SFRA controllers and templates
int_mollie_sfraPayment and checkout controllers and templates
int_mollieBusiness logic for order and payment management

  • Go to Administration > Sites > Manage sites > [store front site] > Settings.
  • Copy the following string into the Cartridges field:
    mollie_sfra_changes:int_mollie_sfra:int_mollie:app_storefront_base
  1. Set up the business manager cartridges.

❗️

Important

Add the business manager cartridges in the order given.

Cartridge nameDescription
bm_mollieA 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_mollieBusiness logic for order and payment management.
app_storefront_baseBusiness logic for custom actions↗ related to the maintenance of a particular order in the Salesforce Commerce Cloud Customer Service Center.

  • Go to Administration > Sites > Manage sites and select Business manager to access the business manager settings
  • Copy the following string into the Cartridges field:
    bm_mollie:int_mollie:app_storefront_base
  1. 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.
    • 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].
    • Archive the changed contents to create a new metadata/metadata.zip file.
    • Log in to Salesforce Commerce Cloud Business Manager.
    • Go to Administration > Operations > Import & Export.
    • Under Import & Export Files, select Upload.
    • Choose metadata/metadata.zip.
    • Select Upload.
  2. Configure Mollie service credentials.
    • 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
    • For each service, select Mollie in the Credentials column.
    • Enter your Mollie API credentials.
    • Select Apply.

Connect

Mollie gives you two API keys to authenticate your requests:

  • Test key: Use this key when setting up and testing Mollie.
  • Live key: Use this key after Mollie has approved your account and you are ready to accept live payments.

To connect with Mollie, follow these steps:

  1. Log in to your Mollie Dashboard.
  2. Select the organization from the menu in the top-left corner of the dashboard's home page.

❗️

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.

  1. Go to More > Developers > API keys and copy them.
  2. Go to Settings > Website profiles.
  3. Copy the name of the website. This is your Mollie profile ID.
  4. Log in to Salesforce Commerce Cloud Business Manager.
  5. Open Select a site, and select a site from the list.
  6. Go to Merchant Tools > Mollie > Mollie General Settings.
  7. Select the Test or Live environment.
    We recommend enabling test mode until you are sure that everything works as you expect.
  8. Paste the API keys into their respective fields.
  9. Paste the Mollie profile ID into the Profile ID field.
  10. Save the changes.