Configure the Mirkal app

Define your integration variables.

Before you install the Mirakl app, prepare a file with the variables outlined in this guide. To get started, you can copy our sample configuration file and rename to .env.

General settings

Configure the app’s general settings:

Parameter	Description
`the related setting`	To be generated. Commonly used to add more entropy to security related operations. Learn more on the Symfony documentation.
`the related setting`	To be generated. Used to secure requests to the API exposed by the plugin. Set the `X-AUTH-TOKEN` header to this value when calling the API.
`the related setting`	The connection URL to your database. Learn more on the Doctrine documentation. For example, `pgsql://symfony:symfony@db:5432/symfony?charset=UTF-8`.
`the related setting`	The transport used for the queuing system. See the Symfony Messenger documentation for supported transports. For example, `amqp://guest:guest@localhost:5672/%2f/messages`. Defaults to `doctrine://default`.
`the related setting`	Your Stripe API secret key available in your API keys settings. We recommend creating a specific API key for the plugin. Restricted keys aren’t supported.
`the related setting`	Host name of your Mirakl Instance. For example, `https://mymarketplace.mirakl.net`.
`the related setting`	The Mirakl operator key. Can be generated as a Mirakl operator in your API settings. We recommend creating a specific operator for the plugin.

Onboarding

Configure the app’s onboarding settings:

Parameter	Description
`the related setting`	The plugin redirects the seller to this URL after completing their account creation on Stripe. Defaults to `$the relevant part of the product`.
`the related setting`	The domain of the server hosting your plugin. For example, `stripe-mirakl.example.com`.
`the related setting`	The scheme used by your base host. Defaults to `https`.
`the related setting`	Your Stripe webhook secret available in your Connect webhook settings when adding the endpoint. See Add a Stripe webhook endpoint for connected accounts for details.
`the related setting`	Code of the custom field that you have to add, see below. Defaults to `stripe-url`.

Add a Stripe webhook endpoint for connected accounts

Go to your webhook settings.
Add a webhook endpoint by clicking the Add destination button.
Select Connected accounts from the Events from options and select account.updated from the list of available events. Enter your desired Stripe API version. Click Continue.
Select Webhook endpoint from the list of available destination types. Click Continue.
Set the endpoint URL to <the related setting>/the relevant part of the product and fill out the remaining fields as desired.
Click Create destination.
Use the webhook secret for the the related setting environment variable.

Add a custom field to your Mirakl shops

Log in to your Mirakl back office as an Operator.
Visit Settings > Advanced Parameters > Shops.
Go to Custom Fields.
Create a new field using the following values:

Parameter	Description
Code	Use `stripe-url` unless you chose a different key in your environment file.
Type	`Link`
Shops permissions	`Read only`
Required field	`No`

Payments

Configure the app’s payment settings:

Parameter	Description
`the related setting`	Metadata key used in Charges to convey the Mirakl commercial order ID. Defaults to `mirakl_commercial_order_id`.
`the related setting`	Enable the payment split workflow for product orders. Defaults to `false`.
`the related setting`	Enable the payment split workflow for service orders. Defaults to `false`.
`the related setting`	Enable the payment refund workflow for product orders. Defaults to `false`.
`the related setting`	Enable the payment refund workflow for service orders. Defaults to `false`.
`the related setting`	Your Stripe webhook secret is available in your account event destination details page when adding the endpoint. See Add a Stripe webhook endpoint for your account for details.

Add a Stripe webhook endpoint for your account

Go to your webhook settings.
Add a webhook endpoint by clicking the Add destination button.
Select Your account from the Events from options and select charge.succeeded and charge.updated from the list of available events. Enter your desired Stripe API version. Click Continue.
Select Webhook endpoint from the list of available destination types. Click Continue.
Set the endpoint URL to <the related setting>/the relevant part of the product and fill out the remaining fields as desired.
Click Create destination.
Use the webhook secret for the the related setting environment variable.

Notifications and alerting

Configure the app’s notifications and alerting settings:

Parameter	Description
`the related setting`	The entire Symfony Mailer configuration using a DSN-like URL format. Learn more on the Symfony documentation. For example, `smtp://user:pass@host:port`. Defaults to `smtp://null` (mailer disabled).
`the related setting`	The recipicient of all technical alerts. For example, ``. Defaults to empty. Required if mailer is enabled per `the related setting`.
`the related setting`	The sender of all technical emails. Defaults to empty, required if mailer is configured. For example, ``.
`the related setting`	The endpoint on your server set to receive notifications from the plugin. Defaults to empty (notifications disabled).
`the related setting`	Enable email alerts if a URL is provided in `the related setting` and that URL isn’t available or responds with an error. Defaults to `true`.
`the related setting`	Time between each email alert. Use `0` to disable throttling. The maximum value depends on the notification worker maximum life, that is, `3600` by default. Defaults to `10`.