MANGOPAY WordPress Plugin documentation


background image

 

Glossary  

MARKETPLACE 

Online platform where products and services are exchanged by 
third parties. Transactions are processed by the platform. 
(You) 

WOOCOMMERCE 

Plugin enabling you to turn a Wordpress platform into a 
full-featured e-commerce platform 

WC VENDORS 

Plugin enabling you to turn an e-commerce platform into a 
multi-vendor marketplace. 

USER 

Natural person (natural user) or a legal person (legal user). 

SELLER / VENDOR 

User selling a product or a service. 

BUYER 

User buying a product or a service.  

E-WALLET 

Digital wallet on which electronic money is stored.  

PAY-IN 

Deposit of funds by a user on an e-wallet.  

TRANSFER 

Movement of funds from one e-wallet to another.  

PAYOUT 

Withdrawal of funds from an e-wallet to a end-user’s bank 
account. 

FEE E-WALLET 

E-wallet owned by the marketplace to collect fees.  

FEE 

Commission calculated and collected by the marketplace. 

REFUND 

Reimbursement to a user. 

KYC 
(Know your customer) 

Verification process of your users’ identity, part of European 
anti-money laundering regulation.  

DASHBOARD 

Personalised interface providing the platform with full access to 
their activity in MANGOPAY’s API. 

 2 


background image

 

Introduction 

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

 
 
Install your Wordpress site 

here 

 
WooCommerce plugin 
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, 
and transactions.  
 

WC-Vendors plugin 
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. 
 

MANGOPAY Woocommerce 
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 
MANGOPAY ​

live sandbox or production account​. 

 3 


background image

 

Functioning 

MARKETPLACE WORKFLOW

 

 
 
STEP 

 
 
USER 
ENVIRONMENT 

 
 
MARKETPLACE 
ENVIRONMENT 

 
 
MANGOPAY 
ENVIRONMENT 

 

 

COMMENTS 

Vendors sign-up to the 

marketplace 

n/a 

An associated user is created  

 

Vendors complete their profile 

with the right verification 

documents 

n/a 

KYC verification by MANGOPAY 

compliance team 

Payouts: Compulsory KYC 

documents for any amount 

Products are assigned to vendors 

n/a 

 

Order is placed 

n/a  

E-money is stored into the 

buyer’s e-wallet 

Buyers can purchase products 

from several vendors during 

the same checkout 

Vendors mark each product as 

dispatched 

n/a 

n/a 

 

n/a 

You mark the 

order as 

completed 

Funds are transferred from the 

buyer’s e-wallet to vendor’s 

e-wallet 

Your commissions are applied 

n/a 

Vendor(s) 

payout 

Funds are paid out from the 

vendor’s e-wallet to his bank 

account 

Bank account(s) can be added 

to a user’s profile by you or the 

vendor himself 

 4 


background image

 

Woocommerce set-up 

SETTING UP YOUR E-COMMERCE 

 

Business details  
 

Store Address: 

Provide your official business address. Tax rates and shipping rates will use this information. 

 

WooCommerce​

  ​

 ​

 ​

Settings​

  ​

 ​

 ​

General  ​

 ​

 Store addr​

ess  ​➔​  ​Provide your business address 

 

 

 

 

 

 5 


background image

 

Currency options: 

You are able to select the currency of your choice.  

 

WooCommerce​

  ​

  ​

Settings  ​

  

General  ​➔ ​ Currency options  ​

 ​ Select currency

 

 

 

 

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. 

 

Payment configuration  

 
Enabling/disabling payments: 

In order to receive payments, enable MANGOPAY payments.  
 

WooCommerce​

  ​

  ​

Settings  ​➔  ​Payments  ​➔  ​MANGOPAY  ​➔  ​Manage  ​➔​

 ​

 ​

Check “​Enable 

MANGOPAY Payment​” 
 

 

 

 6 


background image

 

Payment methods: 

You can select your payment methods. CB/VISA/Mastercard/ Bancontact-Mister Cash/Paylib 
are enabled by default.  
 

WooCommerce​

  ​

  ​

Settings  ​➔  ​Payments  ​

  ​

MANGOPAY  ​

  ​

Manage  ​

  ​

Choose your 

payment methods

 

 

 

 

N.B: To activate other payment types marked with a “*”, please contact MANGOPAY ​

support​

. 

 
 

 

 7 


background image

 

Other features: 

You can enable some optional payment features. 

 

Card registration 
Allows your buyers to securely store their card on MANGOPAY for future payments. 
More info ​

