Krypto-Zahlungs-API: Zahlungen Server-zu-Server
Anleitung zur Krypto-Zahlungs-API: Zahlung vom Server mit POST /api/v1/payment anlegen, redirectUrl erhalten und den finalen Status per Webhook empfangen.
Eine Krypto-Zahlungs-API erlaubt es Ihrem Backend, eine Zahlung anzulegen, den Kunden auf eine gehostete Zahlungsseite zu schicken und den finalen Status zu erfahren, ohne eigene Blockchain-Infrastruktur aufzubauen. Qvard stellt diesen Ablauf als Host-to-Host-API v1 bereit.
Was eine Krypto-Zahlungs-API leistet
Eine Krypto-Zahlungs-API macht aus einem Bestellvorgang auf Ihrem Server eine Zahlungsanfrage. Ihr Backend sendet Ihre Bestell-ID und den Betrag in Ihrer Währung (standardmäßig USD), und das Gateway liefert eine redirectUrl zur gehosteten Zahlungsseite, auf der der Kunde Asset und Netzwerk wählt. Adressen, Kurse und die Blockchain-Überwachung bleiben auf Seiten des Gateways.
So sieht die Qvard-v1-Anfrage aus
Der Aufruf ist ein einziges POST an /api/v1/payment mit dem Header x-api-key. Das Feld id trägt Ihre eigene Transaktions-ID, price den Betrag in der Währung des optionalen Feldes currency (ISO-4217, standardmäßig USD). paymentSystemId ist optional und wählt bei Bedarf eine Zahlungsmethode. Die Antwort liefert die Zahlungs-ID und die redirectUrl.
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
}Server-zu-Server statt Browser-zu-Gateway
Die Anfrage wird von Ihrem Backend gestellt, der API-Schlüssel gelangt also nie in den Browser. Der Kunde sieht die gehostete Zahlungsseite erst, nachdem Sie ihn weitergeleitet haben. Außerdem prüfen Sie jede Bestellung auf Ihrer Seite, bevor eine Zahlung angelegt wird.
Der finale Status kommt per Webhook
Die API-Antwort bestätigt, dass die Zahlung angelegt wurde, nicht dass sie bezahlt ist. Der finale Status wird als POST mit den Feldern id und status an Ihre Webhook-URL zugestellt, daher sollte die Bestelllogik auf den Webhook reagieren.
Was vor dem Livegang zu prüfen ist
Speichern Sie die Zahlungs-ID zusammen mit der Bestellung, machen Sie den Webhook-Handler sicher gegen doppelte Ausführung und testen Sie den gesamten Ablauf mit einer Demo-Rechnung. Verwenden Sie in jeder Anfrage für eine Bestellung dieselbe ID, damit wiederholte Aufrufe abgeglichen werden können.
Gebühren und Netzwerke
Der Basissatz für die Verarbeitung beträgt 1 % pro Zahlung und sinkt mit wachsendem Volumen individuell bis auf 0,1 %. Netzwerkgebühren werden separat im vom Kunden gewählten Netzwerk bezahlt. Die aktuellen Konditionen stehen auf der Preisseite.
FAQ
Ist eine Krypto-Zahlungs-API dasselbe wie ein Zahlungslink?
Nein. Ein Zahlungslink ist eine teilbare Seite für manuelle Verkäufe. Die API legt die Zahlung aus Ihrem System an und liefert eine redirectUrl, die Ihr Code steuert.
Muss ich einen Blockchain-Knoten betreiben?
Nein. Qvard überwacht die Netzwerke und meldet den finalen Status per Webhook, Knoten oder Scanner müssen Sie nicht selbst betreiben.
In welcher Währung wird der Preis angegeben?
Das Feld price ist in der Währung aus currency (ISO-4217, z. B. INR oder EUR); ohne dieses Feld ist es USD. Der Kunde zahlt in dem Asset und Netzwerk, das er auf der Zahlungsseite wählt.
Kann ich vor dem Livegang testen?
Ja. Erstellen Sie eine Demo-Rechnung und sehen Sie dieselbe gehostete Zahlungsseite, die Ihre Kunden sehen werden.
