コンテンツへスキップ
ArionPay

Javaライブラリ

Javaアプリで暗号資産決済を受け付け

JavaまたはKotlinのサービスから暗号資産の請求書を作成し、JDKだけで署名付きWebhookを検証します。資金はご自身のウォレットに直接届きます。

インストール

implementation("com.arionpay:arionpay-java:1.0.0")
GitHubのソースコード
例

機能

Java開発者向けArionPay

arionpay-javaは、Java 11以降向けのArionPay公式クライアントです。必要なのはJDK(java.net.http)だけで、法定通貨の価格をBigDecimalで、暗号資産の金額をテキストで保持し、生のボディでWebhook署名を検証します。
続きを読む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. ステップ1

    依存関係を追加

    Gradleの場合:implementation("com.arionpay:arionpay-java:1.0.0")。Mavenの場合:groupId com.arionpay、artifactId arionpay-java、version 1.0.0。

  2. ステップ2

    キーをコピー

    ArionPayダッシュボードでストアを開き、APIキー(pk_)とAPIシークレット(sk_。表示時に認証アプリのコードを求められます)をコピーします。Webhook署名シークレット(whsec_)は「Webhooks」ページにあります。これらをArionPay.builder()に渡します。

  3. ステップ3

    請求書を作成

    createInvoice(new InvoiceParams("49.90").currency("USD").orderId("1001"))を呼び出し、顧客をinvoice.getInvoiceUrl()に誘導します。

  4. ステップ4

    Webhookを検証

    「Webhooks」ページでWebhookアドレスを設定するか、請求書ごとにcallbackUrl(...)で指定します。ボディをbyte[]として受け取り、ArionPay-SignatureヘッダーとともにverifyWebhookに渡して、invoice.paidで商品を提供します。

  5. ステップ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ライブラリに関するよくある質問

コードに組み込む前に知っておきたいことを簡潔にお答えします。

はい。Webhookのボディを@RequestBody byte[]として受け取り、ArionPay-SignatureヘッダーとともにverifyWebhookに渡します。Spring Securityを使っている場合は、そのパスをCSRF保護の対象から外してください。

開発者向けライブラリ