User Guide for Marketplace MercadoPago Payment Gateway

Laravel Marketplace Mercado Pago Payment Gateway lets your customers pay with Mercado Pago. Mercado Pago is a trusted payment service. It is very popular across Latin America.

This module is built for multi-vendor stores. So the payment splits on its own. The seller gets their share. The admin gets the commission. You do not have to split it by hand.

NOTE: Before you buy this module, please check Mercado Pago first. Visit mercadopago.com. Make sure the gateway works in your country.

Also, this module is an add-on. It works with the “Laravel Multi-Vendor Marketplace” extension. You must install that extension first. The add-on runs only on a marketplace based website.

Here is what the module can do:

• The admin can turn the module on or off from the admin panel.
• It splits the customer payment between the seller and admin.
• It accepts the cards that Mercado Pago supports.
• It lets sellers link their own Mercado Pago account.
• It gives two checkout modes: Checkout Pro and Custom Checkout.
• Buyers can pay on a hosted page or right on your store.
• It keeps your store safe with secure online payments.

INSTALLATION

Bagisto Version: v2.4.4

Marketplace Version: v2.4.4

Step 1: Extract Package

Unzip the extension package and merge the packages folder into your project root.

Step 2: Register Service Provider

Customers will get a zip folder after purchasing the extension and Unzip the extension zip and then merge the “packages” folders into the project root directory.

• Goto bootstrap/providers.php file and add the following line under ‘providers’

use Webkul\MarketplaceMercadoPago\Providers\MarketplaceMercadoPagoServiceProvider; 

return 
[
 MarketplaceMercadoPagoServiceProvider::class,
 ]

• Goto composer.json file and add following line under ‘psr-4’

"Webkul\\MarketplaceMercadoPago\\":"packages/Webkul/MarketplaceMercadoPago/src"

• Run these commands below to complete the setup

composer dump-autoload

composer require mercadopago/dx-php

php artisan marketplace-mercadopago:install

That is it. Now open the project on your domain.

MODULE CONFIGURATION

After you install the module, you can set it up. The admin does this from the admin panel.

Go to Configure > Sales > Payment Methods. You will see “Mercado Pago” there.

Here are the settings you can change:

• Status: Turn the module on or off.
• Checkout Type: Pick how buyers pay.
  • Choose “Checkout Pro” for a hosted page.
  • Choose “Custom Checkout API” to pay on your store.
• Style: Pick a look for the card form. You can choose Dark, Bootstrap, or Flat.
• Title: Set the name shown to buyers on the store.
• Description: Add the text shown on the checkout page.
• Sandbox: Turn debug mode on or off for testing.
• Client ID: Add the Client ID from Mercado Pago. It links the seller account.
• Client Secret: Add the Client Secret from Mercado Pago.
• API Key (Access Token): Add the live key. Use this in Production Mode.
• API Publishable Key (Public Key): Add the live public key. Use this in Production Mode.
• Test Public Key: Add the test key. Use this while you test.
• Test Access Token: Add the test public key for testing.
• Image: Upload a logo for the payment method.
• Sort Order: Set the order. It decides where the method shows
  on the payment page.

MERCADO PAGO ACCOUNTS | ADMIN

The admin can see the linked seller accounts. Just go to Marketplace > Mercado Pago Accounts.

This page shows all sellers who joined Mercado Pago. The admin can check the status of each seller account from here.

SELLER PANEL

After the install, sellers get a new menu. It is called “Mercado Pago” in the seller panel.

When the seller clicks Connect, they go to Mercado Pago. There they link their own account.

Once linked, the seller comes back to their account section. Now they are ready to receive their share of each sale.

The seller can also unlink their account. They just click the revoke option on the same page.

CUSTOMER CHECKOUT

The buyer picks Mercado Pago at checkout. Then they place the order.

With Checkout Pro, the buyer goes to the Mercado Pago page. There they pay in a safe way.

With Custom Checkout, the buyer pays right on your store. They fill in the card form and click Pay.

After a good payment, the buyer gets an order ID. They can see the order status and details in their order history.

SELLER ORDER DETAILS

After a sale, the seller can view the order details. These details include information about orders placed through the marketplace.

This helps the seller track and manage orders with ease.

NEED HELP?

We hope this guide helps you. Do you still have a question? Feel free to raise a ticket. Just visit: https://bagisto.uvdesk.com/en