Krypto-Checkout-Popup: so funktioniert es und was geplant ist
Krypto-Checkout-Popup erklärt: so funktioniert ein Zahlungsfenster, was das Qvard-SDK dafür plant und was Sie heute einsetzen können. Mit Code.
Ein Krypto-Checkout-Popup ist ein Zahlungsfenster, das sich über der aktuellen Seite öffnet, sodass der Kunde ohne Verlassen der Website bezahlt. Das Popup ist als Teil des Qvard-SDK geplant und noch nicht veröffentlicht. Dieser Leitfaden erklärt, wie ein solches Popup funktioniert und was Sie heute mit der API umsetzen können.
So funktioniert ein Zahlungsfenster
Die Seite ruft eine Funktion auf, ein Fenster öffnet sich über dem Inhalt, der Kunde schließt die Zahlung darin ab und das Fenster schließt sich. Der Shop bleibt im Hintergrund, und die Bestellung wird auf dem Server bestätigt.
Status: das Popup steht auf der Roadmap
Das Qvard-Checkout-Popup ist noch nicht veröffentlicht, und dieser Artikel beschreibt es nicht als fertige Funktion. Der Code im Medienbereich ist eine Vorschau des geplanten Aufrufs.
Was heute funktioniert
Legen Sie die Zahlung mit POST /api/v1/payment und dem Header x-api-key an und leiten Sie den Kunden zur redirectUrl der gehosteten Checkout-Seite weiter. Den finalen Status erhalten Sie per Webhook. So bekommt der Kunde dasselbe Zahlungsergebnis ohne Popup.
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
}Ein neues Fenster vorsichtig öffnen
Wenn Sie ein separates Fenster bevorzugen, öffnen Sie die redirectUrl in einem neuen Tab erst nach einem Klick. Browser blockieren Fenster, die ohne Nutzeraktion geöffnet werden; der Klick muss also zuerst kommen.
Die Zahlung auf dem Server bestätigen
Das Popup wird, sobald es verfügbar ist, den Fortschritt auf der Seite anzeigen, der Status „bezahlt“ muss aber weiterhin vom Webhook kommen. Bauen Sie die Bestelllogik schon jetzt um den Webhook herum auf.
// ROADMAP preview: the SDK is not released yet.
QvardCheckout.open({ amount: 149.99, currency: "USD", orderId: "order_1024" });Was Sie vermeiden sollten
Betrachten Sie ein geschlossenes Fenster nicht als fehlgeschlagene Zahlung und markieren Sie die Bestellung nicht beim Schließen als bezahlt. Warten Sie auf das Ergebnis des Webhooks.
FAQ
Gibt es heute ein Qvard-Zahlungs-Popup?
Noch nicht. Das Popup ist als Teil des SDK auf der Roadmap geplant. Heute genügen die gehostete Checkout-Seite oder ein neuer Tab.
Kann sich ein Fenster ohne Klick öffnen?
Browser blockieren das in der Regel. Öffnen Sie die Zahlungsseite nach einem Klick des Nutzers.
Was passiert, wenn der Kunde das Fenster schließt?
Leiten Sie das Ergebnis nicht aus dem Schließen-Ereignis ab. Prüfen Sie den Bestellstatus über den Webhook.
Wie teste ich den Ablauf?
Legen Sie eine Demo-Rechnung an und prüfen Sie das Webhook-Ergebnis.
