MANGOPAY WordPress Plugin documentation
Online platform where products and services are exchanged by
third parties. Transactions are processed by the platform.
Plugin enabling you to turn a Wordpress platform into a
full-featured e-commerce platform
Plugin enabling you to turn an e-commerce platform into a
Natural person (natural user) or a legal person (legal user).
SELLER / VENDOR
User selling a product or a service.
User buying a product or a service.
Digital wallet on which electronic money is stored.
Deposit of funds by a user on an e-wallet.
Movement of funds from one e-wallet to another.
Withdrawal of funds from an e-wallet to a end-user’s bank
E-wallet owned by the marketplace to collect fees.
Commission calculated and collected by the marketplace.
Reimbursement to a user.
(Know your customer)
Verification process of your users’ identity, part of European
anti-money laundering regulation.
Personalised interface providing the platform with full access to
their activity in MANGOPAY’s API.
MANGOPAY is a payment solution which allows marketplaces to process third-party payments
in a secure and compliant environment. Our wordpress plugins enable an easy and fast
integration to create a marketplace from start to finish and process payments.
This document guides you through 3 plugin setups which will enable your marketplace to
accept worldwide credit/debit card payments, manage vendors, payouts, transfers, and platform
Install your Wordpress site
Allows you to turn your own Wordpress platform into a
full-featured e-commerce solution. It will be the primary
source of information to manage your products, orders,
Allows you to turn your woocommerce-enabled shop
into a multi-vendor marketplace. It will be the primary
source of information to manage your vendors’
capabilities, commissions and payouts.
Allows you to accept and process payments by
connecting to MANGOPAY’s API. In order to use the
MANGOPAY Woocommerce plugin, you must have a
Vendors sign-up to the
An associated user is created
Vendors complete their profile
with the right verification
KYC verification by MANGOPAY
Payouts: Compulsory KYC
documents for any amount
Products are assigned to vendors
Order is placed
E-money is stored into the
Buyers can purchase products
from several vendors during
the same checkout
Vendors mark each product as
You mark the
Funds are transferred from the
buyer’s e-wallet to vendor’s
Your commissions are applied
Funds are paid out from the
vendor’s e-wallet to his bank
Bank account(s) can be added
to a user’s profile by you or the
SETTING UP YOUR E-COMMERCE
Provide your official business address. Tax rates and shipping rates will use this information.
ess ➔ Provide your business address
You are able to select the currency of your choice.
General ➔ Currency options
Available currencies: EUR, GBP, USD, CHF, NOK, PLN, SEK, DKK, CAD, ZAR.
N.B: Please note that Woocommerce only allows one currency at a time.
In order to receive payments, enable MANGOPAY payments.
Settings ➔ Payments ➔ MANGOPAY ➔ Manage ➔
You can select your payment methods. CB/VISA/Mastercard/ Bancontact-Mister Cash/Paylib
are enabled by default.
Settings ➔ Payments
N.B: To activate other payment types marked with a “*”, please contact MANGOPAY
You can enable some optional payment features.
Allows your buyers to securely store their card on MANGOPAY for future payments.
Use this page for payment template
Allows you to personalize your payment page with your own template. More info
Account & Privacy
It is essential to disable guest checkouts to ensure the proper functioning of payments on your
platform. All users will need an account. If not, MANGOPAY will not be enabled during the
Account & Privacy
Uncheck “Allow customers to place
orders without an account”
All products need to be assigned to a vendor and all active vendors need to have a MANGOPAY
Assigning a product to a vendor:
Choose a product
Your Wordpress platform is now a full-featured e-commerce solution.
The next part turns your e-commerce solution into a marketplace.
WC Vendors set-up
SETTING UP YOUR MARKETPLACE
You are able to set your commission for sold products, which can be set globally for all vendors
as well as individually for a specific vendor or product.
Setting vendors’ commissions globally:
WC Vendors ➔ Settings ➔ Commission ➔ Set Vendor’s commission
Setting a specific vendor’s commission:
All users ➔ Choose a user ➔ WC Vendor ➔ Set commission rate ➔ Update
Setting product’s commissions:
Choose a product
Set product commission
MANGOPAY’s Woocommerce plugin will automatically apply the commission on
each order according to the above parameters. The funds are then transferred on
your Fee e-wallet. This commission is applied on each transfer (step 6 of the
N.B: Commissions reports are available in the MANGOPAY dashboard. More info
Agreeing with T&C:
In order to fully comply with MANGOPAY’s rules, your vendors will need to agree with your T&C
which should include MANGOPAY’s T&C.
check “Make the terms and conditions checkbox always visible”
Submitting KYC documents:
European regulation requires vendors to submit KYC documents to be able to payout.
Uploading KYC documents can only be completed by the vendor within his user interface on
your platform (the upload process is automatically created during the setup). The documents
will be validated by our compliance team before payouts.
Find more general information
. Find more technical information
GENERAL MANAGER ID CARD
ARTICLES OF ASSOCIATION
SHAREHOLDER DECLARATION/ COMPANY
Please note that if you already have users with the role “vendor” before the MANGOPAY
integration, you wiIl need to add some required fields for these specific users. These products of
these vendors will not be available at checkout if this step is not completed.
select a user
add Birthday, Nationality, Country of residence
Your Wordpress platform is now a full-featured marketplace. The next part
shows you how to connect your marketplace to MANGOPAY’s API, which
will enable you to accept payments.
SETTING UP YOUR PAYMENTS
Connecting MANGOPAY Woocommerce plugin to your MANGOPAY account:
The MANGOPAY Woocommerce plugin needs to be connected to your MANGOPAY account
with your sandbox and/or production details.
Enter your ClientID/API
Choosing your user types:
You can choose which type of user you will allow to register on MANGOPAY.
Settings & Status
All buyers are
Define buyer type
Settings & Status
All vendors are
Define vendor type
Vendors and buyers are indistinctly registered as
within MANGOPAY’s API.
Users can be:
Individuals: a natural person
Legal: a business, organisation, sole trader
Each type needs a different set of KYC validation. You can find more info
Checking your Mangopay configuration:
Verify your configuration under the “MANGOPAY status”. The various checks should all be in
green for your setup to function correctly.
When you are ready to go live, enter your Client ID and API Key.
Enter your ClientID and
After saving these changes, verify that all checks are still in green
(and resolve any that are not).
Your marketplace is now live and ready for business!
MANGOPAY Woocommerce plugin supports refunds for payments with the status “Processing”.
Select the order
Enter the refund amount
Reason for refund (optional)
Click Refund $X via MANGOPAY
N.B: Please note that if the order is
“completed”, you will have to manually refund the buyers.This is first accomplished within
wordpress then within the MANGOPAY dashboard.
It is usually good practice to only charge a buyer’s card when products are ready to ship. By
default, Woocommerce will immediately charge the customer even though the products may
not ship for another couple of days.
To solve this, pre-authorization blocks the funds without charging the customer and ensures the
card’s solvency for up to 7 days. MANGOPAY Woocommerce plugin will automatically manage
the card registration and pre-authorize the transaction.
You can select the products for which pre-authorisation is enabled from the product page.
Select a product
Charge the buyer’s card:
You can complete the pre-authorization and charge the buyer’s card according to your workflow.
Capturing the funds will charge the full pre-authorized amount from the customer’s card and
capture the effective payment.
Select the order (status will be “Pending payment”)
apture the funds
N.B: In Italy, Greece and Spain, the pre-authorization has a particular functioning. More info
More information about your users and transactions is available on the MANGOPAY dashboard.
Manual operations from the dashboard do not synchronise with the Wordpress
plugin! Your Wordpress marketplace will no longer function correctly if you
complete operations from the MANGOPAY dashboard.