How To: Set up Stripe Connect in Multi-Vendor


The Stripe Connect Payments add-on is available only in Multi-Vendor.

Stripe Connect allows maketplace owners to offer credit card payments via Stripe and automatically distribute money from orders between vendors.

Step 1. Configure the Payment Method

  1. Install and configure the Stripe Connect Payments add-on.

  2. Go to Administration → Payment methods and click the + button in the top right corner to add a payment method.

  3. A new pop-up window with the payment method creation form will open. Fill in the fields on the General tab:

    • Name—the name the new payment method. That’s the name that the customers will see at checkout.

    • Processor—the online payment processor that will handle the transactions. Choose Stripe Connect from the drop-down menu.

    • If necessary, specify the data in other fields as you see fit.

      The General tab of the Stripe Connect payment method.
  4. Switch to the Configure tab. It contains the settings specific to Stripe Connect:

    • Client ID—the live client ID of your Stripe account.

    • Publishable key—the publishable API key of your Stripe account.

    • Secret key—the secret API key of your Stripe account.

    • Redirect URIs—the values that you must copy to the corresponding fields on the Stripe dashboard.


      Learn more about how to get client ID and API keys for Stripe Connect and how to use Redirect URIs in a separate article.

      The Configure tab of the Stripe Connect payment method.
    • Currency—select the currency of your Stripe account. It should match the primary currency of your store—that way the calculations will be more precise.

    • Enable 3-D Secure—the setting defines whether money will first go to the marketplace owner instead of going straight to vendors. Money will be automatically distributed between connected Stripe accounts via transfers later.

    • Allow Express accounts—the setting allows vendors to register Stripe Express accounts. Express accounts support faster registration and simpler Stripe dashboard. But when you use Express accounts, your marketplace bears more responsibility, and there are platform fees involved.

      • To check the statuses of the Express accounts that your vendors create, add a special command to cron.

        php /path/to/cart/admin.php --dispatch=stripe_connect.check_accounts
    • Delay transfer of funds—delay sending money to vendors. Configure manual or automatic disbursements to vendors. The setting works if 3-D Secure was enabled.

      • To schedule automatic periodic disbursements, add a special command to cron. Set the desired value of the “–days” parameter. Money will be automatically transfered to vendors for orders that are older than this value.

        php /path/to/cart/admin.php --dispatch=stripe_connect.transfer_funds_by_cron --payment_id=14 --days=14
      • To tranfer money to the vendor for the current order manually, click the Transfer funds to vendors button on the order page. After clicking this button, the note will inform you if Funds have been transferred successfully or not.

  5. Once you have configured the payment method, click Create.

    The Configure tab of the Stripe Connect payment method.

Step 2. Have Your Vendors Connect Their Accounts

Once you set up a Stripe Connect payment method, your vendors will be able to connect their accounts, so that they can use the Stripe Connect payment method that you have created. The payment method will be offered to customers only if all the vendors in the order have connected their accounts.


The Connect with Stripe button will appear only to vendors’ administrators or those marketplace administrators who log in as a vendor.

Here is the instruction for a vendor:

  1. Open the vendor’s administration panel and go to Seller info in the upper left menu.

  2. The vendor editing page will open. Scroll down, then you’ll see one of two posssible variants of connecting with Stripe. Any of these actions will take you to the Stripe page where you’ll be able to register an account or connect an existing one.

    • If Express accounts were allowed on the Step 1 then you’ll be able to Connect a Stripe Express account. If you already have a Stipe Standart account, click the appropriate button.

      The "Connect a Stripe Express account" button.
    • If Express accounts weren’t allowed on the Step 1 then you’ll be able to Connect with Stripe Standard.

      The "Connect with Stripe Standard" button.