Krypto-Zahlungsterminal: was es ist und was heute funktioniert
Krypto-Zahlungsterminal erklärt: ein Kassengerät für Krypto-Zahlungen, was auf der Qvard-Roadmap steht und was heute mit der API funktioniert.
Ein Krypto-Zahlungsterminal ist ein Kassengerät, das Krypto-Zahlungen an der Theke annimmt. Qvard plant ein Terminal auf der Roadmap, es ist noch nicht veröffentlicht. Dieser Leitfaden erklärt das Konzept und den funktionierenden Weg: ein Kassenserver, der Zahlungen über die Live-API v1 anlegt.
Was ein Krypto-Zahlungsterminal leistet
Ein Krypto-Zahlungsterminal zeigt den Betrag, lässt den Kunden mit seiner Wallet bezahlen und bestätigt das Ergebnis auf dem Display. Es ersetzt das Kartenlesegerät für Unternehmen, die Krypto an einer physischen Kasse annehmen wollen.
Status: das Terminal steht auf der Roadmap
Das POS-Terminal von Qvard ist noch nicht veröffentlicht, und dieser Artikel beschreibt es nicht als fertiges Gerät. Der Weg unten ist heute über die API, die gehostete Zahlungsseite und den Webhook verfügbar.
Was heute funktioniert
Der Kassenserver legt eine Zahlung mit POST /api/v1/payment und dem Header x-api-key an und erhält eine redirectUrl. Der Kunde zahlt auf der gehosteten Seite, auf die die redirectUrl zeigt, und der Webhook liefert den finalen Status.
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 Kassenserver
Senden Sie die Verkaufs-ID als id und die Summe in USD als price. Bewahren Sie den API-Schlüssel auf dem Kassenserver auf. Die Antwort liefert die redirectUrl, die die Kasse dem Kunden zeigt.
Den Verkauf per Webhook bestätigen
Die Kasse sollte den Verkauf erst dann als bezahlt markieren, wenn der Webhook die id und den Status paid liefert. Bis dahin bleibt der Verkauf offen, auch wenn der Kunde sagt, er habe bezahlt.
Vorbereitung auf ein eigenes Terminal
Halten Sie die Verkaufslogik und den Webhook in Ihrer Kassensoftware. Wenn ein eigenes Terminal erscheint, ändert sich das Gerät, die Zahlungsanlage und die Statusverarbeitung bleiben gleich.
FAQ
Gibt es heute ein Krypto-Zahlungsterminal von Qvard?
Noch nicht. Das POS-Terminal steht auf der Roadmap. Heute nutzt ein Kassenserver die API, die gehostete Seite und den Webhook.
Kann ich meine eigene Kassensoftware nutzen?
Ja. Jede Software, die einen HTTPS-POST senden und einen Webhook empfangen kann, kann Zahlungen über die API anlegen.
Was sieht der Kunde an der Kasse?
Heute zeigt die Kasse die redirectUrl als QR-Code oder Link, und die Zahlungsseite öffnet sich auf dem Gerät des Kunden.
Wie teste ich vor einem echten Verkauf?
Legen Sie eine Demo-Rechnung an, bezahlen Sie sie auf der gehosteten Seite und prüfen Sie, dass der Webhook den Verkauf markiert.
