Ir al contenido
ArionPay

Biblioteca para PHP

Acepta pagos en cripto en tu app de PHP

Crea una factura en cripto desde cualquier sitio PHP, envía al cliente a la página de pago y verifica el webhook firmado cuando pague. El dinero va directo a tu propia billetera.

Instalar

composer require arionpay/arionpay-php
Código fuente en GitHub
Ejemplo

Qué hace

ArionPay para desarrolladores de PHP

arionpay/arionpay-php es el cliente oficial de ArionPay para PHP 7.4 y posterior. No tiene dependencias: usa cURL si está instalado y, si no, los streams de PHP.
Leer másPuedes instalarla con Composer, o subir la carpeta y hacer require de su autoload.php, así que también sirve para hosting compartido. ArionPay nunca custodia el dinero: cada pago va directamente a tu propia billetera.
  • PHP 7.4 o posterior. Sin dependencias.
  • Usa cURL si está instalado y, si no, los streams de PHP. Nunca sigue redirecciones.
  • Funciona con Composer o sin él: copia la carpeta y haz require de autoload.php.
  • La misma idempotencyKey siempre devuelve la misma factura, así que recargar la página no crea una segunda. Si no pasas tu propia clave, una aleatoria protege los reintentos.
  • Firma cada solicitud de factura con HMAC-SHA256 y tu secreto de API. El secreto en sí nunca se envía.
  • Webhook::fromGlobals lee el cuerpo sin procesar y el encabezado ArionPay-Signature, y lanza SignatureException cuando la firma es incorrecta o tiene más de 5 minutos.
  • simulatePayment y sendTestWebhook te permiten probar todo el flujo sin dinero real.

Requisitos y licencia

Funciona con
PHP 7.4 o posterior · con o sin Composer, también en hosting compartido · cURL o streams de PHP
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 la biblioteca

    Ejecuta composer require arionpay/arionpay-php. Sin Composer, sube la carpeta junto a tu sitio y haz require __DIR__ . '/arionpay-php/autoload.php'.

  2. Paso 2

    Copia tus claves

    En tu panel de ArionPay, abre tu tienda y copia la clave de API (pk_) y el secreto de API (sk_; te pide tu código de autenticación). El secreto de firma del webhook (whsec_) está en la página Webhooks. Guárdalos en variables de entorno o en un archivo de configuración fuera de la raíz web.

  3. Paso 3

    Crear una factura

    Llama a createInvoice con el importe, la moneda, el orderId y una idempotencyKey, y luego redirige al cliente a $invoice['invoiceUrl'].

  4. Paso 4

    Verifica el webhook

    Configura una dirección https:// pública en el puerto 443 o 8443 en la página Webhooks, o por factura con callbackUrl. En ese script, llama a Webhook::fromGlobals($secret) y entrega el pedido con invoice.paid.

  5. Paso 5

    Prueba sin dinero real

    Crea una factura con 'test' => true y un activo como USDT_TRC20, y luego llama a simulatePayment($invoice['id'], 'exact'). Tu webhook recibe invoice.paid, como con un pago real.

Después de la configuración

Cómo llega un pago a tu código

  • invoice.pending: se detectó un pago en la red y espera confirmaciones. No entregues todavía.
  • invoice.paid: fully paid and confirmed, or accepted by you by hand in the dashboard. Deliver only on this event (or when getInvoice() says paid). Coming back to successUrl does not prove payment.
  • Antes de entregar, comprueba que la factura corresponde a tu pedido: tu orderId o metadata, y el mismo importe y la misma moneda que el total actual del pedido.
  • invoice.partial, invoice.expired e invoice.needs_review nunca significan que debas entregar. Un pago tardío todavía puede dejar pagada una factura vencida.
  • ArionPay vuelve a enviar durante unos 3 días cuando tu servidor no responde 2xx. Procesa cada id de evento una sola vez.

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 PHP

Respuestas breves antes de empezar a programar.

Sí. Sube la carpeta arionpay-php junto a tu sitio y haz require de su autoload.php. También funciona en hosting compartido.

Bibliotecas para desarrolladores