payments-laravel maintained by abitechdev
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
- 📚 Guías: integración en tu app, arquitectura y migraciones.
- 💳 Referencias: Mercado Pago y Stripe.
- 🔒 Política de seguridad. Las vulnerabilidades se reportan en privado.
- 🤝 Guía para contribuir. Las propuestas son bienvenidas.
- 📝 Cambios de cada versión.
Licencia
Publicado con la licencia MIT. Puedes usarlo, modificarlo y distribuirlo, también en proyectos comerciales.