JavaScript kripto ödeme örneği: bugün çalışan bir akış
JavaScript kripto ödeme örneği: canlı v1 API ile çalışan bir akış, sunucu çağrısı ve webhook, ayrıca roadmap olarak işaretli planlanan SDK çağrısı.
Bu JavaScript kripto ödeme örneği bugün çalışan bir akışı gösterir: sunucu canlı v1 API ile ödemeyi oluşturur, tarayıcı hosted sayfaya yönlendirilir ve webhook siparişi onaylar. Sondaki Low-Code SDK çağrısı yalnızca yol haritasından bir önizlemedir.
Dört adımda akış
Müşteri öde düğmesine basar, sunucunuz ödemeyi oluşturur, tarayıcı redirectUrl’e gider ve webhook son durumu onaylar. Her adım düz bir HTTP çağrısı ya da yönlendirmedir, bu yüzden örnek özel bir kütüphane gerektirmez.
JavaScript ile sunucu çağrısı
Bir Node.js işleyicisi, x-api-key başlığı, sipariş numarası ve USD cinsinden fiyatla POST /api/v1/payment gönderir ve tarayıcıya redirectUrl’i döndürür. Anahtar asla sunucudan çıkmaz.
x-api-key: sk_live_…
{
"id": "order_1024",
"price": 149.99,
"paymentSystemId": 12
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}Tarayıcı tarafı
Sayfanın yalnızca işleyicinizi çağıran ve sonra dönen redirectUrl’i izleyen bir düğmeye ihtiyacı vardır. Tarayıcıda anahtar ya da tutar mantığı yoktur.
Webhook işleyicisi
Webhook endpoint’i id ve status’u okur, x-api-key başlığını kontrol eder ve durum paid olduğunda siparişi ödendi olarak işaretler. Aynı mesaj iki kez gelebileceği için işleyiciyi tekrara dayanıklı yapın.
x-api-key: sk_live_…
{ "id": "order_1024", "status": "paid" }Planlanan SDK çağrısı
Yol haritasındaki Low-Code SDK’nın aynı akışı sayfadan tek bir çağrıyla açması bekleniyor. Bu, yayınlanmamış bir API’nin önizlemesidir; yalnızca yönlendirme amacıyla gösterilir ve üretimde kullanılmamalıdır.
Canlıya geçmeden test edin
Demo fatura oluşturun, hosted sayfada ödeyin ve webhook’unuzun son durumu aldığını ve siparişi işaretlediğini doğrulayın.
// ROADMAP preview: the SDK is not released yet.
QvardCheckout.open({ amount: 149.99, currency: "USD", orderId: "order_1024" });FAQ
Bu örnek bir SDK kullanıyor mu?
Hayır. Çalışan akış düz HTTP çağrıları ve bir yönlendirme kullanır. SDK çağrısı yalnızca yol haritası önizlemesidir.
QvardCheckout.open() çağrısını üretimde kullanabilir miyim?
Hayır. SDK henüz yayınlanmadı. API, redirectUrl ve webhook’u kullanın.
API anahtarı nerede tutulmalı?
Yalnızca sunucuda. Tarayıcı yalnızca redirectUrl alır.
Ödemenin tamamlandığını nasıl anlarım?
Yalnızca webhook id ve paid durumunu ilettiğinde.
