Dokan Stripe Connect

A- A+

To add the Stripe payment gateway with your eCommerce marketplace, follow this documentation. It will help you to install, activate and configure the Stripe Connect module to your online marketplace.

Installation

Navigate to your WP dashboard->Dokan->Modules. Find Stripe Connect and turn on the toggle button on the top right to activate this module.

Enabling Stripe Connect

To enable this payment gateway, navigate to WP Dashboard → WooCommerce → Settings→ Payments

Toggle On the ‘Dokan Stripe Connect' section to enable it. Then click on ‘Manage' to get to the option for Dokan Stripe payments as shown below.

Check the “Enable Stripe” option and enter Title and Description. The plugin already has default text included, you can change it if required.

In the screenshot, we have enabled the test mode to test the payment system. For live transaction, you don't have to check this box.

You can enable the Stripe Checkout option. This will show a pay button and modal credit card from the checkout page. This also enables a popup that will open and will ask for credentials to pay. You can either turn this on or off. It is totally optional.

To get the redirect URL, copy the line from “

Set your authorized redirect URL https://dokandokani.test/dashboard/settings/payment/ in your Stripe application settings for Redirects.”

Now copy the URL and paste it into the Redirect URL field at your stripe account.

Note: In case you want to enable the vendor to collect order & payment from non-connected sellers, you simply need to check the ‘Non-connected seller' section shown in the screenshot above.

The Saved cards option allows users to pay with their saved cards during the checkout process. Stripe serve saves the card details (not on your stores) and this ensure security.

Credentials to Setup Stripe on Your Marketplace

The Stripe Settings has Live Credentials and Test Credentials configuration.

Here, you have to enter the secret key and publishable key in case of live transactions. You can also test the payment system using the test credentials.

All you have do is to enter the Secret Key, Publishable Key and Client ID from Stripe and Save changes.

How to Get the Credentials

Sign up or Log in

At first, you have to visit stripe.com and sign up. Follow their verification process. If you already have a Stripe Account, just sign in.

Generate (Test and Live) API Keys

You will find your dashboard after log-in. Now click on the API option from the left menu under Developers settings.

You will find the Secret and Publishable Keys for both Test and Live. Copy and paste the keys to the WooCommerce Settings. If you are testing, use the Test credentials.

For live transactions, use the live credentials. Simply untoggle the “View test data” button to get the live publishable & secret key as shown below.

Enabling oAuth

You need to enable oAuth, otherwise your sellers won't be able to connect their stripe account.

Adding Webhook with Endpoint

In order to get recurring subcription you need to confgure the webhook of your WooCommerse site.

Simply click on the hyperlinked webhook option to redirect yourself to the webhook settings of stripe account.

Now in the webhook page of developer settings click on +Add Endpoints to input the webhook URL.

A new page to feed the webhook URL would appear after clicking on +Add endpoint. Now simply copy paste the webhook URL collected from the WooCommerce stripe connect settings to add an endpoints to receive events from your account.

You can select multiple events like Order, Customer, Payment Intent, Plan, Charge invoice for Dokan or you can simply select ‘receive all events' to send all events to your account.

After adding the webhook URL selecting your desired events the URL will be live & it will be all set to connect with your marketplace account.

Connect Your Marketplace and Get the Client ID

Now, you have already entered the API Keys and the only thing required is the Client ID for live transaction or Test Client ID for Testing.

Click on settings from the left Menu. Now, click on the Connect Settings.

Once you enter the Connect settings, input the following details-

Redirect URL
Business or Marketplace Name
Website URL
Brand Color, Logo and Icon (if any)

Finally, copy the Client ID under the Development section. This is the credential you have to put under the Client ID in Dokan Stripe Connect Settings. Here is a demonstration of the whole process.

Add redirect URL pressing on +Add URL from top right corner.

After adding the redirect URL, enter your business details and website URL.

Activating Stripe for Vendors

You have got the credentials and entered them on the Dokan Stripe Connect Settings page. Now, save changes.

Navigate to- WP Dashboard → Dokan → Settings → Withdraw Options → Withdraw Methods

Check the Stripe box and Save changes.

Settings for Your Vendors

As you have installed a new payment gateway, your vendors should connect their stores to the Stripe Connect as well.

Navigate to – Dokan Vendor Dashboard → Settings → Payment

You will see a new option titled Dokan Stripe and asking to Connect with Strip.

Click on the blue colored button and you will be redirected to Stripe.com website.

(Vendor) Stripe Login or Signup

After logging in, you will see the Marketplace is trying to connect to your Stripe account.

Click on the Connect my Stripe account button.

After confirmation, you will be redirected to your store Payment Settings page.

The Dokan Stripe Connect Option will state that it has been connected with Stripe. And you are done with setting up Dokan Stripe Connect to your store.

There is a disconnect button, which can be used to disconnect your account from this marketplace any time you want.

How Customers Pay with Dokan Stripe

When a customer adds a product to their cart and check in, they will see all the available payment methods. If they select Dokan Credit Card (Stripe), a modal form will appear.

