Wie redirectUrl an der Krypto-Kasse funktioniert
Was die von der Qvard-API zurückgegebene redirectUrl ist, was der Kunde auf dieser Seite sieht, wie Sie den Link an der Kasse oder in einer E-Mail nutzen und was er nicht für Sie erledigt.
Wenn Sie bei Qvard eine Zahlung erstellen, enthält die Antwort ein Feld, das für den Kunden zählt: redirectUrl, die Adresse einer von Qvard gehosteten Zahlungsseite. Sie ist die gesamte kundenseitige Seite der Integration. Dieser Leitfaden erklärt, was der Link ist, was der Kunde dort sieht, wie Sie ihn an der Kasse oder in einer E-Mail nutzen und welche Aufgaben er Ihnen überlässt.
Was redirectUrl ist
Sie erstellen eine Zahlung mit einem einzigen POST an https://api.qvard.com/api/v1/payment (der Header x-api-key, Ihre Bestellnummer als id, der Betrag als price in US-Dollar). Die Antwort ist 201 mit zwei Feldern: id, der Kennung der Zahlung bei Qvard, und redirectUrl in der Form https://my.qvard.com/pay/<id>.
Die Adresse führt zu einer gehosteten Zahlungsseite: einer Seite, die Qvard betreibt, nicht Ihr Server. Sie bauen, hosten oder pflegen sie nicht. Ihre Aufgabe ist, den Kunden zu dieser Adresse zu bringen und das Ergebnis danach aus dem Webhook zu erfahren.
Was der Kunde sieht
Auf der Seite:
- wählt der Kunde ein Asset und ein Netzwerk (oder findet das, was Sie mit einer
paymentSystemIdvorausgewählt haben); - sieht er die Adresse und den genauen Betrag, mit dem Netzwerk neben der Adresse;
- sendet er die Überweisung aus seiner eigenen Wallet oder von seiner Börse.
Der Kurs auf der Seite ist eine Stunde lang festgesetzt, der Betrag ändert sich also nicht, während der Kunde zahlt. Die Seite ist dieselbe, wie auch immer Ihr Shop aussieht, und das ist der Punkt: Sie erhalten eine funktionierende Krypto-Kasse, ohne eine zu bauen. Um sie vor der Integration zu sehen, öffnen Sie eine Demo-Rechnung.
Den Link an der Kasse nutzen
Die Standardnutzung ist eine serverseitige Weiterleitung oder ein Button, in drei Schritten:
- Der Kunde wählt „Mit Krypto bezahlen“. Ihr Server legt Ihre eigene Bestellung und die Qvard-Zahlung an.
- Ihr Server antwortet mit der
redirectUrl, als HTTP-Weiterleitung oder als Wert, mit dem Ihr Frontend navigiert. - Der Browser geht zur Seite; der Kunde zahlt dort.
Erstellen Sie die Zahlung, nachdem der Kunde den Button gedrückt hat, nicht beim Aufbau des Warenkorbs. Senden Sie den geheimen API-Schlüssel nie an den Browser: Der Browser erhält nur die redirectUrl. Ein vollständiges Button-Beispiel finden Sie unter Krypto-Zahlungsbutton für Websites.
Den Link außerhalb einer Kasse nutzen
Weil die Seite unter einer schlichten Adresse gehostet wird, funktioniert der Link auch außerhalb einer Web-Kasse:
- In einer Rechnungs-E-Mail oder einem PDF, neben den Bankdaten, damit ein Geschäftskunde in Krypto zahlen kann (siehe Stablecoin-Zahlungen für B2B-Rechnungen).
- In einem Chat oder einer Support-Nachricht, für eine einmalige Zahlung, die Sie mit eigenen Werkzeugen von Hand erstellt haben.
- Hinter einem QR-Code, wenn Ihr eigenes System einen aus der Adresse erzeugt.
Behandeln Sie den Link als Zugang zu dieser einen Zahlung. Senden Sie ihn an den Kunden, zu dem er gehört, und veröffentlichen Sie ihn nicht. Zahlungslinks als eigenes Produkt ohne Code sind in Entwicklung; heute erstellen Sie die Zahlung über die API und teilen die zurückgegebene Adresse.
Wiederholungen, erneute Versuche und was nach der Zahlung passiert
- Dieselbe Bestellung zweimal. Wird dieselbe
idfür dieselbe Zahlungsmethode gesendet, kommt die bestehende Zahlung zurück; ein Doppelklick oder eine wiederholte Anfrage ergibt also dieselbe Zahlung und keine zweite. - Noch keine Rücksprung-URL. Nach dem Bezahlen wird der Kunde nicht automatisch auf Ihre Seite zurückgeschickt; Rücksprung-URLs sind noch nicht verfügbar. Geben Sie ihm eine Bestellseite, die den echten Status zeigt und sich aktualisiert, solange sie wartet.
- Das Ergebnis ist der Webhook. Qvard ruft Ihre Callback-URL auf, wenn die Zahlung abgeschlossen ist, mit Ihrer
idund dem Status. Ihr Endpunkt muss genau mit HTTP 200 antworten und bei doppelter Ausführung sicher sein. Ein auf die Seite zurückgekehrter Kunde ist kein Zahlungsnachweis. Siehe Krypto-Zahlungs-Webhooks absichern.
Was der Link nicht tut
Damit Sie nicht danach suchen:
- Er sagt Ihnen nicht den Zahlungsstatus; es gibt keine Route, um eine Zahlung per
idzu lesen, nutzen Sie also den Webhook und Ihre eigenen Aufzeichnungen. - Er bringt den Kunden nicht auf Ihre Seite zurück; Rücksprung-URLs sind noch nicht verfügbar.
- Er ersetzt Ihre Bestellseite nicht: Sie brauchen weiterhin eine, die „wartet“, „teilweise“ oder „bezahlt“ zeigt.
Die Anfrage- und Antwortformate stehen in Krypto-Zahlungs-API für Entwickler, der gesamte Ablauf in Krypto-Zahlungen auf einer Website akzeptieren.
FAQ
Was ist redirectUrl?
Die Adresse der gehosteten Zahlungsseite, die Qvard für eine Zahlung erstellt, in der Form https://my.qvard.com/pay/<id>. Sie senden den Kunden dorthin, damit er zahlt.
Muss ich eine Kassenseite bauen?
Nein. Die Zahlungsseite wird von Qvard gehostet. Sie erstellen nur die Zahlung über die API und leiten den Kunden auf die zurückgegebene Adresse weiter.
Kann ich den Link in eine E-Mail setzen?
Ja. Es ist eine schlichte Adresse, sie funktioniert also in einer Rechnungs-E-Mail, einer Nachricht oder hinter einem QR-Code. Senden Sie sie nur an den Kunden, zu dem sie gehört.
Woher weiß ich, dass der Kunde bezahlt hat?
Über den Webhook, den Qvard sendet, wenn die Zahlung abgeschlossen ist. Der Link meldet den Status nicht, und es gibt noch keine Rücksprung-URLs.