JavaScript-Beispiel für Krypto-Zahlungen: heute funktionierender Ablauf
JavaScript-Beispiel für Krypto-Zahlungen: ein funktionierender Ablauf mit der Live-API v1, Serveraufruf und Webhook, plus der geplante SDK-Aufruf als Roadmap.
Dieses JavaScript-Beispiel für Krypto-Zahlungen zeigt einen Ablauf, der heute funktioniert: Der Server legt die Zahlung mit der Live-API v1 an, der Browser wird zur gehosteten Seite weitergeleitet und der Webhook bestätigt die Bestellung. Der Low-Code-SDK-Aufruf am Ende ist nur eine Roadmap-Vorschau.
Der Ablauf in vier Schritten
Der Kunde klickt auf Bezahlen, Ihr Server legt die Zahlung an, der Browser geht zur redirectUrl und der Webhook bestätigt den finalen Status. Jeder Schritt ist ein einfacher HTTP-Aufruf oder eine Weiterleitung, das Beispiel braucht also keine besondere Bibliothek.
Der Serveraufruf in JavaScript
Ein Node.js-Handler sendet POST /api/v1/payment mit dem Header x-api-key, der Bestell-ID und dem Preis in USD und gibt die redirectUrl an den Browser zurück. Der Schlüssel verlässt den Server nie.
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
}Die Browser-Seite
Die Seite braucht nur eine Schaltfläche, die Ihren Handler aufruft und danach der zurückgegebenen redirectUrl folgt. Im Browser gibt es weder Schlüssel noch Betragslogik.
Der Webhook-Handler
Der Webhook-Endpoint liest id und status, prüft den Header x-api-key und markiert die Bestellung als bezahlt, wenn der Status paid ist. Machen Sie den Handler wiederholungssicher, denn dieselbe Nachricht kann zweimal ankommen.
x-api-key: sk_live_…
{ "id": "order_1024", "status": "paid" }Der geplante SDK-Aufruf
Das Low-Code SDK auf der Roadmap soll denselben Ablauf mit einem einzigen Aufruf von der Seite aus öffnen. Dies ist eine Vorschau auf eine noch nicht veröffentlichte API, nur zur Orientierung gezeigt und nicht für den Produktivbetrieb gedacht.
Vor dem Livegang testen
Legen Sie eine Demo-Rechnung an, bezahlen Sie sie auf der gehosteten Seite und prüfen Sie, dass Ihr Webhook den finalen Status erhält und die Bestellung markiert.
// ROADMAP preview: the SDK is not released yet.
QvardCheckout.open({ amount: 149.99, currency: "USD", orderId: "order_1024" });FAQ
Verwendet dieses Beispiel ein SDK?
Nein. Der funktionierende Ablauf nutzt einfache HTTP-Aufrufe und eine Weiterleitung. Der SDK-Aufruf ist nur eine Roadmap-Vorschau.
Kann ich den Aufruf QvardCheckout.open() im Produktivbetrieb nutzen?
Nein. Das SDK ist noch nicht veröffentlicht. Nutzen Sie die API, die redirectUrl und den Webhook.
Wo sollte der API-Schlüssel liegen?
Nur auf dem Server. Der Browser erhält lediglich die redirectUrl.
Woran erkenne ich, dass die Zahlung abgeschlossen ist?
Erst wenn der Webhook die id und den Status paid liefert.
