Krypto-Zahlung im Backend integrieren, Schritt für Schritt
Krypto-Zahlungen im Backend Schritt für Schritt integrieren: Zahlungen vom Server anlegen, Kunden weiterleiten, Webhooks prüfen und Bestellungen abgleichen.
Die Integration von Krypto-Zahlungen in ein Backend besteht aus drei Teilen: einem Serveraufruf, der die Zahlung anlegt, einer Weiterleitung für den Kunden und einem Webhook, der die Bestellung abschließt. Dieser Leitfaden geht jeden Schritt mit der API v1 von Qvard durch.
Schritt 1: Bestellung zuerst speichern
Speichern Sie die Bestellung in Ihrer Datenbank mit einem Status wie pending, bevor Sie die API aufrufen. Verwenden Sie Ihre Bestell-ID als Feld id, damit Zahlung und Bestellung von Anfang an verknüpft sind.
Schritt 2: Zahlung anlegen
Senden Sie von Ihrem Backend ein POST an /api/v1/payment mit dem Header x-api-key, der Bestell-ID in id und dem Gesamtbetrag in price. Bewahren Sie den API-Schlüssel in der Serverkonfiguration auf, nie im Frontend-Code.
Schritt 3: Kunden weiterleiten
Speichern Sie die zurückgegebene redirectUrl zusammen mit der Bestellung und leiten Sie den Kunden dorthin. Auf der gehosteten Seite wählt der Kunde Asset und Netzwerk und zahlt den exakten Betrag.
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
}Schritt 4: Bestellung über den Webhook abschließen
Ihr Webhook-Endpoint prüft x-api-key, findet die Bestellung über die id und setzt sie auf bezahlt, wenn der Status paid ist. Das ist die einzige Stelle, an der eine Zahlung bestätigt wird.
Schritt 5: abgleichen und überwachen
Prüfen Sie täglich Bestellungen, die zu lange offen sind, und vergleichen Sie sie mit Ihren Zahlungsdatensätzen. Protokollieren Sie jede API-Antwort und jeden Webhook für den Support.
x-api-key: sk_live_…
{ "id": "order_1024", "status": "paid" }Architekturtipps
Halten Sie den Zahlungscode in einem kleinen Dienst, getrennt von den Checkout-Ansichten. So können Sie den Webhook-Handler ändern oder einen zweiten Kanal ergänzen, ohne den Rest des Shops anzufassen.
FAQ
Welche Backend-Sprachen kann ich verwenden?
Jede Sprache, die ein HTTPS-POST mit JSON-Body senden und einen Webhook empfangen kann. Die API ist einfaches HTTP, ein SDK ist nicht nötig.
Wo sollte ich die Webhook-URL hinterlegen?
Verwenden Sie einen öffentlichen HTTPS-Endpoint auf Ihrem Backend. Er muss POST annehmen und den Header x-api-key prüfen, bevor er eine Bestellung aktualisiert.
Brauche ich für jede Kryptowährung eine eigene Integration?
Nein. Der Kunde wählt Asset und Netzwerk auf der gehosteten Checkout-Seite, Ihr Backend legt also eine Zahlung in USD an und liest einen Status.
Kann ich die gesamte Integration vorher testen?
Ja. Nutzen Sie den Demo-Rechnungsablauf, um eine Testrechnung zu bezahlen, und prüfen Sie, dass Ihr Webhook-Handler läuft, bevor Sie echte Zahlungen annehmen.
