Back to Top

Guide for Adobe Commerce Multi Vendor Flutterwave

Updated 9 May 2024


Magento 2 Marketplace Flutterwave(Adobe Commerce) extension allows the admin and sellers to integrate the Flutterwave Payment method to receive payment for their orders.

Further, Magento 2 Multi Vendor Flutterwave module supports the split payment that will automatically split the payment between sellers and admin for the seller orders.

The admin can set the title and environment for the payment method.

Moreover, the seller needs to provide their bank account details of Flutterwave to become a sub-merchant and to receive funds directly to their accounts.

This payment method is supported by Nigeria, Ghana, Kenya, South Africa, Uganda, Tanzania, the United Kingdom, America, and Europe.

Start your headless eCommerce
Find out More

Note: This is an add-on of Webkul’s Magento 2 Multi Vendor Module, so for using this module you need to install Marketplace modules first.

Watch the video below to check out the Flutterwave Payment Method for Magento 2 (Adobe Commerce) workflow:


Features – Marketplace Flutterwave for Magento 2

  • Fully PCI Compliant, no card details submitted to the client-server.
  • Enable/disable payment method from the admin panel.
  • Further, the payment automatically gets splits to sellers at the time of checkout.
  • The seller can become a sub-merchant by providing some details, to be able to receive funds if payment is done by the marketplace Flutterwave payment method.
  • The admin can refund the invoiced amount.
  • Moreover, the admin can refund the invoiced amount partially.

Module Installation – Marketplace Flutterwave for Magento 2 (Adobe Commerce)

Firstly, the customers will get a zip folder and they have to extract the contents of this zip folder on their system. And, the extracted folder has an src folder, in the src folder, you will find the app folder.

Then, you will have to transfer this app folder into the Magento 2 root directory on the server as depicted below.


After the successful installation of Marketplace Flutterwave for Magento 2 (Adobe Commerce), you have to run the command in the Magento 2 root directory.

First command –

php bin/magento setup:upgrade

Second Command –

php bin/magento setup:di:compile

Third Command –

php bin/magento setup:static-content:deploy

Fourth Command –

php bin/magento indexer:reindex

Cache Management

Then, after running the commands, you have to flush the cache from the Magento admin panel. So, navigate through->System->Cache management as shown below.


Multilingual Support

Now, the admin will navigate to Stores->Configuration->General ->Locale Options. Here, you can select the locale as German. (Locale is the language into which the admin desires to translate his store content).


Module Translation

If you want to translate the module language from English to German. Then, follow the following path in the unzipped Magento 2 web security folder. src/app/code/Webkul/MarketplaceFlutterwave/i18n.

After that, you will receive a CSV file with the name “en_US.csv”. Now, rename that CSV on your region code and language code “de_DE.csv”. And then translate all right-side content in your language.

After editing the CSV, save it and then you need to upload it where you have installed Magento 2 on the server.


Consequently, the module will get translated into your desired Language.


Create Flutterwave Payment Account

The admin needs to create an account on Flutterwave in order to integrate the payment method. Hence,  for this first, go to the Home page of the Flutterwave and click Create Account.

The-online-and-offline-payment-platform-for-businesses-Marketplace Flutterwave for Magento 2

Flutterwave Account Registration

Further, the user needs to enter the below details and click the Get Started button.


Confirm Flutterwave Account Registration

As a result, the user will be sent an email with a link to confirm their account.


Further, click the Confirm email address. 


Welcome to Flutterwave!

Select the, To accept payment as a registered business and click Continue to Dashboard.


Flutterwave Setup – Add Bank Account

Firstly, enter the bank account information where your earnings will be deposited.

Flutterwave-Dashboard-add-bank-account-1-Marketplace Flutterwave for Magento 2

Before selecting the Bank’s Name the user’s Phone Number verification is done an OTP is sent to the provided number.


Lastly, enter the Corporate Account Number and click Add account and continue.


Moreover, the user may also enter their business information at this stage as shown in the above image.

Flutterwave Bank Account – Details

For the Flutterwave onboard registration at the seller panel the seller needs to enter their bank account details for this, they can simply log in to the Flutterwave dashboard and go to the Settings > Bank Accounts.


Flutterwave Account – Fetch Live API keys 

Firstly, on the Flutterwave dashboard, the admin can go to the Settings > API. Further copy the Public Key and Secret Key. The admin needs to provide the same for the admin configuration.


Flutterwave Account Save Secret Hash – Webhook

The admin requires a secret hash for the Flutterwave admin configuration. To fetch the same admin can go to the Settings > Webhooks and under the field Secret hash enter your hash key and click Save.


Module Configuration – Marketplace Flutterwave for Magento 2

After the module’s successful installation, go to the Stores > Configuration > Sales > Payment Methods > Marketplace FlutterWave Payment.


Further, the admin needs to give input for the below fields.

Enable: The store admin can enable/disable the payment method from here.

Payment Title: Enter a custom payment title that will be visible to the customers on the front end. 

Environment: The admin can select the environment from the dropdown menu.

  • Sandbox – The Sandbox environment lets you test your integration before you go live.
  • Production – The production environment is the live environment where you cannot use the test card details.

Enable Escrow Payments: The admin can enable the option for customers to use the escrow payments.

In e-commerce,
  • An escrow payment protects the buyers and seller from any fraud or non-payment respectively. 
  • The buyers send the money to an escrow service, such as, and they hold the payment transfer or release of funds to the seller’s account until the product is received by the customer. 

