PHPackages                             boreistudio/filament-mercadopago - 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. boreistudio/filament-mercadopago

ActiveLibrary

boreistudio/filament-mercadopago
================================

Filament plugin for Mercado Pago integration — Checkout Pro, Point, QR, OAuth, Webhooks

v1.0.1(1mo ago)6191MITPHPPHP &gt;=8.3CI passing

Since Jul 17Pushed 1mo agoCompare

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

READMEChangelog (2)Dependencies (22)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

44

—

FairBetter than 90% of packages

Maintenance92

Actively maintained with recent releases

Popularity15

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 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 ~6 days

Total

2

Last Release

39d 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)")

---

Tags

laravelmercadopagofilament

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

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

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

###  Alternatives

[rawilk/profile-filament-plugin

Profile &amp; MFA starter kit for filament.

3915.5k](/packages/rawilk-profile-filament-plugin)[finity-labs/fin-mail

A powerful email template manager and composer for Filament with dynamic token replacement, template versioning, and inline email sending.

316.8k2](/packages/finity-labs-fin-mail)[codewithdennis/filament-select-tree

The multi-level select field enables you to make single selections from a predefined list of options that are organized into multiple levels or depths.

331634.0k37](/packages/codewithdennis-filament-select-tree)[stephenjude/filament-jetstream

A Laravel starter kit built with Filament inspired by Jetstream.

17863.7k3](/packages/stephenjude-filament-jetstream)[tapp/filament-maillog

Filament plugin to view outgoing mail

3084.0k1](/packages/tapp-filament-maillog)[tapp/filament-form-builder

User facing form builder using Filament components

133.9k6](/packages/tapp-filament-form-builder)

PHPackages © 2026

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