Python-Bibliothek
Kryptozahlungen in Ihrer Python-App annehmen
Erstellen Sie Krypto-Rechnungen aus Flask, Django, FastAPI oder einem einfachen Skript und prüfen Sie den signierten Webhook, wenn der Kunde zahlt. Das Geld geht direkt an Ihre eigene Wallet.
Installieren
pip install arionpayWas es leistet
ArionPay für Python-Entwickler
Weiterlesen
Rechnungen kommen als dicts mit denselben Feldnamen wie im Webhook zurück, sodass eine Funktion einen Webhook und eine Abfrage verarbeiten kann. ArionPay verwahrt das Geld nie: Es geht direkt an Ihre eigene Wallet.- Keine Abhängigkeiten (nur Standardbibliothek). Python 3.8 oder neuer.
- README-Beispiele für Flask, Django und FastAPI. Einfache Skripte funktionieren auch.
- Jede Rechnungsanfrage enthält einen Idempotency-Key, sodass ein Netzwerkfehler nie zwei Rechnungen erzeugen kann.
- Signiert jede Rechnungsanfrage mit HMAC-SHA256 und Ihrem API-Secret. Das Secret selbst wird nie gesendet.
- verify_webhook prüft den Header ArionPay-Signature auf dem Raw Body und löst SignatureError aus, wenn die Signatur nicht passt oder älter als 5 Minuten ist.
- simulate_payment führt eine Testrechnung durch Szenarien wie exact, partial_half, overpaid oder late. send_test_webhook sendet ein signiertes Beispiel-Event.
- Mit Type Hints (py.typed).
Voraussetzungen und Lizenz
- Funktioniert mit
- Python 3.8 oder neuer · Flask, Django, FastAPI oder einfache Skripte · nur Standardbibliothek
- 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
Schritt 1
Paket installieren
Führen Sie pip install arionpay aus. Es wird nur die Standardbibliothek genutzt.
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“. Bewahren Sie sie auf Ihrem Server auf, zum Beispiel in Umgebungsvariablen.
Schritt 3
Rechnung erstellen
Rufen Sie create_invoice mit Betrag, Währung und Ihrer order_id auf und leiten Sie den Kunden dann zu invoice["invoiceUrl"] weiter.
Schritt 4
Webhook prüfen
Legen Sie Ihre Webhook-Adresse auf der Seite „Webhooks“ fest oder pro Rechnung mit callback_url. Übergeben Sie den Raw Body und den Header ArionPay-Signature an verify_webhook und liefern Sie die Bestellung bei invoice.paid aus.
Schritt 5
Ohne echtes Geld testen
Erstellen Sie eine Rechnung mit test=True und einem Asset wie USDT_TRC20 und rufen Sie dann simulate_payment(invoice["id"], "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: vollständig bezahlt und bestätigt oder von Ihnen manuell im Dashboard akzeptiert. Liefern Sie nur bei diesem Event (oder wenn get_invoice „paid“ meldet). Die Rückkehr zur success_url beweist keine Zahlung.
- Gleichen Sie vor der Lieferung die Rechnung mit Ihrer Bestellung ab: Ihre order_id oder metadata sowie derselbe Betrag und dieselbe Währung wie die aktuelle Gesamtsumme der Bestellung.
- 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["id"] 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 Python
Kurze Antworten, bevor Sie sie in Ihren Code einbauen.