Skip to main content

(Classic) Mollie for FinDock

END-OF-LIFE ANNOUNCEMENT

This article describes Mollie integration with version 1 of the Payment API. The Classic Online Experience with Payment API version 1 will be decommissioned at the end of 2024. All Payment API integrations should migrate to version 2, the Enhanced Online Experience, by January 2025.

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.

Multi-merchantMulti-currency
nono
Payment MethodOne-timeRecurringRefunds
Bancontactyesnoyes
Credit Cardyesyesyes
Idealyesnoyes
PayPalyesnoyes
SEPA Direct Debityesyesyes
Sofortyesnoyes

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

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.

note

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":"http://www.success.nl",
"FailureURL":"http://www.fail.nl",
"Payer":{
"Contact":{
"FirstName":"Mollie",
"LastName":"Single CORE",
"Email":"T@Douwstra.com"
},
"AccountUpdate":"Enrich",
"ContactUpdate":"Enrich",
"AllowDeduplication":false,
"PrimaryRelation":"Contact"
},
"Payment":{
"Amount":10
},
"PaymentMethod":{
"Name":"CreditCard",
"Processor" :"PaymentHub-Mollie"
},
"SourceConnector":{
"Name":"PaymentHub"
}
}

Recurring Payment

    {
"SuccessURL":"http://www.success.nl",
"FailureURL":"http://www.fail.nl",
"Payer":{
"Contact":{
"FirstName":"Mollie",
"LastName":"Recurring CORE",
"Email":"T@Douwstra.com"
},
"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"
}
}