Magento 2 Braintree Payment Gateway Marketplace Add-on allows the seller to add Braintree Payment Gateway for their products. This module is designed to simplify the payment process for online Magento store. Using this module customer can do the transaction with a reliable and secure payment gateway. It will provide an easy refund process to their customers. The admin and the seller both can refund the invoiced amount. And both have the option to partially refund the amount as well.
Note : Online refund by seller and admin will be applicable when the transaction status is “Settled”.
This module is an add-on of Magento2 Marketplace Module. To use this module you must have installed first Magento2 Marketplace.
- Allow all types of cards supported by the Braintree.
- Latest Braintree Drop-in UI used for checkout page.
- Fully PCI Compliant, no card details submitted to the client’s server.
- The admin can enable vault to store card details.
- The customer can re-use card details if saved in the vault.
- The admin can enable escrow seller fund to release in future.
- The admin can set to release escrow amount automatically (using cron, will execute daily at 1 am).
- The admin can define when to release escrow amount in the number of days.
- The admin can also manually release escrowed amount for a particular transaction in the order.
- The admin can refund the invoiced amount.
- The admin can partially refund invoiced amount.
- Enable/disable payment method from admin panel.
- The seller can refund Braintree transactions online.
- The seller can also partially refund the order.
- The payment automatically splits to sellers at the time of checkout
- The seller can become sub merchant by providing required details, and able to receive funds if payment is done by Marketplace Braintree Payment Method.
- Braintree hooks are used to check the sub-merchant status and update seller accordingly, and to inform the seller about transaction disbursement, cancel or any dispute.
Customers will get a zip folder and they have to extract the contents of this zip folder on their system. The extracted folder has an src folder, inside the src folder you have the app folder. You need to transfer this app folder into the Magento2 root directory on the server as shown below.
After the successful installation, you have to run these commands in the Magento2 root directory:
Second Command – php bin/magento setup:di:compile
Third Command – php bin/magento setup:static-content:deploy
After running the commands, you have to flush the cache from Magento admin panel by navigating through->System->Cache management as shown below.
Configuration For Multi-Lingual Support
If a user wants to translate their module from English to German then they need to follow the path app/code/Webkul/MpBraintree/i18n in their unzipped folder and will get a CSV file with name “en_US.csv”. Now they will rename that CSV as “de_DE.csv” and translate all right side content after the comma in the German language. After editing the CSV, save it and then upload it to the path app/code/Webkul/MpBraintree/i18n where they have installed Magento2 on the server. The module will get translated into the German Language. It supports both RTL and LTR languages.
After the successful installation of the Marketplace Braintree For Magento2 the admin of the marketplace can configure the plugin. The configuration will be done under “Stores > Configuration > Sales > Payment Methods > Marketplace Braintree Payment Gateway” as per the below snapshot.
Enabled – Select “Yes” if you want to enable the module. Else select “No”.
Title – Enter the name of the payment method as it will appear in the Payment Information list.
Environment – Here the admin can select the environment of Braintree. Whether it is “Sandbox” or “Production” as per the requirement.
Account Id – Here the admin will enter the Account Id which is provided by Braintree Payment Gateway.
Merchant Id – This option sets the Merchant Id which is provided by Braintree Payment Gateway.
Public Key – Here the admin will enter the Public Key which is provided by Braintree Payment Gateway.
Private Key – Here the admin will enter the Private which is provided by Braintree Payment Gateway.
Tokenization Key – Here admin enter the Tokenization Key collected from the Braintree.
Payment from Applicable Countries – Select which customers can use this payment method. All Allowed Countries means all customers from the default countries list can use this payment method. Admin can also select the payment method for the specified country.
Minimum Order Total – This option allows admin to set minimum order total. If Grand total of an order is less than specified Minimum Order Total value then Braintree module will not allow to check out with Braintree payment gateway.
Maximum Order Total – This option allows admin to set maximum order total.
Sort Order – Admin can enter the sort order. This will determine in what order each method is listed in the front-end.
Terms Of Services Link – Link of terms of services.
Vault Enabled – If this option is set as yes then buyer information will be saved in Braintree Otherwise buyer information will not be saved in Braintree. Please check the below image for better understanding.
Escrow Settings :
Hold In Escrow – Using this option admin can enable or disable Hold in Escrow setting. if hold in escrow is enabled then money is distributed to the seller but it will be on hold, when admin will release that money then the seller will get the money. Otherwise, money will be sent directly to sellers.
Auto Release – It depends on cron. If cron is active amount will be released automatically. Else release amount manually.
Release amount from escrow after days –
Enter days after which amount will be released from escrow.
Note- The admin can’t hold funds in escrow for longer than 30 days according to Braintree escrow guidelines.
If any customer wants to become a sub-merchant seller then he/she has to enter their Business Information and Funding Information under “Braintree Vendor Details”. Refer to the screenshot for the same.
If the seller wants to register as a business then he needs to check “Register as a business” checkbox to provide the business details. After that, the form will be updated as below image and the seller can provide business details as well.
If Magento Braintree Payment Gateway Method is enabled from the admin panel then the buyer can see this payment method inside his “Payment Information” as shown in the given screenshot.
The admin can see the transaction list in Braintree account under “Transactions”.
By clicking on a transaction the admin can find complete details of that transaction as well.
Marketplace Braintree Refund Management
The seller can do an online refund with the help of Magento Marketplace Braintree Payment method.
The admin can refund an order by clicking on “Credit Memo”.
The admin can generate a credit memo and can enter Adjustment fee, Adjustment shipping and can even refund shipping as well.
Webhooks In Marketplace Braintree
Webhooks are real-time notifications that alert you whenever an automated event occurs in our system. Magento Braintree Payment Gateway provides Webhook i.e “Sub-merchant account approved, Sub-merchant account declined, Transaction disbursed, Disbursement, Disbursement exception, Dispute opened, Dispute lost, Dispute won”.
Transaction disbursed, Disbursement, Disbursement exception– With these Webhooks, there is added an appropriate comment on the order.
Dispute opened, Dispute lost, Dispute won– Using “Dispute opened, Dispute lost, Dispute won”, transaction status will be automatically updated on Magento store.
Sub-merchant account approved, Sub-merchant account declined– Whenever any Braintree sub-merchant is created or updated then using “Sub-merchant account approved, Sub-merchant account declined” webhook notification, the seller will be updated automatically if sub-merchant is declined the seller will become a default user.
How to create Webhooks
From your Braintree Account navigate to “Settings > Webhooks” to view your webhooks.
Click on “Create New Webhook” to create a new Webhook.
That’s all for the Magento 2 Braintree Payment Gateway Marketplace Add-on, still have any issue, feel free to add a ticket and let us know your views to make the plugin better at webkul.uvdesk.com.
Current Product Version - 2.0.1
Supported Framework Version - Magento 2.0.x, 2.1.x, 2.2.x, 2.3.x