Krypto-Zahlungsbutton: so binden Sie ihn auf Ihrer Website ein
Krypto-Zahlungsbutton: so fügen Sie einen Krypto-Zahlungsbutton auf Ihrer Website hinzu, was der geplante SDK-Button ist und was heute funktioniert. Mit Code.
Ein Krypto-Zahlungsbutton ist eine einzelne Schaltfläche auf Ihrer Website, die eine Krypto-Zahlung startet. Das geplante SDK von Qvard würde einen solchen Button mit wenigen Zeilen Code darstellen, ist aber noch nicht veröffentlicht. Dieser Leitfaden zeigt, wie Sie heute mit der echten API einen funktionierenden Button bauen.
Was ein Krypto-Zahlungsbutton leistet
Ein Zahlungsbutton startet eine Zahlung, wenn der Kunde ihn anklickt. Auf einer Krypto-Website führt der Klick zu einer Zahlungsseite, auf der der Kunde Asset und Netzwerk wählt. Der Button selbst hält weder Geld noch Schlüssel.
Status: der SDK-Button steht auf der Roadmap
Der SDK-Button von Qvard ist noch nicht veröffentlicht. Dieser Artikel stellt ihn nicht als fertige Komponente dar, und der Vorschau-Code im Medienbereich ist als Roadmap gekennzeichnet.
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 funktionierender Button heute
Der Button sendet eine Anfrage an Ihr Backend. Das Backend legt die Zahlung mit POST /api/v1/payment und dem Header x-api-key an und gibt die redirectUrl zurück. Der Button leitet den Kunden dorthin, und der Webhook bestätigt die Zahlung.
Den Button im Checkout platzieren
Platzieren Sie den Button am Ende des Warenkorbs neben der Summe. Zeigen Sie den Betrag in USD vor dem Klick, damit der Kunde weiß, was ihn auf der gehosteten Seite erwartet.
Den Button absichern
Legen Sie den API-Schlüssel nicht in den Code des Buttons. Erstellen Sie die Zahlung erst beim Klick des Kunden und prüfen Sie die Bestellsumme auf dem Server, nicht im Browser.
// ROADMAP preview: the SDK is not released yet.
QvardCheckout.open({ amount: 149.99, currency: "USD", orderId: "order_1024" });Mit dem Webhook bestätigen
Wenn der Webhook die id und den Status paid liefert, markieren Sie die Bestellung als bezahlt. Ein Klick auf den Button bedeutet nicht, dass das Geld eingegangen ist.
FAQ
Gibt es heute eine Qvard-Komponente für einen Zahlungsbutton?
Nicht als SDK-Komponente; das SDK steht auf der Roadmap. Heute erledigt ein normaler Button, der Ihr Backend aufruft, dieselbe Aufgabe.
Kann der Button den Betrag in einer anderen Währung anzeigen?
Der Preis in der API-Anfrage ist in USD. Die gehostete Seite zeigt den exakten Betrag im gewählten Asset zum festen Kurs.
Reicht der Button ohne Webhook?
Nein. Der Button startet nur die Zahlung. Markieren Sie die Bestellung nur über den Webhook als bezahlt.
Wie teste ich den Button?
Nutzen Sie den Demo-Rechnungsablauf und prüfen Sie, dass der Webhook die Bestellung nach der Zahlung markiert.
