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-phpQué hace
ArionPay para desarrolladores de PHP
Leer más
Puedes 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
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'.
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.
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'].
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.
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.