here​

. 

 

Use this page for payment template 
Allows you to personalize your payment page with your own template. More info ​

here​

. 

 

 

 

 

 

 

 

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

 

Settings​  ​

  ​

Account & Privacy  ​

  ​

Guest checkout​  ​

 ​

 ​Uncheck “Allow customers to place 

orders without an account” 

 

 

 

 

 

 

 

 

 8 


background image

 

Products  

All products need to be assigned to a vendor and all active vendors need to have a MANGOPAY 
account. 

 

Assigning a product to a vendor: 

 

Products​  ​

  ​

All products  ​

  ​

Choose a product​  ​

  ​

Vendor  ​

  ​

Select Vendor​  ​

  ​

Update

 

 
 
 
 

________________ 

 

Your Wordpress platform is now a full-featured e-commerce solution. 

The next part turns your e-commerce solution into a marketplace.  

 

 

 

 

 9 


background image

 

WC Vendors set-up 

SETTING UP YOUR MARKETPLACE   

 

Commission

 

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: 

 
Users​
  ​

  ​

All users  ​➔ ​ C​hoose a user​  ​➔  ​WC Vendor  ​➔ ​ ​Set commission rate  ​➔  ​Update 

 

 

 

 

 10 


background image

 

Setting product’s commissions:  

 

Products ​ ​

  ​

All products  ​

  ​

Choose a product​  ​

  ​

Commission  ​

  ​

Set product commission 

  ​

Update 

 

 

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 
marketplace workflow)​

.

   

N.B: Commissions reports are available in the MANGOPAY dashboard. More info ​

here

 

 

 

 

 

 

 

 

 11 


background image

 

Compliance  

 

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.   

 

WC Vendors​  ​

  ​

General  ​

  ​

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 ​

here​

. Find more technical information ​

here​

.  

 

Natural user:  

Legal user: 

IDENTITY PROOF 

GENERAL MANAGER ID CARD 

ARTICLES OF ASSOCIATION  

SHAREHOLDER DECLARATION/ COMPANY 

NUMBER 

REGISTRATION PROOF 

 
 

 

 

 

 

 

 

 12 


background image

 

Vendors 

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.  

 

Users​  ​

  ​

All users  ​

  ​

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.  

 
 

 

 

 13 


background image

 

MANGOPAY set-up 

SETTING UP YOUR PAYMENTS  

 
General configuration  
 

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.  
 

MANGOPAY​  ​

  ​

General settings  ​

  ​

Choose sandbox/production ​

  ​

Enter your ClientID/API 

key 

 

 
Choosing your user types: 

You can choose which type of user you will allow to register on MANGOPAY.  

 

MANGOPAY​  ​

  ​

Settings & Status  ​

  ​

All buyers are  ​

  ​

Define buyer type 

 
MANGOPAY​  ​

  ​

Settings & Status  ​

  ​

All vendors are  ​

  ​

Define vendor type 

 

                   

 

 

Vendors and buyers are indistinctly registered as ​

users

 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 ​

here

.  

 

 14 


background image

 

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.  

 

Go-live: 

When you are ready to go live, enter your Client ID and API Key.  

 

MANGOPAY​  ​

  ​

General settings  ​

  ​

Choose sandbox/production  ​

  ​

Enter your ClientID and 

API Key 

 

 

 

________________ 

 

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! 

 

 

 

 15 


background image

 

Extra features 

Refund 
 

MANGOPAY Woocommerce plugin supports refunds for payments with the status “Processing”.  
 

 ​

  ​

WooCommerce 

  ​

Orders 

  ​

Select the order 

  ​

Refund button  

  ​

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. 

 

Pre-authorization 

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. 

 

Enable pre-authorization: 

You can select the products for which pre-authorisation is enabled from the product page.  

 

Products​  ​

  ​

All products  ​

  ​

Select a product  ​

  ​

Product data  ​

  ​

check pre-authorization 

 

 

 

 16 


background image

 

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. 

 
Woocommerce​
  ​

  ​

Orders  ​

  ​

Select the order (status will be “Pending payment”)​  ​

  ​

Order 

edit page  ​

  ​

Pre-authorization  ​

  C​

apture the funds 

 

N.B: In Italy, Greece and Spain, the pre-authorization has a particular functioning. More info ​

here

 

 

 

MANGOPAY Dashboard  

More information about your users and transactions is available on the MANGOPAY dashboard. 
More info ​

here​

.  

 

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.

 

 

 

 17