Multi Vendor Marketplace for Shopify: Stripe Connect Integration

We have launched Stripe Connect payment gateway in Multivendor Marketplace app for Shopify where now after the customer pays the amount for the order, the amount will go to respective Seller and Admin account directly as per the share configured on the basis of commission.

Both admin & seller needs to have their respective Stripe accounts.

This feature is available at a cost of USD 10 per month over and above your monthly plan. And you can use marketplace shipping or any other shipping of your store with this feature.

NOTE: If you as Store Owner sell products, then you have to become Seller to get Payment through Stripe Connect.

Stripe Payment Method works in the case of Gift Cards. But the whole payment will be received by the admin and will not get auto-split between vendors & admin. The admin then further needs to transfer the vendor’s share separately.

– This will not work in the case of Custom Product & Gift Card Product.

POINT TO REMEMBER

If customers are applying a discount code on the orders, then all the order amount will be sent to the Admin Stripe Account. And then Admin will be responsible for sending the seller earning to his account.

NOTE:- If you are using the older version of Stripe API (before 2019-08-14), make sure to upgrade it to the latest version.

Minimum & Maximum Charge Amount

The minimum amount you can charge 0.5$ and maximum up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99). Learn more.

Once you will click on the “Enable” button, you need to agree on additional charges which are USD 10 per month.

Now, let’s understand its workflow:-

Also, you need to choose the Stripe account type of your sellers while configuring the Stripe details in the app. Select the account type whether Standard or Express that the seller is using with Stripe. Know more about the Stripe accounts.

NOTE:- You can’t change the account type to Express if the seller is already connected to the Standard Stripe account and vice versa.

Additionally, enter the details like Secret key, Publish Key and Client ID and then click on save.

You need to log in to your Stripe Account to get the above keys.

“Secret key” and “Publish key” you will get from the “API” section of your Stripe account.

“Client ID” you will get from “settings > Connect Settings” of your Stripe account.

Copy the client ID:

Now, to connect seller’s Stripe account to your stripe account copy the code from “instruction for marketplace” section of configuration menu in the app and paste into the “Redirect URI” section of your Stripe account and make this default as shown in the following screenshot:-

Admin end>> Configuration >> Instruction for marketplace >> Visit “Stripe connect” section>> Copy the given code to connect seller’s Stripe account to your Stripe account.

Now open your “Stripe account” and paste the code in the “Redirect URI” section and make it default.

Go to Settings>> Connect Settings >> Redirects:

Enter the URL:

Set it as default:

You will find the codes under Multivendor Admin Panel > Configuration > Instruction for Marketplace > Under Stripe Connect.

Connect seller Stripe account to your Stripe account by pasting these codes in the given template files.

Copy the code from Instruction for Marketplace section into Redirect URIs inside account applications settings (Visit Stripe Account). The code will look like this:

https://{your_seller_url}/index.php?p=stripe_connect_config&sid={your_sid}&type=connect

Note: Please don’t paste the exact same code as provided above as it doesn’t have the seller URL & sid number. Visit Instruction for Marketplace section and then copy the code from there.

Copy the below given code & paste it to customers/order.liquid template.

<div style="display:none;" id="wk_order_payment_status" data-payment_status="{{ order.financial_status }}" data-sh_gateway="{{ order.transactions[0].gateway }}" data-wk_gateway="Stripe Payment"></div>

Admin needs to create the stripe connect payment name from Shopify store settings to add Payment Name for the checkout page. Please follow the below steps:-

Admin panel of Shopify store>>Settings >> Payment Providers>>visit “Manual Payments” section>>click “Create Custom Payment Method” from drop down>>Enter Payment Method name>>Click on “Activate” button.

Please note:- Name of your custom payment method should be the same as the name of Stripe Payment name. (Which you have entered from the “Checkout payment method” section of the multivendor app)

This way you can create the payment method which the customer will select at the checkout page once added by the admin.

Now a menu name “Stripe Connect Configuration” in the “orders” Section will be added to the seller panel of your multivendor marketplace app.

After visiting this section click on “Add account to stripe”

Standard:-

Express:-

Further, the account will be successfully added.

If the seller has configured the express account, he will have the option to redirect to the stripe dashboard from here:

At the checkout page, a customer can choose the “Stripe Connect” payment method to pay for the order.

Purpose of this feature:
This feature lets your sellers automatically receive their total earnings once they mark the order as delivered/fulfilled/pay after the refund date.

In the case of Stripe Payout, according to the order status (delivered/fulfilled/pay after the refund date) set by Admin, the seller earnings are transferred from the Admin stripe account to the seller stripe account. This transfer of seller earnings from  Admin to Seller Stripe account is managed by STRIPE & then as per the settings configured by the seller on their respective Stripe dashboard the amount is transferred from the Seller Stripe account to their bank account is managed by the Multivendor marketplace App.

Note: The stripe payout feature is not compatible with two countries that is Brazil & India.

Limitations of stripe payout

1) Balance must be available in the seller connector stripe account.
2) Manual Pay must be enabled on the seller stripe account.

How to configure the Stripe Payout feature?

To configure this feature, the Admin needs to follow the steps written below:

• Go to Multi vendor Marketplace Admin Panel
• Hover over the Order menu & select the Checkout payment method from the drop-down menus.

After clicking on the checkout payment method, the user will land on the checkout method page as shown in the image. The user needs to click on the add button.

Once the user clicks on the add button the stripe configuration page will open and the user needs to select the stripe payout as the use stripe for option.

After fulfilling all the relevant details, the payout configuration is there AUTOPAY TO SELLER.

Once you enable this configuration, you will get the three options to select

Fulfill:

If you select the fulfill option then once the seller marks the order as fulfilled then seller earnings will be transferred to the seller account.

