Sayfanızın üzerinde modalYakında
Ödeme penceresi mevcut sayfanın üzerinde açılır; müşteri sepetteki yerini korur.
Ödeme penceresi sayfanızın üzerinde modal olarak açılır; müşteri mağazadan hiç ayrılmaz. Hosted checkout sayfasıyla aynı fatura mantığı.
Sayfanız, API ile oluşturulan faturayla ödeme penceresini açar.
Müşteri modal içinde öder, yönlendirme olmadan.
Son durum webhook ile gelir ve modal kapanır.
Ödeme penceresi mevcut sayfanın üzerinde açılır; müşteri sepetteki yerini korur.
Tutar, varlık, ağ ve sabit kur, hosted checkout sayfasındaki gibi çalışır.
Sipariş durumu son webhook’tan gelir, tarayıcı penceresinin durumundan değil.
Mağazanızda ödeme penceresini açmak için tek bir betik çağrısı yeterlidir.
Qvard birkaç ödeme ürünü sunar. Satış kanalınıza uyan ürünü seçin.
A quick overview of how Qvard handles payments, integration and merchant operations.
Qvard, hosted checkout, faturalar, API ödemeleri ve merchant bakiyeleri sunan işletmeler için bir kripto ödeme ağ geçididir.
Qvard USDT, USDC, BTC, LTC, TRX, BNB ve ETH ödemelerini destekler. TON ve TON üzerindeki USDT yakında.
Evet. Qvard; API ödemeleri, redirectUrl, webhook'lar, yeniden denemeler ve teslimat günlükleri içerir.
Checkout; merchant logosu, mağaza adı, buton rengi ve yerelleştirmeyi destekler. Özel dönüş URL'leri yakında.
Bir merchant hesabı oluşturun ve işletme doğrulamasını tamamlayın. Bir test faturasıyla akışı denedikten sonra hosted checkout veya API bağlantısını kurun ve gerçek ödemeleri kabul etmeye başlayın.
Fonlar, varlık ve ağ bazında ayrılan merchant bakiyelerinde takip edilir. Çekimi manuel yapabilir veya otomatik ödemeler için çekim kuralları tanımlayabilirsiniz.
Qvard ödeme widget'ini üç şekilde entegre edin:
Herkese açık anahtarınız (qvard_pk_…) sayfa kodunuzda kalabilir. Sadece mağazanız için ödemeler oluşturabilir—verileri okuyamaz veya fon çekmez. Sadece İzin Verilen Kaynaklar'daki alan adlarından çalışır ve hız sınırlaması vardır.
Sunucunuzun tutarı hesaplaması veya envanteri kontrol etmesi gerekiyor mu? "Sunucunuz aracılığıyla" sekmesini kullanın: arka ucunuz gizli anahtarla (qvard_sk_…) ödemeyi oluşturur, ve sadece ödeme URL'si tarayıcıya gider.
<script src="https://qvard.com/checkout.js"></script> <script> // 1. Ödemeyi açıklayın var checkout = new QvardCheckout({ mode: 'modal', publishableKey: 'qvard_pk_YOUR_PUBLISHABLE_KEY', price: 10, orderId: 'order-123', onSuccess: function (e) { // 3. Sonucu işleyin console.log('paid', e.paymentId); }, onError: function (err) { console.log(err.code); } }); // 2. Pencereyi oluşturun ve gösterin checkout.open(); </script>
# Sunucunuzda ödeme oluşturun curl -X POST https://api.qvard.com/api/v1/payment \ -H 'x-api-key: qvard_sk_YOUR_SECRET_KEY' \ -H 'Content-Type: application/json' \ -d '{"price":10,"id":"order-123"}' # Yanıt: {"id":"...","redirectUrl":"https://my.qvard.com/pay/..."} // Tarayıcıda ödeme penceresini açın <script src="https://qvard.com/checkout.js"></script> <script> // 1. Ödemeyi açıklayın var checkout = new QvardCheckout({ mode: 'modal', paymentUrl: 'https://my.qvard.com/pay/...', // Sunucu yanıtından redirectUrl'yi alın onSuccess: function (e) { // 3. Sonucu işleyin console.log('paid', e.paymentId); } }); // 2. Pencereyi oluşturun ve gösterin checkout.open(); </script>
<div id="checkout"></div> <script src="https://qvard.com/checkout.js"></script> <script> // 1. Ödemeyi açıklayın var checkout = new QvardCheckout({ mode: 'inline', target: '#checkout', publishableKey: 'qvard_pk_YOUR_PUBLISHABLE_KEY', price: 10, onSuccess: function (e) { // 3. Sonucu işleyin console.log('paid', e.paymentId); } }); // 2. Pencereyi oluşturun ve gösterin checkout.open(); </script>
Tam API referansı: api.qvard.com/doc
| Seçenek | Açıklama |
|---|---|
| mode | modal | inline |
| target | CSS seçicisi veya DOM öğesi (yalnızca inline modu) |
| publishableKey | Herkese açık anahtarınız—tarayıcıdan ödeme oluşturmak için gerekli |
| paymentId | Önceden oluşturulmuş ödemenin UUID'si—sunucu akışı için gerekli |
| paymentUrl | Sunucu yanıtından tam ödeme URL'si—sunucu akışı için gerekli |
| price | USD cinsinden tutar (publishableKey ile gerekli) |
| orderId | Sizin işlem kimliğiniz (isteğe bağlı, maks 128 karakter, atlanırsa otomatik olarak oluşturulur) |
| paymentSystemId | Ödeme yöntemi kimliği (isteğe bağlı, hesap ayarlarınızdan) |
| locale | Ödeme sayfası dili: en, ru, es, pt, tr, id, vi, fr, de (varsayılan tarayıcı dili) |
| theme | light | dark (isteğe bağlı) |
| onSuccess | Ödeme başarılı olduğunda geri çağırma: function(e) { console.log(e.paymentId); } |
| onClose | Kullanıcı ödeme yapmadan pencereyi kapattığında geri çağırma |
| onError | Hata durumunda geri çağırma: function(err) { console.log(err.code, err.message); } |
Hata kodları: invalid_mode, invalid_target, invalid_options, invalid_payment_url, network_error, invalid_key, origin_not_allowed, duplicate_order, rate_limited, invalid_request, payment_failed.