Guide for Adobe Commerce Multi Vendor Flutterwave
Table of Content
Introduction
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.
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.
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.
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 escrow.com, 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.
Note:
- 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.
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.
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.
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.
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.
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.
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.
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.
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 support@webkul.com
Explore the Adobe Commerce Cloud development service by Webkul. You may also browse other Magento 2 marketplace addons. Also our quality Magento 2 extensions.