Zum Inhalt springen
ArionPay

Java-Bibliothek

Kryptozahlungen in Ihrer Java-App annehmen

Erstellen Sie Krypto-Rechnungen aus Ihrem Java- oder Kotlin-Service und prüfen Sie signierte Webhooks, nur mit dem JDK. Das Geld geht direkt an Ihre eigene Wallet.

Installieren

implementation("com.arionpay:arionpay-java:1.0.0")
Quellcode auf GitHub
Beispiel

Was es leistet

ArionPay für Java-Entwickler

arionpay-java ist der offizielle ArionPay-Client für Java 11 oder neuer. Er braucht nur das JDK (java.net.http), hält Fiat-Preise als BigDecimal und Krypto-Beträge als Text und prüft Webhook-Signaturen auf dem Raw Body.
WeiterlesenEine Webhook-Rechnung und ein getInvoice-Ergebnis sind dieselbe Klasse Invoice, sodass eine Methode beides verarbeiten kann. ArionPay verwahrt das Geld nie: Es geht direkt an Ihre eigene Wallet.
  • Keine Abhängigkeiten: nur das JDK (java.net.http). Java 11 oder neuer.
  • Exakte Beträge: Fiat-Preise sind BigDecimal, Kryptobeträge werden als Text gespeichert, nie als gerundeter double.
  • Jede Rechnungsanfrage enthält einen Idempotency-Key, sodass ein Netzwerkfehler nie zwei Rechnungen erzeugen kann.
  • verifyWebhook prüft die Signatur auf dem Raw Body und wirft SignatureException, wenn sie nicht passt oder älter als 5 Minuten ist.
  • inv.matches(order total, currency) vergleicht vor der Lieferung die Bestellsumme auf den Cent genau.
  • Der Client kann sicher zwischen Threads geteilt werden: Erstellen Sie ihn einmal, zum Beispiel als Spring Bean.
  • Jede Datei auf Maven Central ist mit dem Release-Schlüssel von ArionPay signiert.

Voraussetzungen und Lizenz

Funktioniert mit
Java 11 oder neuer · Spring Boot, Jakarta Servlet, Micronaut, Quarkus, Javalin, reines Java, Kotlin · nur JDK
Kosten
Die Bibliothek ist kostenlos. ArionPay berechnet 0,5 % pro Zahlung, ohne Monatsgebühr.
Quellcode
Open Source (MIT) auf GitHub.

Einrichtung

In 5 Schritten eingerichtet

  1. Schritt 1

    Abhängigkeit hinzufügen

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

  2. Schritt 2

    Schlüssel kopieren

    Öffnen Sie in Ihrem ArionPay-Dashboard Ihren Shop und kopieren Sie den API-Schlüssel (pk_) und das API-Secret (sk_; dafür wird Ihr Authenticator-Code abgefragt). Das Webhook-Signing-Secret (whsec_) finden Sie auf der Seite „Webhooks“. Übergeben Sie sie an ArionPay.builder().

  3. Schritt 3

    Rechnung erstellen

    Rufen Sie createInvoice(new InvoiceParams("49.90").currency("USD").orderId("1001")) auf und leiten Sie den Kunden dann zu invoice.getInvoiceUrl() weiter.

  4. Schritt 4

    Webhook prüfen

    Legen Sie Ihre Webhook-Adresse auf der Seite „Webhooks“ fest oder pro Rechnung mit callbackUrl(...). Nehmen Sie den Body als byte[] entgegen, übergeben Sie ihn mit dem Header ArionPay-Signature an verifyWebhook und liefern Sie bei invoice.paid aus.

  5. Schritt 5

    Ohne echtes Geld testen

    Erstellen Sie eine Rechnung mit .asset("USDT_TRC20").test(true) und rufen Sie dann simulatePayment(inv.getId(), "exact") auf. Ihr Webhook erhält invoice.paid, wie bei einer echten Zahlung.

Nach der Einrichtung

So erreicht eine Zahlung Ihren Code

  • invoice.pending: Eine Zahlung wurde im Netzwerk erkannt und wartet auf Bestätigungen. Noch nicht liefern.
  • 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.
  • Gleichen Sie vor der Lieferung die Rechnung mit Ihrer Bestellung ab: Ihre Bestell-ID oder metadata sowie inv.matches(order.getTotal(), order.getCurrency()).
  • invoice.partial, invoice.expired und invoice.needs_review bedeuten nie, dass Sie liefern sollen. Eine verspätete Zahlung kann eine abgelaufene Rechnung trotzdem noch auf bezahlt setzen.
  • ArionPay sendet etwa 3 Tage lang erneut, wenn Ihr Server nicht mit 2xx antwortet. Verarbeiten Sie jede event.getId() nur einmal.

16 Coins und Token in 9 Netzwerken

Alle Coins
  • BTCBitcoin
  • ETHEthereum
  • USDTEthereum
  • USDCEthereum
  • BNBBNB Smart Chain
  • USDTBNB Smart Chain
  • USDCBNB Smart Chain
  • POLPolygon
  • USDTPolygon
  • USDCPolygon
  • TRXTRON
  • USDTTRON
  • LTCLitecoin
  • DOGEDogecoin
  • BCHBitcoin Cash
  • DASHDash

Fragen zur ArionPay-Bibliothek für Java

Kurze Antworten, bevor Sie sie in Ihren Code einbauen.

Ja. Nehmen Sie den Webhook-Body als @RequestBody byte[] entgegen und übergeben Sie ihn mit dem Header ArionPay-Signature an verifyWebhook. Wenn Sie Spring Security nutzen, nehmen Sie diesen Pfad vom CSRF-Schutz aus.

Entwickler-Bibliotheken