Back to Top

PrestaShop MangoPay Payment {User Guide}

Updated 20 April 2024

PrestaShop MangoPay Payment module allows merchants to offer this payment mode to their customers to make the payment. The customers can use this payment mode to make payments via credit/debit card & bank wire transfer. It also offers the admin to choose whether customers will make the payment from the third party page or the same page.

Additionally, the module also offers merchants to manage refunds as well as a payout from the module itself.

Being 3DS2 compliant, this Mangopay payment module offers a superior level of payment security to your customers.

The module is now compatible with latest MangoPay API.

Note: PrestaShop Mangopay Payment module is compatible with PrestaShop framework version 8.x.x.

Searching for an experienced
Prestashop Company ?
Find out More

Features of PrestaShop MangoPay Payment module

  • User category, terms & conditions, headquarters address, and company number will be saved directly from module to Mangopay.
  • Customers get an option to pay through credit card, direct debit & or bank wire payment methods.
  • Admin has the option to allow customers to pay via different card types.
  • An admin can choose to redirect a customer to a third-party page while paying through the card.
  • Admin can view transaction details in the Mangopay account.
  • Wallets generate at the Mangopay end as per the currency selected in the “allowed currency”. A single user may have multiple wallets.
  • Enable/disable fields to delete the Mangopay data at the time of un-installation of the module.
  • Admin can manage refund as well as payout process through the module.
  • Admin can add multiple bank account details.
  • Admin will have the option to deactivate their added bank account details.
  • Using the “Mangopay Payout” tab, the admin can transfer the wallet balance to their account. Admin can select any of the added accounts.
  • As per the allowed currency selected in the configuration, the available wallet amount will display on the payout page.
  • Admin can see the list of transactions done via credit card, direct debit, and bank wire.
  • A list of transactions in “admin’s wallet” & “PayIn wallet” will be available to the admin.
  • Depending on the “transaction order status”, the order amount will add to the list of transactions of “admin’s wallet” and “PayIn wallet”.
  • Admin can refund the wallet amount to PayIn/customer wallet from the module.
  • An admin can also refund the full/partial amount from the PayIn wallet to the customer account.
  • Admin can use the module either in test mode or live mode.
  • An admin can also upload their KYC documents from the module.
  • Admin can also track the current status of KYC document(i.e., whether it’s accepted or not) & accordingly make changes.
  • Now, the card type can be configured based on the selected currency.
  • An admin can also upload their UBO declaration from the module.

Note: Prestashop MangoPay Payment module is MultiShop Compatible.


  1. PrestaShop MangoPay Payment module is compatible with 3DS2.
  2. Click here to view a list of authorized countries where you can process the payments.
  3. The module is 3DS2 compliant.
  4. Admin can also upload the KYC documents from the module.
  5. Compatible with the latest APIs of MangoPay.

3DS2: The 3DS2 is a multi-factor authentication protocol that helps to confirm the digital identity of the user during checkout.

How to install the PrestaShop MangoPay Payment module

  • Firstly, go to the module manager in the back office and click on ‘upload a module’.
  • After that, drag and drop the module file or select the file from the system.
  • In this way, the module installation will be successful.
Click to Install PrestaShop MangoPay Payment module
Drop or upload the file of PrestaShop MangoPay Payment module from the system
PrestaShop MangoPay Payment module installed successfully

How to configure the PrestaShop Mangopay Payment

After the successful installation, the admin needs to configure the module.

Moreover, the significance of each option is available in the screenshot below. Please refer.

PrestaShop MangoPay Payment option available at the checkout page

After clicking on “Save & Generate Mangopay User“, a user will generate at Mangopay end with the wallet in the selected currency.

Admin can generate multiple wallets for a user for different currencies. However, an admin can only generate a single wallet at a time.

Mangopay Card Payment

By enabling this option, customers get the option to pay via credit card.

Mangopay Direct Debit

In this payment option, the customers can use their bank details to make the payment.

Mangopay Bank Wire

In this payment option, the customers can pay by directly transferring the amount to the admin’s account.

Order Status for Transfer

Admin can set the order status on which the money will transfer from the customer’s wallet to the admin’s wallet.

UBO Deceleration

In this option, the admin can also upload their UBO declaration from the module.

