Backend’e kripto ödeme entegrasyonu, adım adım
Backend’e kripto ödeme entegrasyonu adım adım: sunucunuzdan ödeme oluşturun, müşteriyi yönlendirin, webhook’ları doğrulayın ve siparişleri uzlaştırın.
Kripto ödemeyi bir backend’e entegre etmek üç parça gerektirir: ödemeyi oluşturan sunucu çağrısı, müşteri yönlendirmesi ve siparişi kapatan bir webhook. Bu rehber her adımı Qvard v1 API ile anlatır.
Adım 1: önce siparişi kaydedin
API’yi çağırmadan önce siparişi pending gibi bir durumla veritabanınıza kaydedin. Sipariş numaranızı id alanında kullanın; böylece ödeme ve sipariş baştan itibaren bağlı olur.
Adım 2: ödemeyi oluşturun
Backend’inizden x-api-key başlığıyla /api/v1/payment adresine POST gönderin; sipariş numaranızı id’de, toplam tutarı price’ta taşıyın. API anahtarını sunucu yapılandırmasında tutun, asla ön yüz kodunda değil.
Adım 3: müşteriyi yönlendirin
Dönen redirectUrl’i siparişle birlikte saklayın ve müşteriyi oraya gönderin. Hosted sayfada müşteri varlık ve ağı seçer ve tam tutarı öder.
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
}Adım 4: siparişi webhook’tan kapatın
Webhook endpoint’iniz x-api-key’i kontrol eder, siparişi id ile bulur ve status paid olduğunda ödendi olarak işaretler. Ödemenin onaylandığı tek yer burasıdır.
Adım 5: uzlaştırın ve izleyin
Çok uzun süre beklemede kalan siparişleri her gün kontrol edin ve ödeme kayıtlarınızla karşılaştırın. Her API yanıtını ve her webhook’u destek için kaydedin.
x-api-key: sk_live_…
{ "id": "order_1024", "status": "paid" }Mimari ipuçları
Ödeme kodunu ödeme sayfalarından ayrı, küçük bir serviste tutun. Böylece webhook işleyicisini değiştirebilir veya ikinci bir kanal ekleyebilirsiniz; mağazanın geri kalanına dokunmanız gerekmez.
FAQ
Hangi backend dillerini kullanabilirim?
JSON gövdeli bir HTTPS POST gönderebilen ve webhook alabilen her dil. API düz HTTP’dir, bu yüzden SDK gerekmez.
Webhook URL’ini nereye koymalıyım?
Backend’inizde herkese açık bir HTTPS endpoint kullanın. POST kabul etmeli ve bir siparişi güncellemeden önce x-api-key başlığını kontrol etmelidir.
Her kripto para birimi için ayrı entegrasyon gerekir mi?
Hayır. Varlık ve ağı müşteri hosted checkout sayfasında seçer; backend’iniz USD cinsinden tek bir ödeme oluşturur ve tek bir durum okur.
Tüm entegrasyonu önce test edebilir miyim?
Evet. Demo fatura akışıyla test faturası ödeyin ve gerçek ödemeleri kabul etmeden önce webhook işleyicinizin çalıştığını doğrulayın.
