Gem para Ruby
Acepta pagos en cripto en tu app de Ruby
Crea facturas en cripto desde tu app de Rails, Sinatra o Rack y verifica el webhook firmado cuando el cliente pague. El dinero va directo a tu propia billetera.
Instalar
gem install arionpayQué hace
ArionPay para desarrolladores de Ruby
Leer más
Las facturas son Hashes con los mismos nombres de campo que el webhook, así que un solo método puede procesar un webhook y una lectura. ArionPay nunca custodia el dinero: va directo a tu propia billetera.- Sin dependencias (solo la biblioteca estándar). Ruby 3.0 o posterior.
- Ejemplos en el README para Rails, Sinatra y Rack puro. Hanami y los scripts simples también funcionan.
- Cada solicitud de factura lleva una clave de idempotencia, así que un error de red nunca puede crear dos facturas.
- verify_webhook comprueba la firma sobre el cuerpo sin procesar y lanza ArionPay::SignatureError cuando no coincide o tiene más de 5 minutos.
- ArionPay.order_matches?(invoice, "49.90", "USD") comprueba el total del pedido al centavo antes de que entregues.
- Un cliente se puede compartir de forma segura entre hilos (Puma, Sidekiq).
- Los argumentos incorrectos lanzan ArgumentError antes de enviar nada. Los errores de la API son ArionPay::APIError, y los mensajes nunca contienen tu secreto.
Requisitos y licencia
- Funciona con
- Ruby 3.0 o posterior · Rails, Sinatra, Hanami, cualquier app Rack o scripts simples · solo la biblioteca estándar
- 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 gem
Ejecuta gem install arionpay, o añade gem "arionpay" a tu Gemfile.
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 las credentials de Rails.
Paso 3
Crear una factura
Llama a create_invoice con amount:, currency: y order_id:, y luego redirige al cliente a invoice["invoiceUrl"].
Paso 4
Verifica el webhook
Configura la dirección de tu webhook en la página Webhooks, o por factura con callback_url:. Pasa el cuerpo sin procesar (request.raw_post en Rails) y el encabezado ArionPay-Signature a verify_webhook, y entrega con invoice.paid.
Paso 5
Prueba sin dinero real
Crea una factura con test: true y un asset como USDT_TRC20, y luego llama a simulate_payment(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: pagada por completo y confirmada, o aceptada por ti a mano en el panel. Entrega solo con este evento (o cuando get_invoice indique paid). Volver a success_url no demuestra el pago.
- Antes de entregar, comprueba que la factura corresponde a tu pedido: tu order_id o metadata, y ArionPay.order_matches? para el importe y la moneda.
- 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 event["id"] una sola vez y responde rápido; envía los correos desde un job en segundo plano.
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 Ruby
Respuestas breves antes de empezar a programar.