PHPackages aziendeglobal/laravel-mercadopago-rest - 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. aziendeglobal/laravel-mercadopago-rest ActiveLibrary[Payment Processing](/categories/payments) aziendeglobal/laravel-mercadopago-rest ====================================== Integración optimizada de Mercado Pago para Laravel usando HTTP Client nativo. 1.0.3(5mo ago)03MITPHPPHP ^7.4|^8.0 Since Dec 5Pushed 5mo agoCompare [ Source](https://github.com/aziendeglobal/laravel-mercadopago-rest)[ Packagist](https://packagist.org/packages/aziendeglobal/laravel-mercadopago-rest)[ RSS](/packages/aziendeglobal-laravel-mercadopago-rest/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (4)Dependencies (2)Versions (5)Used By (0) Laravel MercadoPago REST ======================== [](#laravel-mercadopago-rest) [![Latest Stable Version](https://camo.githubusercontent.com/5008ca73d8d9eeee19cda60ce0abc7102c17725ac0dd9bda9b129b00558a4b3d/68747470733a2f2f706f7365722e707567782e6f72672f617a69656e6465676c6f62616c2f6c61726176656c2d6d65726361646f7061676f2d726573742f762f737461626c65)](https://packagist.org/packages/aziendeglobal/laravel-mercadopago-rest)[![Total Downloads](https://camo.githubusercontent.com/653fc2b2b3b84ffbf76dea41492e78ec6f714cece539eced92a385557a9ab76a/68747470733a2f2f706f7365722e707567782e6f72672f617a69656e6465676c6f62616c2f6c61726176656c2d6d65726361646f7061676f2d726573742f646f776e6c6f616473)](https://packagist.org/packages/aziendeglobal/laravel-mercadopago-rest)[![License](https://camo.githubusercontent.com/c8f571c7d1e24dcdbca9fb33e4e9a67bb3f476029f6e434bd04488b65c60a4fd/68747470733a2f2f706f7365722e707567782e6f72672f617a69656e6465676c6f62616c2f6c61726176656c2d6d65726361646f7061676f2d726573742f6c6963656e7365)](https://packagist.org/packages/aziendeglobal/laravel-mercadopago-rest) Una integración optimizada, ligera y moderna de la API de Mercado Pago para **Laravel**. A diferencia del SDK oficial o paquetes antiguos, esta librería **no utiliza cURL nativo**. Está construida completamente sobre el **HTTP Client de Laravel (Guzzle Wrapper)**, lo que garantiza: - 🚀 **Mejor rendimiento:** Aprovecha el manejo de conexiones de Guzzle. - 🛡️ **Seguridad:** Manejo automático de certificados SSL y Timeouts. - 🧹 **Código Limpio:** Sin archivos `.pem` manuales ni variables globales. - 🐛 **Depuración:** Compatible con herramientas como Laravel Telescope o Ray. --- 📋 Requisitos ------------ [](#-requisitos) - PHP >= 7.4 - Laravel >= 8.x, 9.x, 10.x, 11.x, 12.x - Cuenta de desarrollador en Mercado Pago. 🚀 Instalación ------------- [](#-instalación) Instala el paquete mediante Composer: ``` composer require aziendeglobal/laravel-mercadopago-rest ``` ⚙️ Configuración ---------------- [](#️-configuración) 1. Publicar el archivo de configuración: Esto creará el archivo config/mercadopago.php. ``` php artisan vendor:publish --tag=mercadopago-config ``` 2. Configurar Variables de Entorno: Agrega tus credenciales en el archivo .env. Se recomienda encarecidamente usar el ACCESS\_TOKEN para integraciones modernas. ``` # Credenciales (Obtenidas en developers.mercadopago.com) MP_ACCESS_TOKEN=APP_USR-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx # Opcional: Integrator ID (Si eres partner) MP_INTEGRATOR_ID= # Legacy (Solo si no usas Access Token) MP_APP_ID= MP_APP_SECRET= ## ⚡ Uso Rápido (Facade) ``` El paquete incluye un Facade MP para acceder rápidamente a los métodos de forma estática. Crear una Preferencia de Pago (Checkout Pro) Este es el flujo para redirigir al usuario a pagar a Mercado Pago. ``` use MP; public function createPreference() { $preferenceData = [ "items" => [ [ "title" => "Suscripción Premium", "quantity" => 1, "currency_id" => "ARS", // MXN, BRL, USD, CLP... "unit_price" => 1500.00 ] ], "payer" => [ "email" => "cliente@ejemplo.com" ], "back_urls" => [ "success" => route('payment.success'), "failure" => route('payment.failure'), "pending" => route('payment.pending') ], "auto_return" => "approved", "external_reference" => "order_id_1234" // Tu ID de orden local ]; try { $preference = MP::create_preference($preferenceData); // Redirigir al usuario al Checkout de Mercado Pago return redirect($preference['response']['init_point']); } catch (\Exception $e) { return back()->with('error', $e->getMessage()); } } ``` 📡 Recibir Notificaciones (Webhooks) ----------------------------------- [](#-recibir-notificaciones-webhooks) Para recibir actualizaciones de estado de pagos en tiempo real (cuando el pago se acredita), configura una ruta en tu api.php. 1. Definir la ruta: ``` // routes/api.php use App\Http\Controllers\PaymentController; Route::post('/mp/webhook', [PaymentController::class, 'handleWebhook']); ``` 2. Crear el controlador: ``` // App/Http/Controllers/PaymentController.php namespace App\Http\Controllers; use Illuminate\Http\Request; use MP; class PaymentController extends Controller { public function handleWebhook(Request $request) { // Mercado Pago envía el ID y el tipo en el body o query params $type = $request->input('type') ?? $request->input('topic'); $id = $request->input('data.id') ?? $request->input('id'); if ($type === 'payment') { // Importante: Consultar el estado real a la API para verificar autenticidad $payment = MP::get_payment($id); if ($payment['status'] == 200) { $status = $payment['response']['status']; $externalRef = $payment['response']['external_reference']; if ($status === 'approved') { // TODO: Activar la orden en tu base de datos usando $externalRef } } } return response()->json(['status' => 'ok'], 200); } } ``` 🧪 Pruebas y Sandbox ------------------- [](#-pruebas-y-sandbox) Activar modo Sandbox Puedes forzar el modo Sandbox en tiempo de ejecución. Esto hará que las peticiones vayan al entorno de pruebas. ``` MP::sandbox_mode(true); ``` Crear Usuarios de Prueba Mercado Pago requiere usuarios "Test" (Comprador y Vendedor) para probar pagos en Sandbox sin usar dinero real. ``` // Crear un usuario de prueba $testUser = MP::create_user_test([ "site_id" => "MLA" // Cambiar según tu país: MLM, MLB, MCO, etc. ]); // Guarda estos datos para hacer tus pruebas echo "Email: " . $testUser['response']['email']; echo "Pass: " . $testUser['response']['password']; ``` 🔄 Suscripciones (Preapproval) ----------------------------- [](#-suscripciones-preapproval) Para cobros recurrentes (débitos automáticos). ``` $preapproval_data = [ "payer_email" => "cliente@test.com", "back_url" => "[https://mitienda.com/success](https://mitienda.com/success)", "reason" => "Suscripción Mensual", "external_reference" => "sub_123", "auto_recurring" => [ "frequency" => 1, "frequency_type" => "months", "transaction_amount" => 1000, "currency_id" => "ARS" ] ]; $subscription = MP::create_preapproval_payment($preapproval_data); // Redirigir al usuario a suscribirse return redirect($subscription['response']['init_point']); ``` 🛠️ Métodos Disponibles ---------------------- [](#️-métodos-disponibles) Pagos (Collections) ``` MP::get_payment($id) MP::search_payment($filters, $offset, $limit) MP::cancel_payment($id) MP::refund_payment($id) (Devolución total) ``` Preferencias (Checkout) ``` MP::create_preference($data) MP::update_preference($id, $data) MP::get_preference($id) ``` Suscripciones (Preapprovals) ``` MP::create_preapproval_payment($data) MP::get_preapproval_payment($id) MP::cancel_preapproval_payment($id) MP::create_preapproval_plan_payment($data) MP::update_preapproval_plan_payment($id, $data) ``` Genéricos (Para endpoints no listados) Si Mercado Pago lanza un endpoint nuevo que no está listado aquí, puedes usar los métodos genéricos. El paquete se encarga de la autenticación. ``` // GET $res = MP::get('/v1/payment_methods'); // POST $res = MP::post('/v1/advanced_payments', $dataArray); ``` 💉 Inyección de Dependencias --------------------------- [](#-inyección-de-dependencias) Si prefieres no usar Facades, puedes inyectar la clase directamente en tus controladores. ``` use AziendeGlobal\LaravelMercadoPago\MP; class PaymentController extends Controller { protected $mp; public function __construct(MP $mp) { $this->mp = $mp; } public function checkStatus($id) { return $this->mp->get_payment($id); } } ``` 📝 Estructura de Respuesta ------------------------- [](#-estructura-de-respuesta) Todas las respuestas de la librería siguen este formato estandarizado para facilitar el manejo de errores: ``` [ "status" => 200, // Código HTTP (200, 201, 400, 404, etc.) "response" => [ ... ] // JSON decodificado de Mercado Pago con la data ] ``` Licencia -------- [](#licencia) The MIT License (MIT). Por favor ve el Archivo de Licencia para más información. ### Health Score 33 — LowBetter than 75% of packages Maintenance72 Regular maintenance activity Popularity3 Limited adoption so far Community6 Small or concentrated contributor base Maturity43 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% 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 4 Last Release 159d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/045a238e164508f12aba37906829772b7796f776f7895d7f90e106672aaa91f6?d=identicon)[aziendeglobal](/maintainers/aziendeglobal) --- Top Contributors [![nicolas-buzz](https://avatars.githubusercontent.com/u/174024099?v=4)](https://github.com/nicolas-buzz "nicolas-buzz (5 commits)") ### Embed Badge ![Health badge](/badges/aziendeglobal-laravel-mercadopago-rest/health.svg) ``` [![Health](https://phpackages.com/badges/aziendeglobal-laravel-mercadopago-rest/health.svg)](https://phpackages.com/packages/aziendeglobal-laravel-mercadopago-rest) ``` ### Alternatives [laraveldaily/laravel-invoices Missing invoices for Laravel 1.5k1.3M4](/packages/laraveldaily-laravel-invoices)[musahmusah/laravel-multipayment-gateways A Laravel Package that makes implementation of multiple payment Gateways endpoints and webhooks seamless 852.2k1](/packages/musahmusah-laravel-multipayment-gateways)[aedart/athenaeum Athenaeum is a mono repository; a collection of various PHP packages 245.2k](/packages/aedart-athenaeum)[asciisd/knet Knet package is provides an expressive, fluent interface to KNet's payment services. 141.1k](/packages/asciisd-knet) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)