Sitede kripto checkout ve yönlendirme: dönüşüm ve ödünler
Gömülü kripto checkout ve yönlendirme: her model dönüşümü, kontrolü ve çabayı nasıl etkiler. Qvard widget'i canlı. Yaklaşımları karşılaştırın ve doğrusunu seçin.
Gömülü kripto checkout, ödemeyi sayfanızın içinde tutarken yönlendirme müşteriyi hosted bir sayfaya gönderir. Her modelin dönüşüm, kontrol ve çaba açısından ödünleri vardır. Qvard widget'i artık canlı, bu rehber iki yaklaşımı karşılaştırır ve nasıl seçileceğini gösterir.
Gömülü checkout ne demektir
Gömülü checkout, JavaScript widget'i aracılığıyla sayfanızda doğrudan açılan bir ödeme penceresidir. Modal pencere (içeriğin üstünde) veya gömülü form olabilir. Müşteri sitenizin bağlamında kalır ve ayrılmadan öder. Ödeme mantığı hosted sayfadaki ile aynıdır; yalnızca sunum farklıdır.
Qvard'da nasıl çalışır
Widget https://qvard.com/checkout.js adresinden yüklenur ve ödeme penceresini modal (pop-up) veya bir öğeye gömülü olarak açar. Pencere aynı Qvard ödeme sayfasıdır: müşteri varlık ve ağ seçer, tutar siparişinize göre sabittir. Widget örneği tarayıcıda ödeme oluşturmak için genel anahtarınızı (qvard_pk_...) alır veya sunucuda oluşturmak için ödeme kimliğini alır. Canlı deneyin.
Ö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 ucunuz POST /api/v1/payment aracılığıyla ödeme oluşturur ve ödeme kimliğini widget'e geçirir. Sabit fiyata veya envanter sınırlarına sahip siparişler için, fiyatın tarayıcıda değiştirilmemesi için sunucu oluşturmayı kullanın. Veya widget'i atlayın ve müşteriyi hosted ödeme sayfasına yönlendirin.
<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();Sunucuda: önce ödemeyi oluşturun
Sunucunuz x-api-key başlığı ile sipariş kimliğini ve USD cinsinden fiyatı gönderir. Yanıt ödeme kimliğini ve redirectUrl'i döndürür. Kimliği tarayıcıdaki widget'e geçirin veya hosted yönlendirme için redirectUrl'i kullanın. Anahtarı sunucuda tutun, çünkü istek tarayıcıdan yapılamaz.
x-api-key: qvard_sk_…
{
"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
}Webhook'tan ödemeyi doğrulayın
Durum paid olduğunda, webhook'unuz kimliği ve durumu alır, X-Qvard-Signature başlığı (HMAC-SHA256) ile imzalanır. İmzayı gizli anahtarınızla (qvard_sk_...) doğrulayın ve tutarın siparişinizle eşleştiğini kontrol edin. İmza doğrulamasından sonra siparişi ödenen olarak işaretleyin.
Gömülü pencereyi ne zaman kullanmalısınız
Müşteriyi sayfanızda tutmak için gömülü modal veya gömülü pencereyi kullanın. Yönlendirmeli hosted sayfa da aynı derecede iyi çalışır ve ödeme penceresini gömüyor olmayı tercih ederseniz bir seçenektir. Her iki yaklaşım da aynı ödeme oluşturma ve webhook akışını kullanır.
FAQ
Gömülü kripto checkout bugün Qvard'da mevcut mi?
Evet. Widget'i https://qvard.com/checkout.js adresinden yükleyin ve tarayıcıda oluşturmak için genel anahtarınızı (qvard_pk_...) geçin veya sunucuda ödeme oluşturun ve kimliği geçin.
Widget'i siteime nasıl eklerim?
Etiketi <script src="https://qvard.com/checkout.js"></script> ve anahtarınızla QvardCheckout örneğini oluşturun, tutar ve mod (modal veya inline). Bu makaledeki kod örneklerine ve demoya bakın.
Ödeme imzası önemli mi?
Evet. Her zaman webhook'unuzdaki X-Qvard-Signature başlığını gizli anahtarınızla doğrulayın ve webhook'taki tutarın siparişinizle eşleştiğini kontrol edin.
Gömülü pencere yerine yönlendirmeyi kullanabilir miyim?
Evet. redirectUrl'deki hosted ödeme sayfası da aynı derecede iyi çalışır ve widget gerektirmez. Her iki yaklaşım da aynı API ve webhook'u kullanır.
