Ir al contenido
ArionPay

Biblioteca para Java

Acepta pagos en cripto en tu app de Java

Crea facturas en cripto desde tu servicio en Java o Kotlin y verifica webhooks firmados, solo con el JDK. El dinero va directo a tu propia billetera.

Instalar

implementation("com.arionpay:arionpay-java:1.0.0")
Código fuente en GitHub
Ejemplo

Qué hace

ArionPay para desarrolladores de Java

arionpay-java es el cliente oficial de ArionPay para Java 11 o posterior. Solo necesita el JDK (java.net.http), guarda los precios en moneda fiat como BigDecimal y los importes en cripto como texto, y comprueba las firmas de los webhooks sobre el cuerpo sin procesar.
Leer másUna factura de webhook y un resultado de getInvoice son la misma clase Invoice, así que un solo método puede procesar ambos. ArionPay nunca custodia el dinero: va directo a tu propia billetera.
  • Sin dependencias: solo el JDK (java.net.http). Java 11 o posterior.
  • Importes exactos: los precios fiat son BigDecimal y los importes en cripto se guardan como texto, nunca como un double redondeado.
  • Cada solicitud de factura lleva una clave de idempotencia, así que un error de red nunca puede crear dos facturas.
  • verifyWebhook comprueba la firma sobre el cuerpo sin procesar y lanza SignatureException cuando no coincide o tiene más de 5 minutos.
  • inv.matches(order total, currency) compara el total del pedido al centavo antes de que entregues.
  • El cliente se puede compartir de forma segura entre hilos: créalo una sola vez, por ejemplo como un bean de Spring.
  • Cada archivo en Maven Central está firmado con la clave de publicación de ArionPay.

Requisitos y licencia

Funciona con
Java 11 o posterior · Spring Boot, Jakarta Servlet, Micronaut, Quarkus, Javalin, Java puro, Kotlin · solo el JDK
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

    Añade la dependencia

    Con Gradle: implementation("com.arionpay:arionpay-java:1.0.0"). Con Maven: groupId com.arionpay, artifactId arionpay-java, version 1.0.0.

  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. Pásalos a ArionPay.builder().

  3. Paso 3

    Crear una factura

    Llama a createInvoice(new InvoiceParams("49.90").currency("USD").orderId("1001")) y luego envía al cliente a invoice.getInvoiceUrl().

  4. Paso 4

    Verifica el webhook

    Configura la dirección de tu webhook en la página Webhooks, o por factura con callbackUrl(...). Toma el cuerpo como byte[], pásalo a verifyWebhook con el encabezado ArionPay-Signature y entrega con invoice.paid.

  5. Paso 5

    Prueba sin dinero real

    Crea una factura con .asset("USDT_TRC20").test(true) y luego llama a simulatePayment(inv.getId(), "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(id).isPaid()). Coming back to the success URL does not prove payment.
  • Antes de entregar, comprueba que la factura corresponde a tu pedido: tu id de pedido o metadata, e inv.matches(order.getTotal(), order.getCurrency()).
  • 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 enviarlo durante unos 3 días cuando tu servidor no responde con 2xx. Procesa cada event.getId() 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 Java

Respuestas breves antes de empezar a programar.

Sí. Toma el cuerpo del webhook como @RequestBody byte[] y pásalo a verifyWebhook con el encabezado ArionPay-Signature. Si usas Spring Security, excluye esa ruta de la protección CSRF.

Bibliotecas para desarrolladores