Mirakl: Installation guide

If you want to get started with the Mollie Mirakl Marketplace connector or would like to receive more information you can reach out to our marketplaces team via [email protected]. Instructions to configure your Mollie and Mirakl account can be found below.

To start processing payments on your Marketplace using Mollie for Mirakl Connector, you need to configure features both on Mirakl's and Mollie's side.

📘

As some settings will need to be configured manually in the Connector's back-end, it is important to stay in contact with your Mollie Marketplace consultant.

Mirakl

To get started, you need to have a fully onboarded Mirakl Operator account and an eCommerce platform set up.
Contact your Mirakl Solution Consultant to ensure everything is configured properly.

Mollie

To get started, you need to have a fully onboarded Mollie Marketplace account.
If you already have an existing Mollie account for other sales, we recommend creating a new Organization for Marketplace operations.
Additionally, you need to create an app for Seller onboarding by following the steps below:

1. Create a Mollie account & submit the details
   • Create a Mollie account here or login to your existing Mollie account and follow the onboarding steps on the Get started screen (for guidance, refer to our How do I create an account article).
     Once you submit all the details, Mollie will review the account. On average this takes 2-3 business days and all updates will be provided via email.
   • Share the Mollie org_id with your Mollie contact person so that they can configure the correct Marketplace settings for your account.
2. Create a Seller Onboarding app
   • Within the Mollie dashboard go to Developers > Your Apps.
   • Review and sign the Developers contract.
   • The Mollie Marketplace team will provide you with the redirect URL.

Operator Organization settings

The Mollie Marketplace team will ensure all the right marketplace settings are enabled on your Mollie operator account.

Configuring the Connector

The Mollie Marketplace team needs the following properties provided for each tenant to correctly configure your Connector settings:

• mirakl-host: the URL of the Mirakl environment.
• mirakl-operator-key: the operator key of the Mirakl environment *.
• mollie-access-token: the Organization access token of the Mollie Marketplace account * **.
• mollie-client-id: the client ID of the OAuth2 application *.
• mollie-client-secret: the client secret of the OAuth2 application *.
• mollie-host (optional): the URL of the Mollie environment (if not defined, the default value is https://api.mollie.com).
• mollie-orgId: the operator Mollie Organization's ID.
• mollie-profile-id: the profile ID of the Operator account.
• operator-iban: the IBAN of the operator.

* - Mollie's Marketplaces team will provide a private and secure secret-sharing mechanism.

** - The following scopes are required:

• balances-read
• clients.write
• customers.read
• customers.write
• mandates.read
• mandates.write
• onboarding.read
• organizations.read
• organizations.write
• payments.read
• payments.write
• refunds.read
• refunds.write