Kripto ödeme widget’ı: sitenize nasıl eklenir
Kripto ödeme widget’ı rehberi: Qvard’ın gömülü checkout’u sitenize entegre edin. Sunucu ve tarayıcıda ödeme oluşturma, webhook imza doğrulaması, demo.
Kripto ödeme widget’ı, sitenizde ödeme penceresi açan bir JavaScript widget’ıdır. Qvard widget’ı şu anda https://qvard.com/checkout.js’de canlı. Bu rehber nasıl çalıştığını ve nasıl entegre edileceğini açıklar.
Kripto ödeme widget’ı nedir
Widget, bir sitenin ödemeyi başlatmak için gömdüğü kompakt bir ödeme öğesidir. Qvard’da widget, müşterilerinizin gördüğü aynı ödeme sayfasını modal veya gömülü form içinde açar. Müşteri varlık ve ağı seçer; tutar siparişiniz tarafından belirlenir.
Qvard’da nasıl çalışır
Widget, https://qvard.com/checkout.js’den yüklenir ve ödeme penceresini modal (açılır pencere) veya gömülü moddaki olarak açar. Pencere, aynı Qvard ödeme sayfasıdır: müşteri varlık ve ağı fatura süresi boyunca sabit kur üzerinden seçer. Widget örneği, tarayıcıda oluşturma için genel anahtarınızı (qvard_pk_…) veya sunucuda oluşturma için bir ödeme id’sini alır. Demo sayfasında https://qvard.com/en/embedded-checkout/playground/ adresinde canlı olarak deneyin.
<script src="https://qvard.com/checkout.js"></script>
new QvardCheckout({
mode: 'modal',
publishableKey: 'qvard_pk_…',
price: 10,
onSuccess: function (e) {
console.log('paid', e.paymentId);
}
}).open();Ödeme oluşturmanın iki yolu
Tarayıcıda: genel anahtarı (qvard_pk_…) ve tutarı widget’e geçirin; ödemeyi oluşturur ve pencereyi açar. Sunucuda: arka uçunuz POST /api/v1/payment aracılığıyla ödemeyi oluşturur ve id’yi widget’e geçirir. Sabit fiyat veya stok limiti olan siparişler için sunucuda oluşturmayı kullanın, böylece müşteri tarayıcıda fiyatı değiştiremez. Alternatif olarak, widget’i atlayın ve müşterileri barındırılan ödeme sayfasına yönlendirin.
Backend çağrısı
Sunucunuz sipariş numarasını id olarak, USD cinsinden fiyatı price olarak x-api-key başlığıyla gönderir. Yanıtta ödeme id’si ve redirectUrl yer alır. Tarayıcıda id’yi widget’e geçirin veya redirectUrl’i bir yönlendirme için kullanın. Gizli anahtarı (qvard_sk_…) hiçbir zaman tarayıcıya göndermeyin.
Webhook’tan ödemeyi doğrulayın
Durum ödendi olduğunda webhook endpoint’iniz id ve status’u alır, X-Qvard-Signature başlığı (HMAC-SHA256) ile imzalanmıştır. Gizli anahtarınızı (qvard_sk_…) kullanarak imzayı doğrulayın ve webhook’taki tutarın siparişinizle eşleşip eşleşmediğini kontrol edin. Siparişi imza doğrulamasından sonra ödendi olarak işaretleyin. Not: widget’in onSuccess olayı ödeme kanıtı değildir.
Gömülü pencereyi ne zaman seçersiniz
Müşterileri sayfanızda tutmak için gömülü modal veya gömülü formu kullanın. Barındırılan ödeme sayfası yönlendirmesi eşit derecede iyi çalışır ve ödeme penceresini gömüştürmemeyi tercih ederseniz seçeneğinizdir. Her iki yaklaşım da aynı API ve webhook’u paylaşır.
FAQ
Qvard’ın kripto ödeme widget’ı bugün mevcut mu?
Evet. Widget’i https://qvard.com/checkout.js’den yükleyin ve tarayıcıda oluşturma için genel anahtarınızı (qvard_pk_…) geçirin veya sunucuda ödemeyi oluşturup id’yi geçirin.
Widget’i sitime nasıl eklerim?
<script src="https://qvard.com/checkout.js"></script> etiketini ekleyin ve QvardCheckout’u anahtarınız, tutarınız ve moddunuzla (modal veya gömülü) başlatın. Bu makaledeki kod örneklerine ve demoya bakın.
Widget müşteriyi sitemde tutuyor mu?
Evet, modal veya gömülü moddaki. Barındırılan sayfaya yönlendirme müşteriyi başka bir siteye götürür, ancak ödeme yapıldıktan sonra bir bağlantı ile geri döner.
Akışı nasıl test ederim?
Bir demo ödeme oluşturun ve webhook işleyicinizin imzalı statüsü aldığını ve tutarın eşleştiğini doğrulayın, canlıya geçmeden önce.
