Javaライブラリ
Javaアプリで暗号資産決済を受け付け
JavaまたはKotlinのサービスから暗号資産の請求書を作成し、JDKだけで署名付きWebhookを検証します。資金はご自身のウォレットに直接届きます。
インストール
implementation("com.arionpay:arionpay-java:1.0.0")機能
Java開発者向けArionPay
続きを読む
Webhookの請求書とgetInvoiceの結果は同じInvoiceクラスなので、1つのメソッドで両方を処理できます。ArionPayが資金を預かることはありません。資金はご自身のウォレットに直接届きます。- 依存関係なし:JDK(java.net.http)のみ。Java 11以降。
- 正確な金額:法定通貨の価格はBigDecimal、暗号資産の金額はテキストで保持し、丸められたdoubleにはしません。
- 請求書の各リクエストには冪等キー(idempotency key)が付くため、ネットワークエラーで請求書が二重に作成されることはありません。
- 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の手数料は1回の支払いにつき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キー(pk_)とAPIシークレット(sk_。表示時に認証アプリのコードを求められます)をコピーします。Webhook署名シークレット(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()は1回だけ処理してください。
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ライブラリに関するよくある質問
コードに組み込む前に知っておきたいことを簡潔にお答えします。