Skip to main content

(Classic) Mollie for FinDock


This article describes an integration with the v1 of the API. Ongoing development on this version has stopped. Please use our new and improved API v2!

Mollie is an internationally active payment service provider supporting a range of regions and payment methods. The Mollie for FinDock package provides integration with the Mollie service and supports a multitude of payment methods. Be aware that your contract with Mollie needs to support the payment methods you wish to activate.

Payment MethodOne-timeRecurringRefunds
Credit Cardyesyesyes
SEPA Direct Debityesyesyes

Install and activate Mollie payment extension#

Follow the standard procedure for installing and activating the Mollie for Findock payment extension.

Configure callbacks#

To receive callbacks from Mollie, you need to configure a Salesforce site to receive these callback messages.

To configure callbacks:

  1. If you haven’t already, configure a base site as explained in Configuring a Salesforce site.
  2. For this site, assign the following permission sets to the site guest user:
    • Mollie integration user
    • Mollie ALL FLS
  3. If you are using FinDock with Converse as a source, please make sure the site guest user has access to the Converse object Agreements.
  4. Add the following pages to the site’s Visualforce pages:
    • moph.Callback
    • moph.Redirect
    • moph.Webhook

Link your account#

Once the callbacks and related permissions are configured, you can link your Mollie account to the extension. To link your Mollie account to the extension:

  1. Launch the FinDock app and click the Setup tab.
  2. Scroll to the Payment Extensions section and click on the Mollie for FinDock tile. 1.-mollie-config-1024x655
  3. In your Mollie dashboard, navigate to Developers > API-keys. 2.-mollie-screen-1024x661
  4. Copy the test and production API keys from your Mollie dashboard to the Mollie Payment Extension setup.
  5. Add as the Public URL the callback site URL you configured earlier.
  6. Ensure you have also enabled test mode in Mollie if your account is approved for production.
  7. Unapproved accounts have test mode available by default, but approved accounts can disable test mode. When the Mollie extension is set to Is test, FinDock only uses the test credentials.

Payment API messages#

The following are example messages for single and recurrent payments using the Payment API.


When initiating payments through the API, additional processor-specific parameters can and/or need to be included for a particular payment method. You can check these parameters by calling the /PaymentMethods or /PaymentProcessors endpoints. For more information, please check out our API Reference Guide.

Single payment#

    {    "SuccessURL":"",    "FailureURL":"",    "Payer":{            "Contact":{                "FirstName":"Mollie",                "LastName":"Single CORE",                "Email":""            },            "AccountUpdate":"Enrich",            "ContactUpdate":"Enrich",            "AllowDeduplication":false,            "PrimaryRelation":"Contact"        },        "Payment":{            "Amount":10        },        "PaymentMethod":{            "Name":"CreditCard",        "Processor" :"PaymentHub-Mollie"        },        "SourceConnector":{            "Name":"PaymentHub"        }    }

Recurring Payment#

    {    "SuccessURL":"",    "FailureURL":"",    "Payer":{            "Contact":{                "FirstName":"Mollie",                "LastName":"Recurring CORE",                "Email":""            },            "Account":{                "Name":"Famylje Douwstra"            },            "AccountUpdate":"Enrich",            "ContactUpdate":"Enrich",            "AllowDeduplication":false,            "PrimaryRelation":"Contact"        },        "Recurring":{            "Amount": 10.15,            "Frequency":"Monthly",            "StartDate":"2017-11-01"        },        "Payment":{            "Amount":10        },        "PaymentMethod":{            "Name":"CreditCard",            "Processor":"PaymentHub-Mollie"        },        "SourceConnector":{            "Name":"PaymentHub"        }    }