Create account
Sign in
Home
Payments
Business operations
Financial services
Developer tools
Security
All products
Home
Payments
Business operations
Home
Payments
Business operations
Financial services
Developer tools
Support
Overview
Quickstart
Stripe CLI
Stripe for Visual Studio Code
Webhooks
File uploads
Error handling
Error codes
API
Keys
Libraries
Upgrades
Rate limits
Card testing
Expanding responses
Domains and IP addresses
Building With Stripe
Stripe's UI libraries
Extensions
Plugins
Building plugins
WordPress
Drupal
Magento
Joomla
Salesforce
Mirakl
Configuration
Installation
Onboarding sellers
Payments
Payouts
Reference
No coding required
Samples
Checklist
HomeDeveloper toolsPluginsMirakl

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 connector to complete the connection.
  6. The payout frequency is set to manual. This triggers a seller account update.
  7. 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 add an onboarding link to the seller’s account page on your website.

To generate a similar link to the one set by the connector in the first step, use the following API request:

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

The response contains the URL:

{ "redirect_url": "https://connect.stripe.com/express/oauth/..." }

Don’t send this link in email—redirect the seller from their secure space on your website.

The rest of the flow matches steps 4 to 7 of the seller account initiation.

Use Custom accounts

  1. Integrate Custom accounts by following our documentation.

Make sure to set settings[payouts][schedule]=manual as required by the payouts workflow.

  1. Use the following API request to map the Stripe account with the Mirakl shop:
Terminal
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, e.g., 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.

In test mode, no emails are sent.

Next steps

  • Integration steps.
Was this page helpful?
Questions? Contact us.
Developer tutorials on YouTube.
You can unsubscribe at any time. Read our privacy policy.
On this page
Seller account initiation
Seller account update
Communication
Next steps