JavaScript-SDK für Krypto-Checkout: geplant und heute funktionsfähig
JavaScript-SDK für Krypto-Checkout erklärt: ein geplantes Skript für das Zahlungsfenster, was auf der Qvard-Roadmap steht und was heute funktioniert.
Ein JavaScript-SDK für Krypto-Checkout würde mit wenigen Zeilen Code ein Zahlungsfenster auf Ihrer Website öffnen. Das Low-Code SDK von Qvard steht auf der Roadmap und ist noch nicht veröffentlicht. Dieser Leitfaden erklärt die Idee und zeigt den realen v1-Ablauf, den Sie heute nutzen können.
Was ein Checkout-SDK leistet
Ein Checkout-SDK ist eine kleine JavaScript-Bibliothek, die eine Website lädt, um eine Zahlung zu starten. Sie zeichnet das Zahlungsfenster, führt den Kunden durch die Schritte und meldet den Status an die Seite zurück. Die Bestelllogik bleibt auf dem Server des Händlers.
Status: das SDK steht auf der Roadmap
Das Low-Code SDK von Qvard ist noch nicht veröffentlicht, und dieser Artikel beschreibt es nicht als fertige Bibliothek. Der folgende Ausschnitt ist eine Vorschau des geplanten Aufrufs, kein heute lauffähiger Code.
Was heute funktioniert
Legen Sie die Zahlung auf Ihrem Server mit POST /api/v1/payment und dem Header x-api-key an, leiten Sie den Kunden zur zurückgegebenen redirectUrl der gehosteten Checkout-Seite weiter und erhalten Sie den finalen Status per Webhook. Das ist das funktionale Gegenstück zum geplanten SDK-Aufruf.
x-api-key: sk_live_…
{
"id": "order_1024",
"price": 149.99,
"paymentSystemId": 12
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}Der Aufruf vom Server
Senden Sie die Bestell-ID als id und den Preis in USD als price. Bewahren Sie den API-Schlüssel auf dem Server auf; der Browser erhält nur die redirectUrl, die der Server zurückgibt.
// ROADMAP preview: the SDK is not released yet.
QvardCheckout.open({ amount: 149.99, currency: "USD", orderId: "order_1024" });Der geplante SDK-Aufruf
Das SDK aus der Roadmap soll denselben Zahlungsablauf mit einem einzigen Aufruf von der Seite aus öffnen. Methodenname und Optionen können sich vor der Veröffentlichung ändern, bauen Sie also noch nicht auf der Vorschau auf.
So bereiten Sie sich vor
Halten Sie die Zahlungsanlage in einer Backend-Funktion und den Webhook-Handler getrennt. Wenn das SDK erscheint, ändert sich nur der Frontend-Aufruf; Serveraufruf und Webhook bleiben gleich.
FAQ
Gibt es heute ein JavaScript-SDK für Checkout von Qvard?
Nein. Das Low-Code SDK steht auf der Roadmap. Heute wird dasselbe Ergebnis mit der API, der gehosteten Checkout-Seite und dem Webhook erreicht.
Kann ich den Aufruf QvardCheckout.open() schon jetzt nutzen?
Nein. Er wird nur als Vorschau der geplanten API gezeigt. Verwenden Sie POST /api/v1/payment und leiten Sie zur redirectUrl weiter.
Brauche ich heute eine JavaScript-Bibliothek, um Krypto anzunehmen?
Nein. Eine normale Schaltfläche, die Ihr Backend aufruft und zur redirectUrl weiterleitet, genügt; der Webhook bestätigt die Zahlung.
Wie teste ich den Ablauf?
Legen Sie eine Demo-Rechnung an und prüfen Sie, dass Ihr Webhook den finalen Status erhält.