The form will ask for email, credit card number, expiry date, CVC. After entering the credentials, click on the Pay button.

After payment, the order details will show the payment method as Dokan Credit Card (Stripe).

Stripe Connect Announcement

Dokan will show an announcement if the vendor has not connected his/her stripe account to their stores.

The admin needs to enable this feature fromin the settings option in order to use this feature. to be able to show this announcement.

To enable this feature the admin needs to check the Display Notice to Connect Seller checkbox. This option is available in the WordPress Admin Dashboard → WooCommerce → Settings → Payment Gateway –> Dokan Stripe Connect settings.

Also, the admin can choose the interval period that the announcement will show up. Just choose the number of days in the Display Notice Interval option, default is 7 days. The announcement will look like this,

It will appear in the vendor dashboard in the announcement section.

If admin enable this feature, the vendors will receive notifications for,

If the Dokan Stripe Connect module is enabled and the vendor is not connected to their stripe account.
If vendors Stripe connect access tokens get expired (due to Stripe restriction and or verification), their Stripe account will be disconnected automatically with an announcement notice explaining the reason.
If there is something wrong with the stripe id
In 3DS mode, if vendor stripe currency is not similar to site currency (if vendor’s Stripe currency is different from site/admin stripe account currency, transfer to vendor Stripe account will be failed.)

Dokan Version 2.9.12 Update

The Stripe 3D Secure & Strong Customer Authentication System

With the release of Dokan Pro v2.9.12, you will be able to let the vendors use the stripe 3D secure and strong customer authentication in the checkout process. Here is how the customers will be able to buy using the Stripe 3D Secure:

Requirements

To allow the customers to use this 3D secured feature, the vendor must have the Stripe 3D secure and strong customer authentication system. Here are a few things to look at:

1. The admin must enable the 3D Secure and Strong Customer Authentication

2. 3D Secure and SCA ready transaction is only supported when both your platform and the connected account (Vendor) are in the same region: both in Europe or both in the U.S.

How will the Admin set the stripe 3D secure & strong customer authentication?

As an admin, navigate to the WP Admin Dashboard > WooCommerce > Settings > Payments > Dokan Stripe Connect (Click on the ‘Manage' button). After that, you will get the following screen:

Now, check the box beside the 3D Secure and SCA field to activate this secure payment method for your vendors and customers as shown above.

How will customers pay with the 3D secure system?

Supposing that the admin and the vendor both have enabled this feature. Now the customer will follow the normal purchase process:

Step 1: Add to Cart

Step 2: View Cart

Step 3: Proceed to Checkout

Step 4: Place Order

Step 5: 3D Secure Test Payment Page

This is it! In this very step, the 3D secure payment feature that we are talking about will appear. When the customer is paying he or she will be asked to verify their identity with a push notification and a text message in this step. Next, the customer has to hit the “COMPLETE AUTHENTICATION” button to proceed.

Note: If somehow the pop-up doesn't appear then you should take a look at this.

Table https://stripe.com/docs/testing#three-ds-cards. You'll find some cards with Supported 3D usage. By default, using this type of card in both test and live modes, you'll not have the authentication step during 3D checkout. You need to activate the Radar rules for this from your Stripe Dashboard.

Step 6: Order Received

Finally, the order will be received by the admin as usual.

Automatic Refund for Stripe 3DS Mode

From now on, the Stripe 3DS mode will support the automatic refund.

As we know, In Stripe 3DS mode, Admin is responsible for the customer payment, hence if a customer asks for a refund, this will be processed from admin Stripe account.

Refunds will be processed in two steps. Firstly refund will be processed from the admin Stripe account. Secondly, the amount that was passed to the vendor for the corresponding order, will automatically be reversed to the admin Stripe account.

For example, a customer has bought two products ($50+$40)= total $90 from a vendor. So, when the customer completes the payment, that $90 will be added to the admin’s stripe account.

Now, suppose admin commision is set to fixed $6, So after subtracting the admin’s commission ($6) and Stripe processing fee (gateway fee, in settings Gateway fee will be paid by vendors was selected) ($3), $81 will be transferred to the vendor connected Stripe account.

Now, when the customer asks for a refund, initially the amount ($90) will be refunded from the admin’s Stripe account.

Then the amount transferred to the vendor’s Stripe account,

In our case $81, will be automatically reversed from the vendor’s Stripe Account. It will named withdrawal.

Note that:

If there are not enough funds available in the admin’s account then the automatic refund will be failed and an order note will be added explaining the reason for the failed refund and admin need to process this refund manually As usual, there will be a new record under Dokan → Refund with requested refund details.

And in case of insufficient funds in the account of the vendor(s), the refund will be processed from the admin Stripe account. A new order note will be added stating that the transfer reversed wasn’t successful explaining the failed reason. Also, that amount will stay as a negative amount in the vendor’s balance.

Description & Metadata

In 3DS mode, We have added description and metadata to each transfer made to the vendors so that the vendors and admins can easily track the orders made on their stripe account.

If you click on a order,