Paquete para Laravel
Acepta pagos en cripto en tu app de Laravel
Crea una factura con ArionPay::createInvoice y entrega el pedido en un listener de InvoicePaid. El paquete comprueba por ti la firma, el modo de prueba o real y las entregas duplicadas.
Instalar
composer require arionpay/arionpay-laravelQué hace
ArionPay para desarrolladores de Laravel
Leer más
En modo de prueba, cada factura nueva es una factura de prueba, así que puedes probar todo el flujo sin dinero real. Los pagos van directamente a tu propia billetera: ArionPay nunca los custodia.- ArionPay::createInvoice([...]) te da la dirección de la página de pago (invoiceUrl).
- Las actualizaciones de pago llegan como eventos de Laravel: InvoicePaid, InvoicePending, InvoicePartial, InvoiceExpired, InvoiceNeedsReview y TestWebhookReceived.
- La ruta POST /arionpay/webhook comprueba el ArionPay-Signature sobre el cuerpo exacto (margen de 5 minutos). Cualquier otra cosa recibe 401 y no se dispara ningún evento.
- Cada evento se dispara una sola vez: se recuerda en tu caché durante 96 horas.
- ARIONPAY_TEST_MODE=true hace que las facturas nuevas sean de prueba y solo acepta webhooks de prueba. Si no coinciden, se responde 409.
- php artisan arionpay:check comprueba tus claves y muestra la dirección del webhook. php artisan arionpay:test-webhook pide a ArionPay un evento de ejemplo firmado.
- Cada evento tiene matches($amount, $currency), invoiceId(), orderId() y metadata() para asociarlo al pedido.
Requisitos y licencia
- Funciona con
- Laravel 10 a 13 · PHP 8.1 o posterior · basado en arionpay/arionpay-php
- Probado
- Laravel 13.42 y 12, con un servidor real de ArionPay
- Precio
- La biblioteca es gratuita. ArionPay cobra un 0.5% por pago, sin cuota mensual.
- Código fuente
- Código abierto (MIT) en GitHub.
Configuración
Configúralo en 5 pasos
Paso 1
Instala el paquete
Ejecuta composer require arionpay/arionpay-laravel. Laravel detecta por sí solo el service provider y la facade ArionPay.
Paso 2
Añade tus claves a .env
Define ARIONPAY_API_KEY (pk_), ARIONPAY_API_SECRET (sk_) y ARIONPAY_WEBHOOK_SECRET (whsec_) con los datos de tu panel de ArionPay, y ARIONPAY_TEST_MODE=true. Luego ejecuta php artisan arionpay:check.
Paso 3
Crear una factura
Llama a ArionPay::createInvoice con el importe, el orderId y una idempotencyKey como 'order-' . $order->id, y redirige a $invoice['invoiceUrl']. La factura envía sus actualizaciones a la ruta de webhook de tu app, salvo que pases tu propia callbackUrl.
Paso 4
Entrega con InvoicePaid
Escucha ArionPay\Laravel\Events\InvoicePaid, busca el pedido, comprueba $event->matches($order->total, $order->currency) y luego entrega. Si un listener lanza una excepción, la ruta responde 500 y ArionPay vuelve a enviar más tarde.
Paso 5
Prueba y luego cobra de verdad
En modo de prueba, crea una factura con 'asset' => 'USDT_TRC20' y llama a ArionPay::simulatePayment($invoice['id'], 'exact'), o usa los botones Try a test payment del panel. Define ARIONPAY_TEST_MODE=false para los pagos reales.
Después de la configuración
Cómo llega un pago a tu código
- InvoicePaid: pagada por completo y confirmada, así que entrega. También se dispara con pagos tardíos, pequeñas diferencias dentro de tu tolerancia de pago (1% de forma predeterminada) y pagos que aceptas en Payment Radar.
- InvoicePending: se detectó el pago en la red y espera confirmaciones. No entregues todavía.
- InvoicePartial e InvoiceExpired: no está pagada por completo. Todavía puede llegar un pago tardío como InvoicePaid.
- InvoiceNeedsReview: decide en tu panel de ArionPay. Si lo aceptas, llega InvoicePaid.
- TestWebhookReceived: un ejemplo de "Send test webhook" sobre una factura inventada. Nunca entregues por él.
16 monedas y tokens en 9 redes
Todas las monedas- BTCBitcoin
- ETHEthereum
- USDTEthereum
- USDCEthereum
- BNBBNB Smart Chain
- USDTBNB Smart Chain
- USDCBNB Smart Chain
- POLPolygon
- USDTPolygon
- USDCPolygon
- TRXTRON
- USDTTRON
- LTCLitecoin
- DOGEDogecoin
- BCHBitcoin Cash
- DASHDash
Preguntas sobre la biblioteca de ArionPay para Laravel
Respuestas breves antes de empezar a programar.