Was ist ein Host-to-Host-Zahlungsgateway?
Was ein Host-to-Host-Zahlungsgateway ist: Zahlungen Server-zu-Server mit Weiterleitung zum gehosteten Checkout und finalem Webhook, für Händler erklärt.
Ein Host-to-Host-Zahlungsgateway verbindet Ihren Server direkt mit dem Zahlungsdienstleister. Ihr Backend legt Zahlungen an, der Kunde bezahlt auf einer gehosteten Seite, und der Dienstleister meldet das Ergebnis an Ihren Server zurück.
Was Host-to-Host bedeutet
Im Host-to-Host-Modell geht die Zahlungsanfrage von Ihrem Server an das Gateway, nicht vom Browser aus. Der Kunde begegnet dem Gateway nur auf der gehosteten Zahlungsseite; Schlüssel und Bestelllogik bleiben bei Ihnen.
So funktioniert der Ablauf
Ihr Server legt eine Zahlung mit POST /api/v1/payment an, erhält eine redirectUrl, schickt den Kunden dorthin und erhält den finalen Status per Webhook. Drei Schritte decken den gesamten Ablauf ab.
Für wen das geeignet ist
Onlineshops, SaaS-Produkte und Marktplätze, die bereits ein Backend betreiben und die volle Kontrolle über Checkout-Logik, Bestellstatus und Abgleich behalten wollen.
Gehostete Seite und fester Kurs
Der Kunde bezahlt im gehosteten Checkout von Qvard, der den exakten Betrag für das gewählte Asset und Netzwerk zum festen Kurs für die Laufzeit der Rechnung zeigt. Adresserzeugung und Kurslogik müssen Sie nicht selbst bauen.
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
}Sicherheitsgrundlagen
Halten Sie x-api-key auf dem Server, prüfen Sie den Header x-api-key bei jedem Webhook und akzeptieren Sie nur HTTPS-Endpoints. Behandeln Sie die Weiterleitung als Navigation, nicht als Zahlungsbestätigung.
Wann ein anderes Produkt besser passt
Ohne Backend ist ein Zahlungslink einfacher. Embedded Checkout, SDK, Terminal und Telegram Checkout sind in Planung; heute liefert die API mit der gehosteten Seite dasselbe Ergebnis.
FAQ
Ist Host-to-Host dasselbe wie eine API?
Es ist ein API-basiertes Modell, in dem der Server direkt mit dem Gateway spricht. Der Begriff beschreibt, wer den Aufruf macht, nämlich der Server, und nicht ein eigenes Protokoll.
Brauche ich einen eigenen Server?
Nein. Jedes Backend, das HTTPS-Anfragen stellen und eine Webhook-URL bereitstellen kann, genügt.
Was kostet das Gateway?
Der Basissatz beträgt 1 % pro Zahlung, individuelle Sätze sinken mit dem Volumen bis auf 0,1 %, und Netzwerkgebühren werden separat bezahlt.
Kann ich Host-to-Host mit der gehosteten Seite kombinieren?
Ja, das ist der Standardablauf: Die API legt die Zahlung an, und die gehostete Seite nimmt sie entgegen.
