PHPackages                             boreistudio/filament-mercado-pago - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. boreistudio/filament-mercado-pago

ActiveLibrary[Payment Processing](/categories/payments)

boreistudio/filament-mercado-pago
=================================

Seamless Mercado Pago integration

1.0.1(1y ago)6151MITPHPCI passing

Since Jun 27Pushed 3w agoCompare

[ Source](https://github.com/BoreiStudio/Filament-MercadoPago)[ Packagist](https://packagist.org/packages/boreistudio/filament-mercado-pago)[ RSS](/packages/boreistudio-filament-mercado-pago/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (1)Versions (3)Used By (0)

Filament MercadoPago Plugin
===========================

[](#filament-mercadopago-plugin)

A Filament v5 plugin that integrates Mercado Pago payments into your Laravel application. Supports Checkout Pro (online payments), Point (in-person terminal payments), QR codes, OAuth account connection, webhooks, refunds, and in-panel documentation.

Requirements
------------

[](#requirements)

- PHP 8.2+
- Laravel 11+ / 12+
- Filament 5.x

Installation
------------

[](#installation)

```
composer require boreistudio/filament-mercadopago
php artisan migrate
```

Register the plugin in your `PanelProvider`:

```
use BoreiStudio\FilamentMercadoPago\MercadoPagoPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugin(MercadoPagoPlugin::make());
}
```

Configuration
-------------

[](#configuration)

A **Settings → Mercado Pago → Credentials** page appears in the Filament panel for superadmins to configure the application credentials (`client_id`, `client_secret`, `webhook_secret`, country). All sensitive values are stored encrypted.

The plugin supports two modes:

- **Single-tenant**: one MP account for the whole app.
- **Multi-tenant**: each tenant connects their own MP account via OAuth.

The mode is auto-detected from your panel's tenancy configuration.

OAuth — Connect your Mercado Pago account
-----------------------------------------

[](#oauth--connect-your-mercado-pago-account)

Navigate to **Settings → Mercado Pago → Connect MP** and click **Connect with Mercado Pago**. After authorizing, tokens are stored encrypted in the database. Tokens are refreshed automatically before expiration.

Feature Toggles
---------------

[](#feature-toggles)

```
MercadoPagoPlugin::make()
    ->payments()           // Checkout Pro (default: true)
    ->point(false)         // Point terminals (default: false)
    ->qr(false)            // QR codes (default: false)
    ->stores(false)        // Stores & POS (auto-enabled by point/qr)
    ->dashboard(true)      // Dashboard widget (default: true)
    ->documentation(true)  // In-panel documentation (default: true)
    ->navigationGroup('Mercado Pago');
```

Documentation
-------------

[](#documentation)

Full documentation is available in the `docs/` directory and also accessible from the Filament panel at **Settings → Mercado Pago → Documentation**.

Security
--------

[](#security)

- All tokens (`access_token`, `refresh_token`, `client_secret`) are stored encrypted in the database.
- Webhook notifications are validated via HMAC-SHA256 signature before processing.
- Refund amounts are validated server-side before calling the MP API.
- No sensitive data is logged.
- See `SECURITY.md` for reporting vulnerabilities.

Testing
-------

[](#testing)

```
./vendor/bin/pest
```

Integration tests against the Mercado Pago sandbox are available under the `sandbox` group:

```
MERCADOPAGO_SANDBOX_ACCESS_TOKEN=TEST-... ./vendor/bin/pest --group=sandbox
```

Changelog
---------

[](#changelog)

See [CHANGELOG.md](CHANGELOG.md).

###  Health Score

35

—

LowBetter than 77% of packages

Maintenance73

Regular maintenance activity

Popularity12

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

 Bus Factor1

Top contributor holds 50% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

418d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/25154756?v=4)[MrMardel](/maintainers/MrMardel)[@MrMardel](https://github.com/MrMardel)

---

Top Contributors

[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")[![MrMardel](https://avatars.githubusercontent.com/u/25154756?v=4)](https://github.com/MrMardel "MrMardel (1 commits)")

### Embed Badge

![Health badge](/badges/boreistudio-filament-mercado-pago/health.svg)

```
[![Health](https://phpackages.com/badges/boreistudio-filament-mercado-pago/health.svg)](https://phpackages.com/packages/boreistudio-filament-mercado-pago)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)