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")Qué hace
ArionPay para desarrolladores de Java
Leer más
Una 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
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.
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().
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().
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.
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.