Java 开发库
在您的 Java 应用中接受加密货币支付
从您的 Java 或 Kotlin 服务创建加密货币账单并校验签名 Webhook,只需 JDK。资金直接进入您自己的钱包。
安装
implementation("com.arionpay:arionpay-java:1.0.0")功能介绍
面向 Java 开发者的 ArionPay
阅读更多
Webhook 中的账单与 getInvoice 的结果是同一个 Invoice 类,因此一个方法即可同时处理两者。ArionPay 从不持有资金:款项直接进入您自己的钱包。- 无任何依赖:只需 JDK(java.net.http)。Java 11 或更高版本。
- 金额精确:法币价格为 BigDecimal,加密货币金额以文本保存,绝不会是四舍五入的 double。
- 每个账单请求都带有幂等键,因此网络错误绝不会创建两张账单。
- verifyWebhook 基于原始请求体校验签名;签名不匹配或超过 5 分钟时,会抛出 SignatureException。
- 交付前,inv.matches(order total, currency) 会精确到分地比对订单总额。
- 客户端可以在多个线程之间安全共享:只需构建一次,例如作为 Spring bean。
- Maven Central 上的每个文件都使用 ArionPay 发布密钥签名。
要求与许可证
- 适用于
- Java 11 或更高版本 · Spring Boot、Jakarta Servlet、Micronaut、Quarkus、Javalin、纯 Java、Kotlin · 仅依赖 JDK
- 费用
- 开发库免费。ArionPay 每笔付款收取 0.5% 手续费,无月费。
- 源代码
- 在 GitHub 上开源(MIT)。
设置
5 步完成设置
第 1 步
添加依赖
使用 Gradle:implementation("com.arionpay:arionpay-java:1.0.0")。使用 Maven:groupId 为 com.arionpay,artifactId 为 arionpay-java,version 为 1.0.0。
第 2 步
复制您的密钥
在您的 ArionPay 控制台中打开您的店铺,复制 API key(pk_)和 API secret(sk_,复制时需要输入验证器动态码)。Webhook 的 signing secret(whsec_)位于“Webhooks”页面。将它们传给 ArionPay.builder()。
第 3 步
创建账单
调用 createInvoice(new InvoiceParams("49.90").currency("USD").orderId("1001")),然后将客户引导至 invoice.getInvoiceUrl()。
第 4 步
校验 Webhook
在“Webhooks”页面设置您的 Webhook 地址,或用 callbackUrl(...) 为单张账单设置。以 byte[] 接收请求体,连同 ArionPay-Signature 请求头传给 verifyWebhook,并在收到 invoice.paid 时交付。
第 5 步
不用真钱进行测试
用 .asset("USDT_TRC20").test(true) 创建账单,然后调用 simulatePayment(inv.getId(), "exact")。您的 Webhook 会像真实付款一样收到 invoice.paid。
设置完成后
付款如何到达您的代码
- invoice.pending:已在网络上发现付款,正在等待确认。请暂勿交付。
- 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.
- 交付前,请将账单与您的订单核对:您的订单 id 或 metadata,以及 inv.matches(order.getTotal(), order.getCurrency())。
- invoice.partial、invoice.expired 和 invoice.needs_review 都不代表可以交付。逾期付款仍可能让已过期的账单变为已支付。
- 如果您的服务器没有返回 2xx,ArionPay 会在大约 3 天内重复发送。每个 event.getId() 只处理一次。
9 个网络上的 16 种币和代币
全部币种- BTCBitcoin
- ETHEthereum
- USDTEthereum
- USDCEthereum
- BNBBNB Smart Chain
- USDTBNB Smart Chain
- USDCBNB Smart Chain
- POLPolygon
- USDTPolygon
- USDCPolygon
- TRXTRON
- USDTTRON
- LTCLitecoin
- DOGEDogecoin
- BCHBitcoin Cash
- DASHDash
关于 ArionPay Java 开发库的问题
将它加入代码之前需要了解的简短解答。