How To: Set up Stripe Connect in Multi-Vendor¶

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.

     

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.

     Note

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

     

   • 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.

   • Sripe Checkout—the setting activates a separate page with a variety of payment options for your customers to choose from on the checkout stage.

     • more then 20 local and familiar payment systems like Apple and Google Pay, Sofort and Klarna, WeChat and Alipay, Przelewy24 and Afterpay, and many more;
     • payment for the order in installments thanks to Klarna and Afterpay;
     • a sense of security among customers about the safety of their personal and financial information when using familiar payment systems;

     Be sure to enable 3-D Secure so that you can activate the stripe checkout.

   • 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.

   

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.

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.

     

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