SDK

Kripto checkout popup: nasıl çalışır ve neler planlanıyor

Kripto checkout popup açıklandı: ödeme penceresi nasıl çalışır, Qvard SDK’sı bunun için ne planlıyor ve bugün neler çalıştırabilirsiniz. Kodla.

Kripto checkout popup, mevcut sayfanın üzerinde açılan bir ödeme penceresidir; böylece müşteri siteden ayrılmadan öder. Bu pencere Qvard SDK’sının bir parçası olarak planlanmıştır ve henüz yayınlanmadı. Bu rehber böyle bir popup’ın nasıl çalıştığını ve bugün API ile neleri çalıştırabileceğinizi anlatır.

Bir ödeme penceresi nasıl çalışır

Sayfa bir fonksiyon çağırır, içeriğin üstünde bir pencere açılır, müşteri ödemeyi bu pencerede tamamlar ve pencere kapanır. Mağaza arka planda kalır ve sipariş sunucuda onaylanır.

Durum: pencere yol haritasında

Qvard checkout popup’ı henüz yayınlanmadı ve bu makale onu tamamlanmış bir özellik olarak tanımlamaz. Medyadaki kod, planlanan çağrının yol haritası önizlemesidir.

Bugün çalışan

x-api-key başlığıyla POST /api/v1/payment ile ödemeyi oluşturun, müşteriyi hosted checkout sayfasındaki redirectUrl’e yönlendirin ve son durumu webhook ile alın. Böylece müşteri popup olmadan aynı ödeme sonucunu elde eder.

POST/api/v1/payment
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
}

Yeni pencereyi dikkatle açmak

Ayrı bir pencere tercih ederseniz redirectUrl’i yalnızca bir tıklamadan sonra yeni sekmede açın. Tarayıcılar kullanıcı eylemi olmadan açılan pencereleri engeller; bu yüzden tıklama önce gelmelidir.

Ödemeyi sunucuda doğrulayın

Pencere geldiğinde sayfada ilerlemeyi gösterecek, ama ödendi durumu yine webhook’tan gelmelidir. Sipariş mantığını şimdiden webhook etrafında kurun.

JSroadmap: not released yet
// ROADMAP preview: the SDK is not released yet.
QvardCheckout.open({ amount: 149.99, currency: "USD", orderId: "order_1024" });

Nelerden kaçınılmalı

Kapatılan pencereyi başarısız ödeme saymayın ve pencere kapanınca siparişi ödendi olarak işaretlemeyin. Webhook sonucunu bekleyin.

FAQ

Bugün Qvard’ın ödeme popup’ı var mı?

Henüz yok. Pencere, yol haritasındaki SDK’nın parçası olarak planlanıyor. Bugün hosted checkout sayfası veya yeni sekme yeterlidir.

Pencere tıklama olmadan açılabilir mi?

Tarayıcılar genellikle engeller. Ödeme sayfasını kullanıcı tıklamasından sonra açın.

Müşteri pencereyi kapatırsa ne olur?

Sonucu kapanma olayına göre belirlemeyin. Sipariş durumunu webhook’tan kontrol edin.

Akışı nasıl test ederim?

Demo fatura oluşturun ve webhook sonucunu doğrulayın.

İlgili makaleler

İlgili makaleler