QR-Code-Krypto-Zahlungen: wie ein gescannter Code zur Zahlung führt
QR-Code-Krypto-Zahlungen erklärt: wie ein gescannter Code zur Zahlungsseite führt, was Qvard für QR am Terminal plant und was heute funktioniert.
QR-Code-Krypto-Zahlungen lassen den Kunden einen Code mit seiner Wallet scannen und in Krypto bezahlen. Qvard plant Zahlungen per QR am eigenen POS-Terminal, das noch nicht veröffentlicht ist. Dieser Leitfaden erklärt, wie der Scan zur Zahlung führt, und was heute funktioniert: ein QR-Code, der auf die gehostete Zahlungsseite zeigt.
Was ein QR-Code enthält
Ein QR-Code ist das Bild eines Links. Scannt der Kunde ihn, öffnet die Wallet oder das Telefon den Link, und der Link führt zur Zahlungsseite genau dieses Verkaufs.
Status: QR am Terminal steht auf der Roadmap
Ein Qvard-Terminal, das seinen eigenen QR-Code anzeigt, ist noch nicht veröffentlicht. Dieser Artikel stellt es nicht als verfügbar dar. Der QR-Ablauf unten funktioniert heute, weil der Code die von der API zurückgegebene redirectUrl kodiert.
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
}Was heute funktioniert
Die Kasse legt die Zahlung mit POST /api/v1/payment und dem Header x-api-key an, erhält die redirectUrl und kodiert sie als QR-Code. Der Kunde scannt, öffnet die gehostete Seite, bezahlt, und der Webhook liefert den finalen Status.
Nur die redirectUrl kodieren
Legen Sie nur die redirectUrl in den Code. Kein API-Schlüssel, keine Summe und kein Geheimnis gehört in den QR-Code, denn wer ihn sieht, kann ihn lesen.
Den Betrag neben dem Code zeigen
Zeigen Sie die Summe in USD neben dem QR-Code. Die gehostete Seite zeigt danach den exakten Betrag in der gewählten Kryptowährung zum festen Kurs, damit der Kunde vergleichen kann.
Per Webhook bestätigen
Ein gescannter Code beweist keine Zahlung. Markieren Sie den Verkauf erst als bezahlt, wenn der Webhook die id und den Status paid liefert.
FAQ
Zeigt Qvard heute einen QR-Code am Terminal an?
Nicht über ein eigenes Terminal; das steht auf der Roadmap. Heute kann Ihre Kasse selbst einen QR-Code aus der redirectUrl erzeugen.
Darf ich den API-Schlüssel in den QR-Code legen?
Niemals. Der QR-Code sollte nur die redirectUrl enthalten, die sicher geteilt werden kann.
Reicht ein gescannter QR-Code zur Zahlungsbestätigung?
Nein. Bestätigen Sie die Zahlung nur per Webhook mit dem Status paid.
Wie teste ich den QR-Code?
Legen Sie eine Demo-Rechnung an, kodieren Sie deren redirectUrl und scannen Sie sie mit einer Testwallet.
