SDK

Kripto checkout JavaScript SDK’sı: planlanan ve bugün çalışan

Kripto checkout JavaScript SDK’sı açıklandı: ödeme penceresini açan planlanan bir betik, Qvard yol haritasındakiler ve bugün çalışanlar. Adım adım.

Kripto checkout için bir JavaScript SDK’sı, sitenizde birkaç satır kodla bir ödeme penceresi açardı. Qvard’ın Low-Code SDK’sı yol haritasında ve henüz yayınlanmadı. Bu rehber fikri açıklar ve bugün kullanabileceğiniz gerçek v1 akışını gösterir.

Bir checkout SDK’sı ne yapar

Checkout SDK’sı, bir sitenin ödemeyi başlatmak için yüklediği küçük bir JavaScript kütüphanesidir. Ödeme penceresini çizer, müşteriyi adımlardan geçirir ve durumu sayfaya geri bildirir. Sipariş mantığı satıcının sunucusunda kalır.

Durum: SDK yol haritasında

Qvard Low-Code SDK’sı henüz yayınlanmadı ve bu makale onu hazır bir kütüphane olarak anlatmaz. Aşağıdaki parça, planlanan çağrının bir önizlemesidir; bugün çalıştırabileceğiniz bir kod değildir.

Bugün çalışan

Ödemeyi sunucunuzda x-api-key başlığıyla POST /api/v1/payment ile oluşturun, müşteriyi hosted checkout sayfasındaki redirectUrl’e yönlendirin ve son durumu webhook ile alın. Bu, planlanan SDK çağrısının çalışan karşılığıdır.

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
}

Sunucu çağrısı

Sipariş numarasını id olarak, USD cinsinden fiyatı price olarak gönderin. API anahtarını sunucuda tutun; tarayıcı yalnızca sunucunun döndürdüğü redirectUrl’i alır.

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

Planlanan SDK çağrısı

Yol haritasındaki SDK’nın aynı ödeme akışını sayfadan tek bir çağrıyla açması bekleniyor. Metot adı ve seçenekler yayından önce değişebilir, bu yüzden önizlemeye henüz kod yazmayın.

Nasıl hazırlanılır

Ödeme oluşturmayı bir backend fonksiyonunda, webhook işleyicisini ayrı tutun. SDK yayınlandığında yalnızca ön yüz çağrısı değişir; sunucu çağrısı ve webhook aynı kalır.

FAQ

Bugün Qvard’ın JavaScript checkout SDK’sı var mı?

Hayır. Low-Code SDK yol haritasında. Bugün aynı sonuç API, hosted checkout sayfası ve webhook ile elde edilir.

QvardCheckout.open() çağrısını şimdi kullanabilir miyim?

Hayır. Yalnızca planlanan API’nin önizlemesi olarak gösterilir. POST /api/v1/payment kullanın ve redirectUrl’e yönlendirin.

Bugün kripto kabul etmek için JavaScript kütüphanesi gerekir mi?

Hayır. Backend’inizi çağırıp redirectUrl’e yönlendiren sıradan bir düğme yeterlidir; ödemeyi webhook onaylar.

Akışı nasıl test ederim?

Demo fatura oluşturun ve webhook’unuzun son durumu aldığını doğrulayın.

İlgili makaleler

İlgili makaleler