Kripto ödeme API’si: sunucudan sunucuya ödemeler
Kripto ödeme API rehberi: sunucunuzdan POST /api/v1/payment ile ödeme oluşturun, redirectUrl alın ve son durumu webhook ile öğrenin. Adım adım örnek.
Kripto ödeme API’si, backend’inizin bir ödeme oluşturmasını, müşteriyi hosted ödeme sayfasına göndermesini ve son durumu öğrenmesini blockchain altyapısı kurmadan sağlar. Qvard bu akışı Host-to-Host API v1 olarak sunar.
Kripto ödeme API’si ne yapar
Kripto ödeme API’si, sunucunuzdaki bir satın alma olayını bir ödeme isteğine dönüştürür. Backend’iniz sipariş numaranızı ve kendi para biriminizdeki tutarı gönderir (varsayılan USD); ağ geçidi, müşterinin varlık ve ağ seçtiği hosted ödeme sayfasının redirectUrl’ini döndürür. Adresler, kurlar ve blockchain izleme ağ geçidi tarafında kalır.
v1 isteği nasıl görünür
Çağrı, x-api-key başlığıyla /api/v1/payment adresine tek bir POST isteğidir. id alanı kendi işlem numaranızı, price alanı, currency alanındaki para biriminde tutarı taşır (ISO-4217; varsayılan USD). paymentSystemId isteğe bağlıdır ve gerekirse bir ödeme yöntemi seçer. Yanıt ödeme id’sini ve redirectUrl’i döndürür.
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
}Tarayıcıdan değil, sunucudan
İstek backend’inizden yapılır, bu yüzden API anahtarı asla tarayıcıya ulaşmaz. Müşteri hosted ödeme sayfasını ancak siz yönlendirdikten sonra görür. Ödeme oluşturulmadan önce her siparişi kendi tarafınızda da kontrol edersiniz.
Son durum webhook ile gelir
API yanıtı ödemenin oluşturulduğunu doğrular, ödendiğini değil. Son durum, id ve status alanlarıyla bir POST olarak webhook URL’inize iletilir; bu yüzden sipariş mantığı webhook’a göre çalışmalıdır.
Canlıya geçmeden önce kontrol listesi
Ödeme id’sini siparişinizin yanında saklayın, webhook işleyicisini iki kez çalışsa da güvenli yapın ve tüm akışı demo faturayla test edin. Bir siparişin tüm isteklerinde aynı id’yi kullanın ki tekrarlanan çağrılar uzlaştırılabilsin.
Komisyon ve ağlar
Temel işlem oranı ödeme başına %1’dir ve hacminiz arttıkça kişisel olarak %0,1’e kadar düşer. Ağ ücreti, müşterinin seçtiği ağda ayrıca ödenir. Güncel koşullar fiyatlandırma sayfasındadır.
FAQ
Kripto ödeme API’si bir ödeme linkiyle aynı mı?
Hayır. Ödeme linki manuel satışlar için paylaşılabilir bir sayfadır. API ödemeyi kendi sisteminizden oluşturur ve kodunuzun yönettiği bir redirectUrl döndürür.
Bir blockchain düğümü çalıştırmam gerekir mi?
Hayır. Qvard ağları izler ve son durumu webhook ile bildirir; düğüm veya tarayıcı çalıştırmanız gerekmez.
Fiyat hangi para biriminde?
price alanı currency alanındaki para birimindedir (ör. INR veya EUR); alan yoksa USD’dir. Müşteri ödemeyi hosted sayfada seçtiği varlık ve ağla yapar.
Canlıya geçmeden test edebilir miyim?
Evet. Demo fatura oluşturun ve müşterilerinizin göreceği aynı hosted ödeme sayfasını görün.
