PHP-Bibliothek
Kryptozahlungen in Ihrer PHP-App annehmen
Erstellen Sie eine Krypto-Rechnung von jeder PHP-Website aus, leiten Sie den Kunden zur Zahlungsseite und prüfen Sie den signierten Webhook, wenn er zahlt. Das Geld geht direkt an Ihre eigene Wallet.
Installieren
composer require arionpay/arionpay-phpWas es leistet
ArionPay für PHP-Entwickler
Weiterlesen
Sie können sie mit Composer installieren oder den Ordner hochladen und seine autoload.php einbinden, daher passt sie auch zu Shared Hosting. ArionPay verwahrt das Geld nie: Jede Zahlung geht direkt an Ihre eigene Wallet.- PHP 7.4 oder neuer. Keine Abhängigkeiten.
- Nutzt cURL, wenn installiert, sonst PHP-Streams. Weiterleitungen werden nie verfolgt.
- Funktioniert mit Composer oder ohne: Ordner kopieren und autoload.php einbinden.
- Derselbe idempotencyKey liefert immer dieselbe Rechnung, sodass ein Neuladen der Seite keine zweite erzeugt. Ohne eigenen Key schützt ein zufälliger die Wiederholungsversuche.
- Signiert jede Rechnungsanfrage mit HMAC-SHA256 und Ihrem API-Secret. Das Secret selbst wird nie gesendet.
- Webhook::fromGlobals liest den Raw Body und den Header ArionPay-Signature und wirft SignatureException, wenn die Signatur falsch oder älter als 5 Minuten ist.
- Mit simulatePayment und sendTestWebhook probieren Sie den gesamten Ablauf ohne echtes Geld aus.
Voraussetzungen und Lizenz
- Funktioniert mit
- PHP 7.4 oder neuer · mit oder ohne Composer, auch auf Shared Hosting · cURL oder PHP-Streams
- 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
Bibliothek installieren
Führen Sie composer require arionpay/arionpay-php aus. Ohne Composer laden Sie den Ordner neben Ihre Website hoch und binden __DIR__ . '/arionpay-php/autoload.php' per require ein.
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 in Umgebungsvariablen oder einer Konfigurationsdatei außerhalb des Web-Roots auf.
Schritt 3
Rechnung erstellen
Rufen Sie createInvoice mit Betrag, Währung, orderId und einem idempotencyKey auf und leiten Sie den Kunden dann zu $invoice['invoiceUrl'] weiter.
Schritt 4
Webhook prüfen
Legen Sie auf der Seite „Webhooks“ eine öffentliche https://-Adresse auf Port 443 oder 8443 fest oder pro Rechnung mit callbackUrl. Rufen Sie in diesem Skript Webhook::fromGlobals($secret) auf 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 simulatePayment($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: fully paid and confirmed, or accepted by you by hand in the dashboard. Deliver only on this event (or when getInvoice() says paid). Coming back to successUrl does not prove payment.
- Gleichen Sie vor der Lieferung die Rechnung mit Ihrer Bestellung ab: Ihre orderId 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 PHP
Kurze Antworten, bevor Sie sie in Ihren Code einbauen.