Krypto-POS-System: wie ein Kassensystem Krypto annehmen kann
Krypto-POS-System erklärt: wie ein Kassensystem Krypto annimmt, was Qvard für das POS-Terminal plant und was heute über die API funktioniert.
Ein Krypto-POS-System ist eine Kassensoftware, die Krypto-Zahlungen neben Bargeld und Karten annimmt. Qvard plant ein POS-Terminal, das noch nicht veröffentlicht ist. Dieser Artikel zeigt, wie sich eine Kassensoftware heute an die Live-API v1 anbinden kann und wo ein eigenes Terminal später ansetzen würde.
Was ein Krypto-POS-System braucht
Eine Kassensoftware muss eine Zahlung über die Verkaufssumme anlegen, einen scanbaren Link anzeigen und den finalen Status empfangen, um den Verkauf abzuschließen. Alles Weitere wie Belege und Bestand bleibt in der Kassensoftware.
Status: das Qvard-POS-Terminal steht auf der Roadmap
Das POS-Terminal von Qvard ist noch nicht veröffentlicht, und dieser Artikel stellt es nicht als fertiges Gerät dar. Die Integration unten funktioniert heute mit der API, der gehosteten Seite und dem Webhook.
Die Integration heute
Die Kassensoftware sendet POST /api/v1/payment mit dem Header x-api-key, der Verkaufs-ID und der Summe, erhält eine redirectUrl und zeigt sie als QR-Code oder Link. Anschließend liefert der Webhook den finalen Status, um den Verkauf im POS abzuschließen.
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
}Verkauf und Zahlung zuordnen
Verwenden Sie die Verkaufs-ID als id, damit jede Zahlung genau einem Verkauf entspricht. Die Summe in USD geht in price.
Den Verkauf über den Webhook abschließen
Das POS schließt den Verkauf und druckt den Beleg erst, wenn der Webhook paid liefert. Offene Verkäufe können als wartend angezeigt werden, damit der Kassierer weiß, dass das Geld noch nicht da ist.
Den Umstieg planen
Wenn das eigene Terminal erscheint, kann es den QR-Schritt übernehmen. Die Kassensoftware, die Verkaufsdaten und die Webhook-Verarbeitung ändern sich nicht.
FAQ
Kann meine Kassensoftware heute Krypto annehmen?
Ja, wenn sie einen HTTPS-POST senden, einen QR-Code oder Link anzeigen und einen Webhook empfangen kann. Das POS-Terminal von Qvard steht auf der Roadmap.
Welches Feld verknüpft eine Zahlung mit einem Verkauf?
Das Feld id trägt Ihre Verkaufs-ID; so entspricht jede Zahlung einem Verkauf in Ihrem System.
Braucht die Kasse ein spezielles Plugin?
Nein. Jede Kasse, die einen REST-Endpoint aufrufen und einen Webhook empfangen kann, lässt sich an die API anbinden.
Wie teste ich die Kassen-Integration?
Legen Sie eine Demo-Rechnung aus einem Testverkauf an und prüfen Sie, dass die Kasse den Verkauf beim Eintreffen des Webhooks abschließt.
