Krypto-Zahlung erstellen und redirectUrl erhalten
So erstellen Sie eine Krypto-Zahlung und erhalten eine redirectUrl mit einem API-Aufruf: POST /api/v1/payment, Header x-api-key, Betrag in Ihrer Währung (standardmäßig USD) und Weiterleitung.
Eine Zahlung zu erstellen und eine redirectUrl zu erhalten ist in der Host-to-Host-API v1 von Qvard eine einzige Anfrage. Dieser Leitfaden erklärt die Anfragefelder, die Antwort und wie Sie den Kunden sicher zum Checkout schicken.
Die Anfragefelder
Senden Sie ein POST an /api/v1/payment mit dem Header x-api-key. id ist Ihre eigene Transaktions-ID, price der Betrag in der Währung des Feldes currency (ISO-4217, standardmäßig USD), currency ist ein optionaler ISO-4217-Code wie INR, RUB oder EUR, paymentSystemId ist optional. Halten Sie die id pro Bestellung eindeutig, damit Sie die Antwort Ihrem Datensatz zuordnen können. Eine nicht unterstützte Währung wird mit 422 unsupported_currency abgelehnt, zu viele Dezimalstellen für diese Währung mit 422 invalid_amount_precision und eine Währung ohne Kurs mit 422 rate_unavailable.
Die Antwort lesen
Die Antwort enthält die Zahlungs-ID und die redirectUrl, die auf die gehostete Seite https://my.qvard.com/pay/ mit der Zahlungs-ID am Ende zeigt. Speichern Sie beide Werte zusammen mit der Bestellung, bevor Sie den Kunden weiterleiten.
Den Kunden weiterleiten
Senden Sie den Kunden per normaler HTTP-Weiterleitung oder über einen Link auf Ihrer Website an die redirectUrl. Auf der gehosteten Seite wählt der Kunde Asset und Netzwerk und sieht den exakten Betrag zum festen Kurs.
x-api-key: sk_live_…
{
"id": "order_1024",
"price": 12499.00,
"currency": "INR",
"paymentSystemId": 12
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}Fehler und Wiederholungen
Schlägt eine Anfrage fehl, prüfen Sie zuerst Ihre Datensätze, damit eine Bestellung nicht zwei Zahlungen erhält. Protokollieren Sie den Antworttext für den Support und wiederholen Sie die Anfrage nur, wenn keine Zahlung für diese Bestellung existiert.
Häufige Fehler
Legen Sie x-api-key nicht in den Frontend-Code, betrachten Sie die Weiterleitung nicht als Zahlungsbestätigung und senden Sie den Preis nicht in einer anderen Währung als der im Feld currency angegebenen. Der finale Status kommt immer per Webhook.
Eine Online-Bestellung, Schritt für Schritt
Wenn der Käufer auf Bezahlen klickt, legt Ihr Server die Zahlung mit der Bestell-ID und der Warenkorbsumme an und leitet den Käufer zur redirectUrl weiter. Meldet der Webhook die Zahlung, markieren Sie die Bestellung als bezahlt.
FAQ
Muss ich paymentSystemId senden?
Nein, das Feld ist optional. Senden Sie es, wenn Sie eine bestimmte Zahlungsmethode wünschen; sonst zeigt die gehostete Seite die verfügbaren Optionen.
Kann ich eine redirectUrl für eine andere Bestellung wiederverwenden?
Nein. Jede Zahlung hat eine eigene redirectUrl. Legen Sie für jede Bestellung eine neue Zahlung an.
Kann der Kunde über einen Link zahlen, den ich per E-Mail schicke?
Ja. Die redirectUrl ist eine gewöhnliche HTTPS-Seite und funktioniert in E-Mail oder Chat. Zahlungslinks ohne Code aus dem Dashboard sind in Planung.
Welchen Betrag zahlt der Kunde?
Die gehostete Seite zeigt den exakten Betrag des gewählten Assets zum festen Kurs für die Laufzeit der Rechnung.