Mangopay ‘Card Payment Type’

Admin has two types of card payments.

  • Direct Payment – Through this option, customers can pay without redirecting to the third-party page.
  • PayIn Web –  Whereas through this option, the customer will redirect to the third-party page for the payment.
mangopay user list at the mangopay dashboard
user details
user wallet

Front-End Workflow

After configuring the module successfully, the “Mangopay Payment” gateway will be available to customers on the checkout page.

mangopay payment modes on the checkout page

Mangopay Card Payment

In card payment, the admin has two payment types to set i.e. Direct Payment and PayIn Web.

If the payment type is “Direct Payment“, then the buyers will not redirect to any third-party page for making the payment.

card payment

If the payment type is “PayIn Web”, then the buyers will redirect to the third-party page for the payment.

select card type
authentication page

In the above way, buyers can make the payment through Mangopay card payment.

Mangopay Bank Wire Payment

bank wire payment

Mangopay Direct Debit Payment

direct debit payment mode

Back-End Workflow

On successful installation of the module, new tabs add to manage the Mangopay transactions.


Mangopay Bank Details

Admin can add various bank account details to manage the transfer/payout of wallet money to the bank account.

Update buyer

After the installation of PrestaShop Mangopay Payment V 4.5.0, the admin can update the details of the old customers by clicking on update buyer button.


Mangopay Payout

Admin can transfer their wallet money to any of their bank accounts that are added by him/her.


Mangopay Card Payments

Under Mangopay card payments, an admin can view the list of all the users that have done the payment by card.


Refund Process in Mangopay Card Payments


Mangopay Direct Debit Payments

In this section, an admin can also view the list of all the transactions made through direct debit payment.


Refund Process in Direct Debit Payments


Mangopay Bank Wire Payments

Whereas, in this section, an admin can view the list of all the transactions made through Mangopay Bank Wire Payments.


If the status is “created”, then the payment has been done by the customer but not accepted by Mangopay.


Bankwire details on the order detail page are formatted.


Furthermore, the admin can also add their KYC details from the module itself.

To do so, go to the “Manage KYC” section first & then click on the “Add KYC” button.


After clicking on the Add KYC” button, the following page will open. Here, you just need to select a type of document & then upload the relevant documents.


On uploading the document successfully, it will appear just below the dropbox. You can also choose to delete this document before finally uploading it.


A list of all the KYC updates will also be available. The list will show the current status of the KYC document i.e. whether it’s accepted or not.

Additionally, it also displays the refusal reason(if the document is not accepted). Apart from that, the creation date i.e., uploading date & unique ID is also available.


Payout Process

Now, an admin can also transfer the wallet money to their bank account with the help of the module.

To do so, an admin can go to Mangopay Payment & then to Mangopay Payout.


In this way, an admin can manage the payout of the wallet amount to their bank account.

UBO Declaration

A UBO Declaration is an electronic form of the prior KYC document “Shareholder Declaration” that lists all of the Ultimate Beneficial Owners of a BUSINESS-typed legal User (i.e. stockholders with more than 25% of the capital or voting rights).


Afterward, firstly you need to create the UBO declaration by clicking on Add in the UBO declaration section as shown below the image.


After following the first step add the UBO by clicking on it as shown in the below image.


After following the steps you just need to add the UBO by clicking on, Add UBO in UBO declaration details.


Afterward, fill in all the required details and submit the open UBO form.


Afterward, successfully submitting the UBO declaration form, and success status is now shown below the image and its next step to validation.


Now, the admin going to the MangoPay dashboard to process the UBO declaration.


From this panel, the admin can accept, refuse or mark incomplete and submit.

So, this was all about the PrestaShop Mangopay Payment module. I hope this document will help you in checking the functionality of the module in a better way.

Also, do let us know about your views in the comments.


For any kind of technical assistance or query, please raise a ticket at or send us a mail at [email protected]

Also, please explore our PrestaShop development services & vast range of featureful PrestaShop Addons.

Current Product Version - 4.6.0

Supported Framework Version - 8.x.x, 1.7.x.x

. . .

Leave a Comment

Your email address will not be published. Required fields are marked*

Be the first to comment.

Back to Top

Message Sent!

If you have more details or questions, you can reply to the received confirmation email.

Back to Home

Table of Content