Ir al contenido
ArionPay

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-laravel
Código fuente en GitHub
Ejemplo

Qué hace

ArionPay para desarrolladores de Laravel

arionpay/arionpay-laravel se basa en la biblioteca oficial de PHP, para Laravel 10 a 13 con PHP 8.1 o posterior. Añade una ruta de webhook que comprueba cada actualización firmada y la lanza una sola vez como un evento normal de Laravel.
Leer másEn 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

  1. Paso 1

    Instala el paquete

    Ejecuta composer require arionpay/arionpay-laravel. Laravel detecta por sí solo el service provider y la facade ArionPay.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

Laravel 10 a 13 con PHP 8.1 o posterior. Se probó en Laravel 13.42 y 12 con un servidor real de ArionPay.

Bibliotecas para desarrolladores