Onboarding sellers

You can use Express or Custom accounts with the transfers capability to onboard your sellers.

Standard accounts aren’t supported.

Seller account initiation

The workflow starts when you create a new shop. If you invite the seller via email, the workflow starts when they submit the initial Mirakl form.

1. The onboarding job fetches newly created Mirakl shops.
2. The connector adds an onboarding link to each shop.
3. The seller finds the link in their Mirakl back office under My Account.
4. They complete their KYC/KYB on Stripe.
5. The seller is redirected to the REDIRECT_ONBOARDING URL.

Stripe then performs verification, asking for more information when needed. To handle this, see the communication guidelines.

Initiate the onboarding outside of Mirakl

You can build your own onboarding flow and then use the following API request to map the Stripe account with the Mirakl shop:

curl \
	-X POST "https://connector-url/api/mappings" \
	-H "accept: application/json" \
	-H "X-AUTH-TOKEN: 
$OPERATOR_PASSWORD
" \
	-H "Content-Type: application/json" \
	-d "{ \"miraklShopId\": 123, \"stripeUserId\": \"acct_1032D82eZvKYlo2C\"}"

Seller account update

The workflow starts with the seller intending to update their information on Stripe.

1. The seller finds the link in their Mirakl back office under My Account.
2. They update their information on Stripe.
3. The shop custom field is updated with a fresh login link to their Express dashboard.
4. The KYC status is updated on Mirakl.

The last two steps are also performed when accounts are updated by the connector during the account initiation workflow or when accounts are updated by Stripe, for example, a new document needs to be provided. You can receive a notification when that happens, see the Account updated notification.

Stripe then performs verification, asking for more information when needed. To handle this, see the communication guidelines.

Communication

You can customize the visual appearance of the Stripe form with your brand’s name, color, and icon in your Connect settings page.

Be sure to tell your sellers about the link available in their Mirakl account settings and the need to complete the onboarding on Stripe to receive their payouts. For example, you could customize some of the email templates sent to your sellers by Mirakl under Settings > Notifications.

If we require more information from your sellers, we’ll email them directly for Express accounts. You must inform the sellers yourself if you decided to use Custom accounts.