Host-to-host ödeme geçidi nedir?
Host-to-host ödeme geçidi nedir: hosted checkout’a yönlendirmeli sunucudan sunucuya ödemeler ve son webhook. Satıcılar için açıklamalı rehber.
Host-to-host ödeme geçidi, sunucunuzu doğrudan ödeme sağlayıcısına bağlar. Backend’iniz ödemeleri oluşturur, müşteri hosted bir sayfada öder ve sağlayıcı sonucu sunucunuza geri bildirir.
Host-to-host ne anlama gelir
Host-to-host modelinde ödeme isteği tarayıcıdan değil, sunucunuzdan geçite gider. Müşteri geçidi yalnızca hosted ödeme sayfasında görür; anahtarlar ve sipariş mantığı sizde kalır.
Akış nasıl çalışır
Sunucunuz /api/v1/payment adresine POST ile bir ödeme oluşturur, bir redirectUrl alır, müşteriyi oraya gönderir ve son durumu webhook ile öğrenir. Üç adım tüm akışı kapsar.
Kimler için uygun
Zaten bir backend’i olan ve ödeme mantığı, sipariş durumları ve uzlaştırma üzerinde tam kontrol isteyen online mağazalar, SaaS ürünleri ve pazaryerleri.
Hosted sayfa ve sabit kur
Müşteri Qvard hosted checkout’ta öder; bu sayfa seçilen varlık ve ağ için fatura süresi boyunca sabit kurla tam tutarı gösterir. Adres üretimi ve kur mantığını kendiniz kurmazsınız.
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
}Güvenliğin temelleri
x-api-key’i sunucuda tutun, her webhook’ta x-api-key başlığını kontrol edin ve yalnızca HTTPS endpoint’lerini kabul edin. Yönlendirmeyi ödeme onayı değil, gezinme olarak görün.
Başka bir ürün ne zaman daha uygun
Backend’iniz yoksa ödeme linki daha basittir. Gömülü checkout, SDK, terminal ve Telegram checkout yol haritasındadır; bugün aynı sonuç API ve hosted sayfa ile elde edilir.
FAQ
Host-to-host bir API ile aynı mı?
Sunucunun geçitle doğrudan konuştuğu API tabanlı bir modeldir. Terim ayrı bir protokolü değil, çağrıyı kimin yaptığını (sunucu) tanımlar.
Ayrı bir sunucuya ihtiyacım var mı?
Hayır. HTTPS istekleri yapabilen ve bir webhook URL’i açabilen herhangi bir backend yeterlidir.
Geçidin maliyeti nedir?
Temel oran ödeme başına %1’dir; hacme göre bireysel oranlar %0,1’e kadar düşer ve ağ ücretleri ayrıca ödenir.
Host-to-host’u hosted sayfa ile birleştirebilir miyim?
Evet, standart akış budur: API ödemeyi oluşturur, hosted sayfa tahsil eder.
