Ir al contenido
ArionPay

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

Qué hace

ArionPay para desarrolladores de Ruby

La gem arionpay es el cliente oficial de ArionPay para Ruby 3.0 o posterior, y solo usa la biblioteca estándar. Crea y lee facturas, comprueba las firmas de los webhooks sobre el cuerpo sin procesar y hace pasar las facturas de prueba por distintos escenarios de pago.
Leer másLas 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

  1. Paso 1

    Instala la gem

    Ejecuta gem install arionpay, o añade gem "arionpay" a tu Gemfile.

  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 las credentials de Rails.

  3. Paso 3

    Crear una factura

    Llama a create_invoice con amount:, currency: y order_id:, y luego redirige al cliente a invoice["invoiceUrl"].

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

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

Sí. En un controlador basado en ActionController::API, o con skip_forgery_protection, pasa request.raw_post y request.headers["ArionPay-Signature"] a verify_webhook. Captura ArionPay::SignatureError con rescue y responde 401.

Bibliotecas para desarrolladores