Delivery:

In the case of delivery, the seller’s earning will be transferred to the seller’s account once the order is marked as delivered.

Pay after the return date:

To enable this feature, the admin first needs to enable the ENABLE CASHABLE AMOUNT FOR SELLER configuration which allows you to set particular days after which you want your Sellers to receive the payment.

These days are basically the days in which your customers can refund the purchased items.

Configure the following feature by visiting:

Multivendor Marketplace Admin Panel > Configuration > Order Configuration:

Here, the Admin needs to enter the days after which the payment will be done to his sellers for the order (order refund days) and select whether you want to calculate the provided span of time from the delivery date, order fulfilment date or order creation date.

Example: If you have selected the delivery date & mentioned refund days (pay after days) as 30 then after 30 days of the delivery date, the Sellers will receive the payment.

NOTE: Refund days should be greater than -1 otherwise it will not work.

Lastly, enable the ‘Allow seller to enter refund days‘ if you want your sellers to add their individual refund days.

Once enabled, the sellers will be able to set the refund days by visiting Marketplace Seller Panel > Configuration > General Configuration > Enter the day & save:

Note: The sellers who have not entered any refund days will by default have the refund days set by the admin.
If entered then the refund days should be greater than -1 otherwise it will not work.

Only after enabling this option, the Admin will have the ‘Pay after refund date’ option in stripe Payout Configuration:

Also, the Admin won’t be able to choose the ‘pay after’ as delivery or fulfilment because now it will work as per configured in the ‘Cashable Amount for Seller’ option.

The whole auto-pay process at a glance!

Suppose, a customer placed an order and the Admin has set the stripe Payout payment condition as ‘fulfilled’, i.e., the Seller will auto-receive the payment once he set the order status as fulfilled. Considering this scenario, let’s have a look:

The Admin can view the orders in the Order Listing page of the Admin panel:

Admin Panel > Orders > Order listing:

Similarly, the Seller can view the orders in the Order Listing page of the Seller Panel:

Seller Panel > Orders > Order Listing:

Until the order is fulfilled by the Seller, the Seller Payment will remain due at the Admin end.

Admin end > Payment > Seller Payments:

Also, the Seller will not receive any payment information in the ‘Payment Received’ page at Seller end (Seller end > Orders > Payment Received).

Once, the order is fulfilled by the Seller & the order status changes from Unfulfilled to Fulfilled at both, Admin & Seller end:

Seller end > Orders > Order Listing:

Now, as soon as the order is fulfilled by the Seller, the total due amount at the Admin end will become zero & payment earnings will be auto-paid as per the configuration.

Admin end > Payment > Seller Payments:

Purpose of this feature:

This feature lets your sellers automatically receive their total earnings once they mark the order as delivered/fulfilled/pay after the refund date.

In Stripe Transfer feature customers will pay the admin via the payment method available on the Shopify end. The seller’s earnings are transferred from the Admin Stripe account to the Seller Stripe account. This transfer of seller earnings from  Admin to Seller Stripe account is managed by the Multivendor marketplace app  & then as per the settings configured by the seller on their respective stripe dashboard, the amount transferred from the Seller Stripe account to their bank account is managed by the Stripe end.

Note: The stripe Transfer feature is not compatible with one country that is India.

How to configure the Stripe Transfer feature?

To configure this feature, the Admin needs to follow the steps written below:

• Go to Multi vendor Marketplace Admin Panel
• Hover over the Order menu & select the Checkout payment method from the drop-down menus.

After clicking on the checkout payment method, the user will land on the checkout method page as shown in the image. The user needs to click on the add button.

Once the user clicks on the add button the stripe configuration page will open and the user needs to select the Transfer for the field “use stripe for“.

After fulfilling all the relevant details, the payout configuration is there AUTOPAY TO SELLER.

Once you enable this configuration, you will get the three options to select

Fulfill:

If you select the fulfill option then once the seller marks the order as fulfilled then seller earnings will be transferred to the seller account.

Delivery:

In the case of delivery, the seller’s earning will be transferred to the seller’s account once the order is marked as delivered.

Pay after the return date:

To enable this feature, the admin first needs to enable the ENABLE CASHABLE AMOUNT FOR SELLER configuration which allows you to set particular days after which you want your Sellers to receive the payment.

These days are basically the days in which your customers can refund the purchased items.

Configure the following feature by visiting:

Multivendor Marketplace Admin Panel > Configuration > Order Configuration:

Here, the Admin needs to enter the days after which the payment will be done to his sellers for the order (order refund days) and select whether you want to calculate the provided span of time from the delivery date, order fulfillment date or order creation date.

Example: If you have selected the delivery date & mentioned refund days (pay after days) as 30 then after 30 days of the delivery date, the Sellers will receive the payment.

NOTE: Refund days should be greater than -1 otherwise it will not work.

Lastly, enable the ‘Allow seller to enter refund days‘ if you want your sellers to add their individual refund days.

Once enabled, the sellers will be able to set the refund days by visiting Marketplace Seller Panel > Configuration > General Configuration > Enter the day & save:

Note: The sellers who have not entered any refund days will by default have the refund days set by the admin.
If entered then the refund days should be greater than -1 otherwise it will not work.

Only after enabling this option, the Admin will have the ‘Pay after refund date’ option in stripe Transfer Configuration:

Also, the Admin won’t be able to choose the ‘pay after’ as delivery or fulfillment because now it will work as per configured in the ‘Cashable Amount for Seller’ option.

Furthermore, if you need any kind of support/Consultancy then please raise a ticket at http://webkul.uvdesk.com/ or drop an email at support@webkul.com

Thanks for reading this blog!!! 🙂