Online mağazanıza stablecoin checkout gömmek
Stablecoin checkout'u mağazanıza gömmek: gömülü widget'i nasıl kullanır, tarayıcı ve sunucu tarafında ödeme oluşturma ve webhook doğrulaması.
Stablecoin checkout gömmek, online mağazanızın içine bir USDT veya USDC ödeme penceresi koymak demektir. Qvard'ın gömülü checkout widget'i bugün stablecoin'leri kabul eder. Müşterileriniz ödeme sayfasında kripto aktif ve ağı seçer, siz de webhook'la ödemeyi doğrularsınız.
Gömülü stablecoin checkout nedir
Gömülü stablecoin checkout, mağazanızın sayfasında bir JavaScript widget'i aracılığıyla açılan bir ödeme penceresidir. Modal (açılır pencere) veya gömülü (öğede gömülü) olabilir. Müşterileriniz sayfanızda kalır ve USDT veya USDC'yle ayrılmadan öderler. Ödeme penceresi, iframe'de aynı Qvard sayfasıdır: müşteri sayfayı kendi dilinde görür, tercih ettikleri stablecoin aktifini ve ağı seçer, tutar fatura için sabit kurla hesaplanır.
Qvard'da nasıl çalışır
Widget, https://qvard.com/checkout.js'den yüklenip modal veya gömülü olarak stablecoin ödeme penceresini açar. Pencere mevcut aktif ve ağları gösterir; müşteri seçer, gönderilecek tutar gösterilir. Widget şu olayları yayar: onSuccess (ödeme yapıldı), onClose (pencere kapatıldı), onError (ödeme başarısız). Widget örneği tarayıcı tarafında oluşturma için kamu anahtarınızı (qvard_pk_...) ya da sunucu tarafında oluşturma için ödeme kimliğini alır. qvard.com'da demo sayfasını deneyin.
Ödeme oluşturmanın iki yolu
Tarayıcıda: kamu anahtarını (qvard_pk_...) ve tutarı widget'e geçirin; ödemeyi oluşturur ve pencereyi açar. Müşteri tarayıcıda tutarı değiştirebilir, bu nedenle bilgilendirme amaçlı kullanın. Kamu anahtarınız panelde izin verilen sitelerle kısıtlanabilir ve istekler hız sınırlı. Sunucuda: backend, POST /api/v1/payment üzerinden ödeme oluşturur ve ödeme kimliğini widget'e iletir. Sabit veya kritik tutarlı siparişler için sunucu tarafında oluşturmayı kullanın ve webhook'ta tutarı daima doğrulayın. Ya da widget'i atlayıp müşterileri barındırılan ödeme sayfasına yönlendirin.
Sunucuda: ödemeyi önce oluşturun
Sunucunuz, /api/v1/payment'a POST isteği gönderir (sipariş kimliği ve fiyat USD'de, x-api-key üstbilgisinde gizli anahtar qvard_sk_...). Yanıt { id, redirectUrl }'ı döndürür. Kimliği tarayıcıda widget'e geçirin ya da redirectUrl yönlendirmesi için kullanın. Gizli anahtarınızı sunucuda tutun; istek tarayıcıdan yapılmamalıdır.
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 { id, status }'ı X-Qvard-Signature başlığıyla alır (format: t=...,v1=... - HMAC-SHA256, gizli anahtar ile). Gizli anahtarınızla (qvard_sk_...) imzayı doğrulayın ve webhook'taki tutar siparişle eşleştiğini onaylayın. qvard_sk_ öneki olmayan eski anahtarlar da x-api-key üstbilgisini alır. Ödemeyi imza doğrulandıktan sonra işaretleyin. Qvard belgelerinde imza rehberine bakın.
Gömülü pencereyi ne zaman seçin
Müşterileri sayfanızda tutmak ve sorunsuz stablecoin checkout sunmak için gömülü modal veya widget'i kullanın. Yönlendirmeli barındırılan sayfa eşit oranda iyi çalışır ve ödeme penceresini gömmemeyi tercih ederseniz bir seçenektir. Her ikisi de aynı ödeme oluşturma, webhook akışı ve imza doğrulamasını paylaşır.
FAQ
Gömülü stablecoin checkout bugün Qvard'da mı var?
Evet. Widget'i https://qvard.com/checkout.js'den yükleyin ve tarayıcıda oluşturma için kamu anahtarını (qvard_pk_...) geçirin ya da sunucuda ödeme oluşturup kimliği geçirin.
Müşteriler widget'te stablecoin ve ağı nasıl seçer?
Müşteriler ödeme sayfasında mevcut stablecoin aktif ve ağları görür ve kullanmak istediğini seçer. Gönderilecek tutar seçime göre güncellenir.
Neden webhook'ta tutarı doğrulamalıyım?
Webhook'taki tutar Qvard'ın gerçek kaynağıdır. Sunucuda ödeme oluştursanız bile siparişle eşleştiğini daima doğrulayın çünkü müşteri stablecoin ve ağı seçti.
Canlıya geçmeden nasıl test ederim?
qvard.com'da demo sayfasını kullanarak widget'i test edin ve webhook olaylarını görün. Widget'in imzayı doğruladığını ve siparişi ödendi olarak işaretlediğini onaylayın.