The Test Public Key: The admin needs to enter their test public key fetched from the Flutterwave account here.

The Test Secret Key: The admin needs to enter their test secret key fetched from the Flutterwave account here.


Test Webhook Hash: The admin needs to enter their test webhook hash fetched from the Flutterwave account here.

Note: A secret hash is used to verify your webhook requests. Verify webhook requests with the secret hash returned as `verif-hash` from Flutterwave.

Popup Title: The admin can enter a custom title that will be present on the Flutterwave payment popup’s title.

Popup Description: The admin can enter a suitable description that will be present on the Flutterwave payment popup.

The Popup Logo: The admin can upload a logo image that will be present on the Flutterwave payment popup’s logo.

Right after all the fields have been entered click Save Config.

Flutterwave Onboard – Seller End Configuration

The vendor/seller needs to configure some basic settings to set up the Flutterwave payment on their account panel and simply go to the My Account > Flutterwave Onboard. 


To register as Submerchant on flutter wave payment firstly the seller needs to select the country and click Submit.


Right after that, the seller is required to provide his/her account Flutterwave account and business details.

Account Bank: The seller needs to enter their Bank Account name here provided as per their Flutterwave account.

Account Number: The seller needs to enter their Account Number fetched from Bank account details on Flutterwave.

Business Name: The seller’s business name needs to be entered here.

Business Mobile: The seller needs to enter their business mobile number.

The Business Email: Further, a business email also needs to be entered here by the seller.

At last, click the Save button to complete the registration.

Pay with Flutterwave Payment Method – Customer Order Workflow

After adding a product into the cart to proceed with the checkout. 


The customer can select the Marketplace FlutterWave Payment and click Pay.


Next, on the Flutterwave payment page a popup will appear, now enter the Card details.



  • Once, the card details are associated with the Flutterwave account of the customer, provide their Phone Number and Email Address.
  • Further, the OTP for payment confirmation is sent on the same number provided by the customer.


Further, click the Pay button. This redirects to the card issuer’s verification page, next to complete this payment click Proceed.


As a result, a receipt of the payment is sent to the customer’s email address, after the successful payment for the order.


Post which the customers will get the below success message as shown below.


Vendor Amount – View Order Details 

The Flutterwave payment method auto splits the payment between the admin and the seller. To check the order details the seller can go to the My Order History click to view the order.

Marketplace Flutterwave for Magento 2 Marketplace Flutterwave for Magento 2-vendor-commision

Total Vendor Amount and the Total Admin Commission is visible in the order details section.

Marketplace Seller Transactions – Split Payment Flutterwave

Now the seller can go to the My Account > My Transaction List. Here, the seller can view the details of the transaction on their panel.

The details include Transaction Id, Date, Transaction Amount and the admin Commission. 


Further, click to view the Transaction Order Information in detail.

magento 2-marketplace-flutterwave-payment-transaction-details

View Transaction Type – Capture & Authorization

The admin can go to the Sales > Orders click to open the respective order and then under the ORDER VIEW click Transactions.

Transaction type

The admin can find two records here of the transaction types with their date and time creation. Further, click to open both of the transaction records.

View Transaction Type – Authorization

The admin can simply click to view the transaction Authorization record. here, the Transaction ID and its type are mentioned.

Moreover, under the Transaction details status, message and data values are also present.

magento 2-marketplace-flutterwave-payment-transaction-data


View Transaction Type – Capture

The admin can simply click to view the transaction Capture record. here, the Transaction ID and its type are mentioned.

Moreover, under the Transaction details status, message and data values are also present.

magento 2-marketplace-flutterwave-payment-transaction- data


View Seller Transaction – Admin End

Now the admin can go to the Marketplace Management > Seller Transaction and view the seller transaction from the admin panel.

admin end view seller - Transaction

Seller Refund – Flutterwave Payment Method

To initiate a refund the seller can simply go to the My Account > My Order History.


Further, click to open an order. Secondly, click the button Credit Memo.

Marketplace Flutterwave for Magento 2.-credit-memo-new

Marketplace Flutterwave for Magento 2.-3

Marketplace Flutterwave for Magento 2.-refund

Under, the field Items to Refund the seller can click the checkbox return to stock and lastly click the button Refund/Refund Offline.

As a result, if the seller clicks the button Refund it will be done using the Flutterwave Payment method. Else, it will be done offline on its own if used Refund Offline.

Admin Refund – Flutterwave Payment Method

To initiate a refund from the admin end the admin can go to the Sales > Order open the Invoice section and click Credit Memo.


Further, the admin can click the checkbox return to stock and click the button Refund to complete the refund using the Flutterwave marketplace payment method.


magento 2-marketplace-flutterwave-payment-transaction-status

As a result, if the admin clicks the button Refund it will be done using the Flutterwave Payment method. Else, it will be done offline on its own if used Refund Offline.

That’s all for the Marketplace Flutterwave for Magento 2 (Adobe Commerce). If you still have any questions regarding the module please create a support ticket by clicking here or send an email to [email protected]

Explore the Adobe Commerce Cloud development service by Webkul. You may also browse other Magento 2 marketplace addons. Also our quality Magento 2 extensions.

Current Product Version - 5.0.1-p1

Supported Framework Version - 2.0.x , 2.1.x, 2.2.x, 2.3.x, 2.4.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