With the latest version of Dokan Pro 3.3.0, we are introducing the new PayPal Marketplace module. This is a new payment gateway that will help to make all the transaction process smooth. This payment is specially made to handle multi-vendor marketplace transactions. Let's see how to set up and use this new module.In the redirected page, you need to select the Business Information option.There you will find the PayPal merchant id. That is the Partner Id.Copy the PayPal Merchant ID from here. For Sandbox Merchant ID, you need to click on the “View/Edit Accounts” option from the Accounts section where you created your platform app. Then copy the Account ID (merchant Id) and paste it on your dashboard.Copy them from here and use it to configure your Dokan PayPal Marketplace payment gateway.
Get PayPal API CredentialsYou can either use your live PayPal Business account or create a new business account. To test the integration, you can create a Sandbox account. Both setup processes are the same. This business account would act as the Partner (API Caller) Account. For integrating in Sandbox, please go through the following steps:
Step 1: Login to https://developer.paypal.com/Create a new Live PayPal Business account or use an existing Live PayPal account to log in. This Live account has to be a Business account. Note: For live mode, make sure to have the PayPal balance set to 0. If you have any balance beforehand, you won't be able to withdraw that amount.
Step 2: Collect REST API Credentials and Merchant ID
a. Collect PayPal Merchant IDTo attain the necessary credentials, you need to log in to your PayPal account or to test with a sandbox login to your sandbox account. Now, select the Account Settings option from your profile.
b. Create Rest API Apps & Collect Client ID, Client Secret IDNow, to get the Sandbox Client and Secret, you need to log in to your PayPal developer dashboard. Next, you need to create a Rest API app to get these credentials. Click on Create App. Note: For live mode click the Live button and for testing purposes click the Sandbox button. Both setup processes are the same. Enter your App name and your business account. Then hit the Create App button.
Note: If you don't find your country/region in the list of Country/Region, kindly select the Merchant – Accept payments as a merchant option from App Type.Check all the options like the below screenshot, On the next page, you will find your Client Id ( App Username ) and Secret key ( App Password ).
C. Fill out the PayPal Marketplaces and Platforms formLive credentials are only available to approved marketplaces and platforms. If you are interested in becoming an approved marketplace or platform, fill out the PayPal Marketplaces and Platforms form. This form will be sent to PayPal directly and they will verify the information. Without this approval, calling the PayPal Commerce Platform for Marketplaces and Platforms APIs with your live credentials results in the HTTP status code of 401 Unauthorized. Calling the PayPal Commerce Platform for Marketplaces and Platforms APIs with your sandbox credentials does not require approval. After PayPal get all the details, it takes from 1 to 3 business days to get an account configured at their end. They will notify you once the configurations are done from their side. Once your PayPal Live account has been configured with the PayPal Commerce Platform configurations, you can start using that Live account as the Partner account. Use this Partner account’s REST credentials to make your API calls against the Sandbox endpoints.
Setup Dokan PayPal MarketplaceAfter configuring your PayPal API credentials, you need to enable the module. Navigate to WP Admin–> Dokan–> Modules. Now you need to enable the Dokan PayPal MarketPlace module.
WooCommerce SetupNow, you need to manage the gateway from WooCommerce settings. Navigate to WooCommerce–> Settings–> Payments. Enable the Dokan PayPal Marketplace Payment gateway and click on Manage. Here you will find all the options to set up the payment gateway. Enable/Disable: Check the box to enable (or disable) the Dokan PayPal Marketplace payment gateway. Title: Give a title or use the default one that the customers will see during the checkout. Description: Add a description or use the default one, customers will see this on the checkout page. PayPal Merchant ID/Partner ID: Add the merchant/partner id you got while you were setting up API credentials from Step 2 (a).
API Credentials:PayPal Sandbox: If you want to test the integration in Sandbox mode, check this setting. If you have checked PayPal sandbox mode, you’ve to provide Sandbox Client ID and Sandbox Client Secret below. Otherwise, you’ve to provide Client ID and Client Secret for live account API Credentials you got from Step 2 (b). Sandbox Client ID: Add the client id you collected while setting up PayPal API credentials on Step 2 (b). Sandbox Client Secret: Add the client secret you collected while setting up PayPal API credentials on Step 2 (b). Client Id: Add the client id you collected while setting up PayPal API credentials on Step 2 (b). (for live mode) Client Secret: Add the client secret you collected while setting up PayPal API credentials on Step 2 (b). (for live mode) PayPal Partner Attribution ID / BN Code: PayPal Partner Attribution ID will be given to you after you setup your PayPal Marketplace account. If you do not have any, default one will be used. Disbursement Mode: Choose whether you wish to disburse funds to the vendors immediately or hold the funds. Holding funds gives you time to conduct additional vetting or enforce other platform-specific business logic. As an admin, you can choose when to disburse the funds to the vendors. You will have 3 options,
- Immediate: vendors will get their money immediately after the order.
- On order complete: vendors will get their money after the order is complete via site admin or vendors based on Settings (either vendor can change order status or not)
- Delayed: You can choose to hold the fund for a specific number of periods of an interval to disburse the funds. After the specified day's funds will be automatically disbursed to the vendor's PayPal account. The maximum delay period is of 29 days. If the fund is not disbursed within 29 days, PayPal will automatically release funds to the corresponding vendors.
Webhook URLWebhook URL will be set automatically in your application settings with required events after you provide correct API information. You don't have to set up the webhook URL manually. Only make sure the webhook URL is available to
https://your store/wc-api/dokan-paypalin your PayPal application settings. Lastly, hit the Save Changes button to finish.
How Vendors Will Connect Their PayPal Account?Go to Dokan–> Settings. Choose the Withdraw options. You need to select the Dokan PayPal Marketplace option in order to activate the payment gateway. Note: If you didn’t provide API Credentials for Dokan PayPal Marketplace payment gateway settings, this option won't be visible to you or your vendors. Also, When vendors connect their PayPal account to your MarketPlace their PayPal account will be converted to a business account automatically.
Note:You need to select the Shipping fee and Tax fee recipient as Vendors. Otherwise, there won't be any problem with transactions but an issue may arrive in case of a refund. So, we strongly suggest you choose Vendors as Shipping fee and Tax fee recipient. You will find the options in Dokan–> Settings–> Selling options. You will find more details about it in the Refund section. Also, if you choose the wrong currency that isn’t supported by PayPal, you can't configure this payment gateway. When you choose any wrong currency that PayPal doesn't support, then you will get a notice like that on the Payment Gateway Settings page, If the vendors are not connected with their PayPal account, they can't receive any payments through PayPal and also the customers can't pay through PayPal as well. To connect their PayPal account, the vendors need to navigate to Vendor Dashboard–> Settings, On the next page, choose the Payment option. They will see a Text Field. They need to add their PayPal email address and hit the SignUp button. A pop-up window will appear and they need to select the region. When they click on the Next button, they need to add their password and press Log in. Vendors needs to allow their PayPal account to connect to the Marketplace. Vendors can use existing or if they want they can create a new business account. It's up to the user. Next, the vendor needs to add some necessary information to finish the setup process. Also, some additional information. When you add all the information, the setup process is complete. If the connection is successful, they will be redirected to the marketplace and they will see their Merchant ID, a notice that the connection is successful. That is how Vendors can connect their PayPal account to the marketplace. Note: if the vendor's account needs further verification from the PayPal end, vendors will see the relevant message here instead of the Disconnect button. Once PayPal verifies the vendor’s PayPal account, their PayPal account will be automatically connected and they don’t have to follow further actions to connect their account from here (payment settings page)
Checkout EligibilityVendors need to connect their PayPal account before they start selling their product. if the vendor is not connected to their PayPal account, and PayPal marketplace is the only payment gateway available, then when a customer adds a product from those vendors they will see a notice like this, Otherwise, they’ll see a notice to remove products for those vendors in the checkout page. Also, Customers can buy products from 10 vendors at a time while using the Dokan PayPal Marketplace payment gateway. That is the PayPal policy. There is no limit on how many products they can buy at a time.
Payment Options ( How To Pay With Dokan PayPal MarketPlace )We said earlier that there were two types of payment button options and a third option named Unbranded Credit Card methods for selected countries. If you choose the Standard Payment Button option, the customer will see a default Place Order button. After they click that button, they’ll redirect back to the PayPal site and after they completed their payment on the PayPal site, they’ll redirect back to the marketplace site. Note: In Standard Mode, the order status will change to Processing/Completed after the webhook is processed, till then, the order status will remain in a pending payment state. When you choose the Smart Payment buttons, customers will see multiple payment options based on the country. When the customer places the order an IFrame will open in order to complete the payment. When you choose the Smart Payment Button option and check Unbranded Credit Card Mode, the Customer will see a credit card form along with Smart Payment Buttons. Customers will not leave your site in order to complete their payment if they choose to pay via credit card. Note: In order for UCC mode to work, you need to choose Smart Payment Buttons from the payment gateway settings page.
Disbursement ModeVendors will receive their money based on the disbursement mode.
- For Immediate Disbursement mode, vendors will receive money right after the customer payment.
- In the case of On Order Complete Disbursement mode, the vendor's money will be On-Hold. Vendors will be able to view that from their PayPal dashboard. In that case, the fund will release automatically after the admin changes the order status to Completed from the order details page of your admin/vendor dashboard.
- The same goes for Delayed Disbursement mode as well. The vendor's money will be On-Hold. In that case, the fund will be automatically released after the specified amount of days mentioned in payment gateway settings.