Kripto ödeme adımında redirectUrl nasıl çalışır

redirectUrl nedir

https://api.qvard.com/api/v1/payment adresine tek bir POST ile bir ödeme oluşturursunuz (x-api-key başlığı, sipariş numaranız id, tutar ABD doları cinsinden price). Yanıt iki alanla 201 olur: Qvard'daki ödeme tanımlayıcısı id ve https://my.qvard.com/pay/<id> biçimindeki redirectUrl.

Adres, barındırılan bir ödeme sayfasına götürür: sunucunuzun değil Qvard'ın işlettiği bir sayfa. Onu kurmaz, barındırmaz ve bakımını yapmazsınız. Göreviniz müşteriyi o adrese getirmek ve sonucu sonradan webhook'tan öğrenmektir.

Müşteri ne görür

Sayfada müşteri:

1. bir varlık ve ağ seçer (veya paymentSystemId ile önceden seçtiğinizi bulur);
2. gönderilecek adresi ve kesin tutarı görür; ağ adresin yanında gösterilir;
3. transferi kendi cüzdanından veya borsasından gönderir.

Sayfadaki kur bir saat sabittir, yani müşteri öderken tutar değişmez. Mağazanız nasıl görünürse görünsün sayfa aynıdır ve mesele de budur: kurmadan çalışan bir kripto ödeme adımı elde edersiniz. Entegre etmeden önce görmek için bir demo fatura açın.

Bağlantıyı ödeme adımında kullanma

Standart kullanım, üç adımda bir sunucu tarafı yönlendirme veya bir düğmedir:

1. Müşteri «Kriptoyla öde» seçer. Sunucunuz kendi siparişinizi ve Qvard ödemesini oluşturur.
2. Sunucunuz redirectUrl ile yanıt verir; bir HTTP yönlendirmesi olarak ya da ön yüzünüzün gezinmek için kullandığı bir değer olarak.
3. Tarayıcı sayfaya gider; müşteri orada öder.

Ödemeyi sepet kurulurken değil, müşteri düğmeye bastıktan sonra oluşturun. Gizli API anahtarını asla tarayıcıya göndermeyin: tarayıcı yalnızca redirectUrl alır. Tam bir düğme örneği web siteleri için kripto ödeme düğmesi yazısındadır.

Bağlantıyı ödeme adımı dışında kullanma

Sayfa düz bir adreste barındırıldığı için bağlantı bir web ödeme adımının dışında da çalışır:

• Bir fatura e-postasında veya PDF'inde, banka bilgilerinin yanında; böylece kurumsal bir müşteri kriptoyla ödemeyi seçebilir (bkz. B2B faturaları için stablecoin ödemeleri).
• Bir sohbette veya destek mesajında, kendi araçlarınızla elle oluşturduğunuz tek seferlik bir ödeme için.
• Bir QR kodunun ardında, kendi sisteminiz adresten bir tane üretiyorsa.

Bağlantıyı tek bir ödemenin girişi olarak ele alın. Ait olduğu müşteriye gönderin ve yayımlamayın. Ayrı kodsuz bir ürün olarak ödeme bağlantıları geliştirme aşamasında; bugün ödemeyi API ile oluşturur ve döndürdüğü adresi paylaşırsınız.

Tekrarlar, yeniden denemeler ve ödemeden sonra ne olur

• Aynı sipariş iki kez. Aynı ödeme yöntemi için aynı id göndermek mevcut ödemeyi döndürür; böylece çift tıklama veya yeniden denenen istek ikinci bir ödeme değil aynı ödemeyi verir.
• Henüz dönüş URL'si yok. Ödemeden sonra müşteri otomatik olarak sitenize geri gönderilmez; dönüş URL'leri henüz yok. Ona gerçek durumu gösteren ve beklerken kendini yenileyen bir sipariş sayfası verin.
• Sonuç webhook'tur. Qvard, ödeme tamamlandığında callback URL'nizi id değeriniz ve durumla çağırır. Uç noktanız tam olarak HTTP 200 yanıtlamalı ve iki kez çalışmaya karşı güvenli olmalıdır. Müşterinin siteye dönmesi ödeme kanıtı değildir. Bkz. kripto ödeme webhook'ları nasıl güvenli hale getirilir.

Bağlantının yapmadıkları

Aramanız gerekmesin diye:

• Ödeme durumunu söylemez; bir ödemeyi id ile okuyan rota yoktur, bu yüzden webhook'u ve kendi kayıtlarınızı kullanın.
• Müşteriyi sitenize geri getirmez; dönüş URL'leri henüz yok.
• Sipariş sayfanızın yerini almaz: yine de «bekleniyor», «kısmi» veya «ödendi» gösteren birine ihtiyacınız var.

İstek ve yanıt biçimleri geliştiriciler için kripto ödeme API'si yazısında, tüm akış ise bir web sitesinde kripto ödemesi nasıl kabul edilir yazısındadır.

FAQ