Salesforce: Set up order management

Select an API method

Select the appropriate API method for your payment processing goals: Mollie's Payments API for simple payments or its Orders API for detailed orders.

You can set a default API method, or one for each individual payment method.

πŸ“˜

Note

  • Individual settings override the default setting.
  • You cannot select an API method either as a default or individually for these payment methods, which only use the Orders API:
    • Klarna payment methods
    • iDEAL in3
    • Vouchers

Select the default API method

  1. Log in to Salesforce Commerce Cloud Business Manager.
  2. Open Select a site, and select a site from the list.
  3. Go to Merchant Tools > Mollie > Mollie General Settings.
  4. Select an API method from the Default method menu.
  5. Save the changes.

Select individual payment method's API method

  1. Log in to Salesforce Commerce Cloud Business Manager.
  2. Open Select a site, and select a site from the list.
  3. Go to Merchant Tools > Ordering > Payment methods.
  4. Select the payment method's ID.
  5. Scroll down to the Mollie section and select an API method from the Method drop-down menu.
  6. Save the changes.

Change the order expiry period

Customize the order expiry period as needed, for example, to allow customers more time to pay for their orders.

πŸ“˜

Note

By default, customers have 50 days to pay for their orders.

You can only change the order expiry period for the following payment methods if you are using the Orders API:

  • iDEAL in3
  • Klarna
  • Vouchers

Change the default order expiry period

  1. Log in to Salesforce Commerce Cloud Business Manager.
  2. Open Select a site, and select a site from the list.
  3. Go to Merchant Tools > Mollie > Mollie General Settings.
  4. Save the changes.
  5. Select a period from the Default order expiry days drop-down menu.
  6. Save the changes.

Change an individual payment method's order expiry period

Individual order expiry period settings override the default settings.

  1. Log in to Salesforce Commerce Cloud Business Manager.
  2. Open Select a site, and select a site from the list.
  3. Go to Merchant Tools > Ordering > Payment methods.
  4. Select the payment method's ID.
  5. Scroll down to the Mollie section and select a period from the Order expiry days drop-down menu.
  6. Select Apply.

Customize payment descriptions

Include order details such as order number and customer name in the payment descriptions that appear in your Mollie Dashboard.

All payments are listed on the Payments page of your Mollie Dashboard. A payment's description is displayed in its Details column. It can also appear on your customers' bank statements depending on the payment method used and the customer's bank.

By default, the payment description includes the Salesforce Commerce Cloud, Salesforce Commerce Cloud order ID, Mollie order status, API method used, and refund status.

πŸ“˜

Note

You can only change the payment description for payment methods that use the Payments API.

You can combine free text and the following variables:

NameDescription
orderNumberThe Salesforce Commerce Cloud order number (dw.order.Order.orderNo)
storeNameThe name of the site listed in Salesforce Business Manager under Administration > Sites > Manage Sites
order.referenceThe customer order reference (dw.order.Order.customerOrderReference)
customer.firstnameThe billing address first name (dw.order.OrderAddress.firstName)
customer.lastnameThe billing address last name (dw.order.OrderAddress.lastName)
customer.companyThe billing address company (dw.order.OrderAddress.companyName)

To change the payment description, follow these steps:

  1. Log in to Salesforce Commerce Cloud Business Manager.
  2. Open Select a site, and select a site from the list.
  3. Go to Merchant Tools > Ordering > Payment methods.
  4. Select the payment method's ID.
  5. Select HTML editor under the Description field.
  6. In the editor, combine free text and the variables to create a description.
  7. Select Apply.

πŸ“˜

Example

To render 'Casey Doe bought order #123456 at MegaProducts.com', combine the following text and variables:
{customer.firstname} {customer.lastname} bought order #{orderNumber} at {customer.company}

Once an order has been paid for, you can find the description in Salesforce Business Manager under Merchant Tools > Ordering > Orders > [order number] > Payment > Mollie payment description.

Enable recovery from update failures

To trigger payment and order status updates, Mollie sends webhook notifications to the Mollie for Salesforce plugin. These notifications are saved in Salesforce Commerce Cloud so that you can check whether any webhooks have failed.

If Mollie can’t send a webhook, Mollie for Salesforce runs the Mollie-FailExpiredOrders job to retrieve status updates. The job requests updates for orders with the Created status from Mollie. It also updates the orders accordingly.

  1. Ensure that the job's flow scope↗ includes your storefront site.
  2. Configure the job's waiting time and automatic starts under Administration > Operations > Jobs > Mollie-FailExpiredOrders > Job steps > FailExpiredOrders.
    • Specify the minimum number of hours the job has to wait before requesting status updates in the expireAfterHours parameter.
      Default: 24 hours.
    • Specify your automatic restart preference with the isDisabled checkbox.
      Default: Disabled.