Mollie

Mollie is an internationally active payment service provider supporting a wide range of payment methods. The Mollie for FinDock package provides integration with the Mollie service and supports many Mollie payment methods.

Please note that your contract with Mollie needs to support the payment methods you activate.

Pre-requisites

• FinDock is installed and configured.
• A source connector is installed and configured.
• FinDock WebHub is connected and Notification Gateway configured.

Install and activate Mollie payment extension

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

Check and assign the required permissions. If you are using custom permission set groups, ensure the package-specific permission sets are assigned.

Configure Mollie payment extension

After you have installed and activated the Mollie extension, you need to activate the remote site endpoint for Mollie and then link the extension to your Mollie account.

To configure the Mollie extension:

1. Launch the FinDock app and click the Setup tab.
2. A red mark on the Remote Site Settings tab indicates that the remote site endpoints for Mollie are disabled.
3. Click the Remote Site Settings tab and click the toggle in the STATUS column for MollieEndpoint to activate it.
4. Click the Setup tab.
5. Scroll to the Payment Extensions section and click on the Mollie (PaymentHub-Mollie) tile.
6. In a separate browser tab, log in to your Mollie account dashboard, and navigate to Developers > API-keys.
   
7. Copy the test and production API keys from your Mollie dashboard to the corresponding fields in the Mollie extension settings.
   
8. Ensure you have also enabled test mode in Mollie if your account is approved for production.
9. 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.
10. Click Save.

SEPA Direct Debit options with Mollie

If you use Mollie for SEPA Direct Debit payments, ensure the FinDock Core mandate service is set to automatically create mandates.

For direct debit payments created through the Payment API, including PayLinks and Giving Pages, FinDock creates mandates based on the mandate service settings. Upon creation, the mandates get the status Pending registration. There is no mandate reference at this point, nor is the mandate activate.

The Core mandate service automatically checks for mandates with Pending registration status sends messages asynchronously to Mollie to register the new mandates. When this process is completed, the mandate status changes to Success, the Active checkbox is marked, and the Reference field contain a Mollie-generated reference value.

Once the mandate is active, installments are collected through payment schedule as normal.

If a SEPA Direct Debit payment is created by a Salesforce user, you only need to create the recurring payment and payment profile.

To manually create Salesforce records for new SEPA Direct Debit payments:

1. Create a payment profile for the payer with record type IBAN.
2. Fill in the required fields for the payer's bank account.
3. Create a new recurring payment and link it to the payment profile.
4. Wait for FinDock to create and register the mandate.
5. Once the mandate is active, run payment schedules to collect installments.

If you are creating Salesforce records for a migration that includes existing mandates, be sure to set the migrated mandates to active with status Success. The existing Mollie Mandate Id also needs to be added to the Reference field.

Mandates that should no longer be used for collection can be deactivated by emptying the Active checkbox on the record. This can be done manually for each Mandate record or automated through Salesforce tooling.

Payment API messages

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

Single payment

{
    "SuccessURL": "https://www.example.com/success",
    "FailureURL": "https://www.example.com/error",
    "Payer": {
        "Contact": {
            "SalesforceFields": {
                "FirstName": "Eric",
                "LastName": "Johnson",
                "Email": "eric@johnson.com"
            }
        }
    },
    "OneTime": {
        "Amount": "36"
    },
    "PaymentMethod": {
        "Name": "Ideal",
        "Processor": "PaymentHub-Mollie"
    },
    "Settings": {
        "SourceConnector": "PaymentHub"
    }
}

Recurring Payment

{
    "SuccessURL": "https://www.example.com/success",
    "FailureURL": "https://www.example.com/error",
    "WebhookURL" : "https://webhook.site/9b9e84ca-1026-434e-a4a0-0d9f93a29587",
    "Payer": {
        "Contact": {
            "SalesforceFields": {
                "FirstName": "Eric",
                "LastName": "Johnson",
                "Email": "eric@johnson.com"

            }
        }
    },
    "OneTime": {
        "Amount": "25"
    },
     "Recurring": {
          "Amount": "25",
          "Frequency": "Monthly",
          "StartDate": "2021-04-01"
     },
    "PaymentMethod": {
        "Name": "CreditCard",
        "Processor": "PaymentHub-Mollie"
    },
    "Settings": {
        "SourceConnector": "PaymentHub"
    }
}