Krypto-Zahlungen auf Veranstaltungen: Krypto auf Märkten und Festivals annehmen
Krypto-Zahlungen auf Veranstaltungen: Krypto auf Märkten und Festivals annehmen, was Qvard für Terminals plant und der heute funktionierende Weg über die API.
Krypto-Zahlungen auf Veranstaltungen bedeuten, dass Händler auf Märkten, Festivals und Messen Krypto von Besuchern annehmen. Qvard plant ein Terminal für solche Veranstaltungen, das noch nicht veröffentlicht ist. Dieser Leitfaden erklärt den Ablauf einer Veranstaltung und den heute funktionierenden Weg: Die Kasse jedes Händlers legt Zahlungen über die API an und zeigt dem Besucher einen QR-Code.
Warum Veranstaltungen ein Sonderfall sind
Auf Veranstaltungen gibt es oft kein stabiles Internet, und viele kurze Verkäufe folgen aufeinander. Jeder Verkauf muss trotzdem eine eigene Zahlung mit eigenem Status sein, und der Händler braucht eine klare Möglichkeit, den Betrag zu zeigen.
Status: das Veranstaltungsterminal steht auf der Roadmap
Ein Qvard-Terminal für Händler auf Veranstaltungen ist noch nicht veröffentlicht, und dieser Artikel beschreibt es nicht als verfügbar. Der Weg unten nutzt API, gehostete Seite und Webhook und braucht eine Verbindung im Moment der Zahlung.
Was heute funktioniert
Die Kasse des Händlers legt jede Zahlung mit POST /api/v1/payment und dem Header x-api-key an, erhält eine redirectUrl und zeigt sie als QR-Code. Der Besucher zahlt auf der gehosteten Seite, und der Webhook liefert den finalen Status an die Kasse zurück.
Eine Zahlung pro Verkauf
Legen Sie für jeden Verkauf eine eigene Zahlung mit eindeutiger id an, damit jeder Verkauf einzeln bestätigt werden kann. Sammelsummen ersetzen den Status pro Verkauf nicht.
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
}Auf schwache Verbindung vorbereiten
Ist die Verbindung schlecht, lassen Sie den Verkauf an der Kasse offen und wiederholen Sie die Anfrage, sobald das Netz zurück ist. Zeigen Sie einen Verkauf erst als bezahlt, wenn der Webhook ihn bestätigt.
Nach der Veranstaltung abgleichen
Vergleichen Sie nach der Veranstaltung die Verkaufsliste der Kasse mit den bezahlten Webhooks. Offen gebliebene Verkäufe brauchen eine Nachverfolgung, bevor sie abgeschlossen werden.
FAQ
Gibt es heute ein Qvard-Terminal für Veranstaltungen?
Noch nicht. Das Veranstaltungsterminal steht auf der Roadmap. Heute nutzt jeder Händler eine Kasse, die mit der API arbeitet.
Braucht der Händler Internet am Stand?
Ja, um Zahlungen anzulegen und den Webhook zu empfangen. Planen Sie für die Veranstaltung eine Verbindung oder eine Wiederholungsstrategie.
Kann eine Zahlung mehrere Verkäufe abdecken?
Nein. Legen Sie eine Zahlung pro Verkauf an, damit jeder Verkauf eine eigene id und einen eigenen Status hat.
Wie teste ich vor einer Veranstaltung?
Legen Sie Demo-Rechnungen von einer Testkasse an und prüfen Sie, dass der Webhook jede davon markiert, bevor die Veranstaltung beginnt.
