SDK

Kripto ödeme düğmesi: sitenize nasıl eklenir

Kripto ödeme düğmesi rehberi: sitenize kripto ile öde düğmesi nasıl eklenir, planlanan SDK düğmesi nedir ve bugün ne çalışır. Kodla. Adım adım kod örneği.

Kripto ödeme düğmesi, sitenizde kripto ödemeyi başlatan tek bir düğmedir. Planlanan Qvard SDK’sı böyle bir düğmeyi birkaç satır kodla oluşturabilirdi, ancak henüz yayınlanmadı. Bu rehber, bugün canlı API ile çalışan bir düğmenin nasıl kurulacağını gösterir.

Kripto ödeme düğmesi ne yapar

Ödeme düğmesi, müşteri tıkladığında bir ödeme başlatır. Kripto bir sitede tıklama, müşterinin varlık ve ağ seçtiği bir ödeme sayfasına götürür. Düğmenin kendisi para veya anahtar tutmaz.

Durum: SDK düğmesi yol haritasında

Qvard’ın SDK düğmesi henüz yayınlanmadı. Bu makale onu tamamlanmış bir bileşen olarak sunmaz; medyadaki önizleme kodu roadmap olarak işaretlidir.

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
}

Bugün çalışan bir düğme

Düğme backend’inize istek gönderir. Backend, POST /api/v1/payment ve x-api-key başlığıyla ödemeyi oluşturur ve redirectUrl’i döndürür. Düğme müşteriyi oraya yönlendirir ve webhook ödemeyi onaylar.

Düğmeyi ödeme akışına yerleştirin

Düğmeyi sepetin sonuna, toplamın yanına koyun. Tıklamadan önce USD cinsinden tutarı gösterin ki müşteri hosted sayfada neyle karşılaşacağını bilsin.

Düğmeyi güvenli yapın

API anahtarını düğmenin kodunda tutmayın. Ödemeyi yalnızca müşteri tıkladığında oluşturun ve sipariş toplamını tarayıcıda değil sunucuda kontrol edin.

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

Webhook ile doğrulayın

Webhook id ve paid durumunu ilettiğinde siparişi ödendi olarak işaretleyin. Düğmeye tıklamak paranın geldiği anlamına gelmez.

FAQ

Bugün Qvard’ın bir ödeme düğmesi bileşeni var mı?

SDK bileşeni olarak yok; SDK yol haritasında. Bugün backend’inizi çağıran sıradan bir düğme aynı işi yapar.

Düğme tutarı başka bir para biriminde gösterebilir mi?

API isteğindeki fiyat USD’dir. Hosted sayfa, seçilen varlıkta tam tutarı sabit kurla gösterir.

Düğme webhook olmadan yeterli mi?

Hayır. Düğme yalnızca ödemeyi başlatır. Siparişi yalnızca webhook’tan ödendi olarak işaretleyin.

Düğmeyi nasıl test ederim?

Demo fatura akışını kullanın ve ödemeden sonra webhook’un siparişi işaretlediğini doğrulayın.

İlgili makaleler

İlgili makaleler