Looking to hire Laravel developers? Try LaraJobs

payments-laravel maintained by abitechdev

Description
Cobra, reembolsa, suscribe y recibe webhooks de Mercado Pago y Stripe en Laravel con una sola interfaz.
Last update
2026/11/15 22:14 (dev-main)
License
Downloads
2

Comments
comments powered by Disqus

Cobrar, reembolsar, suscribir y recibir los avisos de Mercado Pago y Stripe con el mismo código. Tu app arma un PaymentRequest, elige el driver y recibe una respuesta normalizada. El paquete habla con la pasarela, verifica la firma de sus webhooks y devuelve DTO iguales para las dos. Tu app guarda, deduplica y decide.

Inicio rápido

1. Instala el paquete. Laravel lo registra solo.

composer require abitechdev/payments-laravel

2. Agrega las credenciales de tu pasarela al .env.

ABITECH_PAYMENTS_DEFAULT=mercadopago_checkout
MERCADOPAGO_ACCESS_TOKEN=APP_USR-...

3. Cobra con el driver que elijas.

use Abitech\Payments\DTO\PaymentRequest;
use Abitech\Payments\Facades\Payment;

$respuesta = Payment::driver('mercadopago_checkout')->purchase(new PaymentRequest(
    amount: '100.00',
    currency: 'PEN',
    email: 'cliente@email.com',
    description: 'Suscripción mensual',
    idempotencyKey: request()->header('X-Idempotency-Key'),
    metadata: [
        'success_url' => route('billing.success'),
        'cancel_url' => route('billing.cancel'),
    ],
));

return redirect($respuesta->redirectUrl);

Características

Drivers disponibles

Driver Slug Tipo
Checkout Pro mercadopago_checkout Redirige a la pasarela
API (Bricks) mercadopago_api Cobro directo
Checkout stripe_checkout Redirige a la pasarela
PaymentIntents stripe_paymentintents Cobro directo
🧪 Pruebas fake Sin red

Requisitos

Componente Versión
PHP 8.2 o superior, con bcmath. Laravel 13 pide 8.3
Laravel 12.69 o superior, o 13.30 o superior
Mercado Pago mercadopago/dx-php 3.0.5 o superior (SDK)
Stripe stripe/stripe-php de la 17 a la 22 (SDK)

Instala solo el SDK de la pasarela que uses.

Webhooks

Define un endpoint por pasarela y entrega el request al driver. Con el *_WEBHOOK_SECRET configurado, el paquete verifica la firma y lanza PaymentGatewayException si no es válida. Configúralo siempre en producción.

use Abitech\Payments\Exceptions\PaymentGatewayException;
use Abitech\Payments\Facades\Payment;
use Illuminate\Http\Request;

Route::post('/webhooks/{gateway}', function (Request $request, string $gateway) {
    try {
        $resultado = Payment::driver($gateway)->handleWebhook($request);
    } catch (PaymentGatewayException $e) {
        return response()->noContent(400);
    }

    // Tu app guarda el aviso, deduplica y actualiza el pago.
    return response()->noContent();
});

Guarda el payload crudo antes de procesarlo. La guía de integración muestra el registro de avisos y los eventos que tu app puede disparar.

Variables de entorno

# General
ABITECH_PAYMENTS_DEFAULT=mercadopago_checkout
ABITECH_PAYMENTS_KEY_TYPE=uuid
ABITECH_PAYMENTS_DB_CONNECTION=null

# Mercado Pago
MERCADOPAGO_PUBLIC_KEY=
MERCADOPAGO_ACCESS_TOKEN=
MERCADOPAGO_CLIENT_ID=
MERCADOPAGO_CLIENT_SECRET=
MERCADOPAGO_WEBHOOK_SECRET=

# Stripe
STRIPE_KEY=
STRIPE_SECRET=
STRIPE_WEBHOOK_SECRET=

Para cambiar los reintentos, el límite de peticiones o la idempotencia, publica la configuración. Las migraciones crean las tablas base que usa el host.

php artisan vendor:publish --tag=abitech-payments-config
php artisan vendor:publish --tag=abitech-payments-migrations

Los montos son cadenas decimales en la unidad mayor ('19.99'), nunca float, en los DTO, en refund() y en WebhookResult::$amount. Un monto con otro formato, o con más decimales de los que admite la moneda en Stripe, lanza PaymentGatewayException 422. WebhookResult::$currency es el código ISO 4217 en mayúsculas ('PEN') en todas las pasarelas.

En una app con varios clientes, cada uno con su propia cuenta, pide el driver para un cliente concreto. Sus credenciales salen del resolvedor que registres.

Payment::forTenant($clienteId)->driver('stripe_checkout')->purchase($pedido);

En las pruebas

Usa el driver fake para probar cobros, suscripciones y webhooks sin credenciales ni red.

$respuesta = Payment::driver('fake')->purchase($pedido);

Más información

Licencia

Publicado con la licencia MIT. Puedes usarlo, modificarlo y distribuirlo, también en proyectos comerciales.