Dokümantasyon

Sık sorulan sorular

Suawave ile kripto ödeme almayı, ödeme adresi oluşturmaktan onay bildirimini işlemeye kadar tüm adımlarıyla öğrenin.

Başlangıç

Hesap açmadan USDT TRC20 ödemesi nasıl alabilirim?

Suawave ile kayıt olmadan, hesap açmadan ve API anahtarı kullanmadan USDT TRC20 ödemesi alabilirsiniz. GET /trc20/usdt/create/ isteğine kendi cüzdan adresinizi ve herkese açık HTTPS bildirim adresinizi ekleyin; dönen address_in adresini ve minimum_transaction_coin alt limitini, seçilen tickerin belirttiği token ve ağ ile birlikte müşteriye gösterin.

Dokümantasyona bakın
Her sipariş için nasıl ayrı bir ödeme adresi oluşturabilirim?

Her Suawave siparişi için sipariş referansı ve tahmin edilemez bir nonce içeren benzersiz bir bildirim URL’si kullanın. Aynı ticker ve bildirim URL’siyle create isteğini tekrarlamak aynı ödeme adresini döndürür ve ilk seçenekleri korur; URL’nin tamamını sunucunuzda saklayın.

Dokümantasyona bakın

Tokenler ve ağlar

Suawave hangi tokenleri ve ağları destekliyor?

Suawave şu etkin ödeme seçeneklerini destekler: BNB Smart Chain BEP20 ağında USDC (bep20/usdc); BNB Smart Chain BEP20 ağında USDT (bep20/usdt); TRON TRC20 ağında USDT (trc20/usdt). Seçilen token ve ağ için ticker değerini küçük harflerle ve aynen kullanın; yalnızca cüzdan adresine bakarak token standardı belirlenemez.

Dokümantasyona bakın
Müşteri yanlış token gönderirse veya yanlış ağı seçerse ne olur?

Suawave yalnızca sipariş için seçilen token ve ağdaki ödemeleri işler. Başka tokenlerle yapılan transferler aktarılmaz, herkese açık API’de bildirim veya log kaydı oluşturmaz; farklı ağdan gelen bir ödemenin kurtarılabileceğini ya da kabul edileceğini varsaymayın.

Dokümantasyona bakın

Ücretler ve alt limitler

Suawave her ödeme için ne kadar ücret alıyor?

Suawave her transferden ayrı ücret alır: asgari tutara tabi bir hizmet bedeli ve ödeme tokeni cinsinden ağ ücreti. Önceki 30 günlük USD hacmine göre hizmet bedeli kademeleri: $250,000 altı: 0.50%; $250,000 ile $999,999 arası: 0.45%; $1,000,000 ile $2,499,999 arası: 0.40%; $2,500,000 ile $4,999,999 arası: 0.35%; $5,000,000 ile $9,999,999 arası: 0.30%; $10,000,000 ile $19,999,999 arası: 0.20%; $20,000,000 ve üzeri: 0.13%. Yayımlanan token ücretleri: BNB Smart Chain BEP20 USDC: asgari hizmet bedeli 0.05 USDC, ağ ücreti 0.05 USDC; BNB Smart Chain BEP20 USDT: asgari hizmet bedeli 0.05 USDT, ağ ücreti 0.05 USDT; TRON TRC20 USDT: asgari hizmet bedeli 0.05 USDT, ağ ücreti 1.00 USDT. Ücretler her transfer için belirlenir; gerçekleşen kesinti fee_coin, aktarılan tutar value_forwarded_coin alanında gösterilir.

Dokümantasyona bakın
Suawave ile alınabilecek en düşük kripto ödeme tutarı nedir?

Suawave her token ve ağ için ayrı bir alt limit uygular: BNB Smart Chain BEP20 USDC: 1.00 USDC; BNB Smart Chain BEP20 USDT: 1.00 USDT; TRON TRC20 USDT: 10.00 USDT. Ödeme talebini göstermeden önce create veya info yanıtındaki minimum_transaction_coin değerini kontrol edin; geçerli alt limit, transfer ilk tespit edildiğinde kaydedilir.

Dokümantasyona bakın
Alt limitin altındaki birkaç transfer birleşerek geçerli bir ödeme olur mu?

Hayır. Suawave alt limiti her transfer için ayrı değerlendirir; alt limitin altındaki birkaç transfer birleşerek geçerli bir ödeme oluşturmaz. Böyle bir transfer aktarılmaz, ödenmez, bildirim göndermez ve herkese açık loglarda görünmez.

Dokümantasyona bakın

Onaylar ve kesinleşme

Suawave ödemesini ne zaman tamamlandı olarak işaretleyebilirim?

Siparişi ancak pending değeri 0 olan Suawave onay bildiriminin imzasını doğrulayıp siparişi, tokeni, adresi ve tutarı kontrol ettikten sonra tamamlandı olarak işaretleyin. Bu bildirim, uygun transferin cüzdanınıza aktarıldığını ve aktarım işleminin onaylandığını gösterir; bekleyen ödeme bildirimi tek başına siparişi teslim etmek için yeterli değildir.

Dokümantasyona bakın
Suawave kaç onay bekler, bu sayıyı değiştirebilir miyim?

Suawave, çağrıyı yapanın seçtiği bir onay sayısı yerine ilgili zincirin kesinleşme kuralını uygular. TRON’da solidified verisi, BNB Smart Chain’de finalized blok başlıkları beklenir; herkese açık create uç noktası özel onay sayısı veya öncelik ayarı kabul etmez. İndeksleme ve aktarım da zaman aldığı için blok aralığı, ödemenin tamamlanma süresi değildir.

Dokümantasyona bakın
Bekleyen ödeme bildirimi müşterinin ödemesinin tamamlandığını gösterir mi?

pending değeri 1 olan Suawave bildirimi, indeksleyicinin uygun bir transfer tespit ettiğini gösterir; aktarımın onaylandığı anlamına gelmez. Bu isteğe bağlı bildirimi ilk create çağrısında pending=1 ile açın; bekleyen ve onaylanan ödeme bildirimleri farklı UUID değerleri taşır ve ters sırayla gelebilir.

Dokümantasyona bakın

Bildirimler ve imza doğrulama

Suawave bildirimleri JSON veya form POST olarak gönderebilir mi?

Evet. Suawave varsayılan olarak GET, post=1 ile form POST, json=1 ile JSON POST bildirimi gönderir; ikisi birlikte verilirse JSON kullanılır. İlk create çağrısı bu seçenekleri ticker ve bildirim URL’si çifti için sabitler; kendi sorgu parametreleriniz bildirim URL’sinde kalır.

Dokümantasyona bakın
Suawave bildirim imzasını nasıl doğrularım?

x-ca-signature başlığındaki base64 RSA-SHA256 PKCS#1 v1.5 imzasını, Suawave’in GET /pubkey/ uç noktasından aldığınız açık anahtarla doğrulayın. GET bildirimlerinde özgün istek URL’sinin tamamı, POST bildirimlerinde ham gövdenin birebir baytları imzalanır. Alanları ayrıştırmadan veya güvenmeden önce imzayı kontrol edin, anahtarı önbelleğe alın; doğrulama başarısızsa isteği reddetmeden önce anahtarı bir kez yenileyin.

Dokümantasyona bakın
Bir bildirimi nasıl yanıtlamalıyım, Suawave tekrar gönderir mi?

Suawave bildirimini kabul etmek için 30 saniye içinde HTTP 200 ve *ok* gövdesi döndürün; büyük küçük harf ayrımı olmadan düz ok da kabul edilir. Toplam 8 deneme vardır: ilk gönderimden sonra sırasıyla 30 saniye, 2 dakika, 10 dakika, 30 dakika, 2 saat, 6 saat, 24 saat gecikmeyle, %10 oranına kadar ek rastgele beklemeyle tekrar gönderilir. Tekrarlarda uuid değişmez; aynı işlemi iki kez yapmamak için bu değeri kalıcı olarak saklayın.

Dokümantasyona bakın
Bildirim gelmezse ödemenin durumunu nasıl kontrol ederim?

Uygun transferleri kontrol etmek için Suawave’in GET /trc20/usdt/logs/ uç noktasını özgün bildirim URL’siyle çağırın. pending aktarımın henüz onaylanmadığını, sent aktarımın onaylandığını ancak onay bildiriminin kabul edilmediğini, done ise bu bildirimin kabul edildiğini gösterir. Boş log yanıtı hiç transfer yapılmadığını kanıtlamaz; alt limitin altındaki, desteklenmeyen ve geç transferler görünmeyebilir.

Dokümantasyona bakın

Eksik, fazla ve geç ödemeler

Müşteri sipariş tutarından daha az ödeme yaparsa ne olur?

Onaylanan tutarın sipariş için yeterli olup olmadığına mağazanız karar verir; Suawave’in herkese açık create uç noktası fatura tutarı almaz. Brüt tutarı esas alıyorsanız value_coin, net tutarı esas alıyorsanız value_forwarded_coin değerleriyle uygun ve onaylanmış transferleri toplayın; tekrarlanan bildirimleri UUID ile ayıklayın. Her ek transfer kendi alt limitini karşılamalıdır ve ayrı ücretlendirilir.

Dokümantasyona bakın
Müşteri fazla kripto gönderirse ne olur?

Suawave uygun transferi, mağazanızdaki sipariş tutarını aşan kısmı da dahil ederek ücretler düşüldükten sonra aktarır. Herkese açık API fazla tutarı otomatik iade etmez; mağazanız fazla ödemeyi nasıl işleyeceğine karar vermeli ve gerekiyorsa kendi cüzdanından iade yapmalıdır.

Dokümantasyona bakın
Müşteri ödeme adresinin süresi dolduktan sonra gönderirse ne olur?

Suawave, siparişin kabul süresi dışında kalan transferi inceleme için tutar; cüzdanınıza aktarmaz, herkese açık bildirim veya log kaydı oluşturmaz. Uygunluk, transferin geçerli zamanı ile kayıtlı süre sonuna eklenen yapılandırılmış ek süreye göre belirlenir; zamanında gelen bir transfer daha sonra kesinleşebilir. Süresi dolan adresleri göstermeyi bırakın ve geç ödemeleri elle kontrol edin; müşteriye otomatik iade taahhüdü yoktur.

Dokümantasyona bakın

Ödeme aktarımı ve cüzdanlar

Suawave ödemeleri cüzdanıma nasıl aktarır?

Suawave her uygun transferi, ücretler ve zincir kontrollerinden sonra create çağrısında verdiğiniz tek cüzdan adresine ayrı ayrı aktarır. Onay bildirimi txid_out ve value_forwarded_coin alanlarını içerir; sunucunuz bu alanlarla aktarım işlemini ve alınan net tutarı belirleyebilir.

Dokümantasyona bakın
Alıcı cüzdanını değiştirebilir veya ödemeyi cüzdanlar arasında bölebilir miyim?

Suawave her ticker ve bildirim URL’si çiftini tek bir alıcı cüzdanına bağlar; mevcut çiftin alıcı adresi değiştirilemez. Başka bir alıcı cüzdanı kullanmak için yeni bildirim URL’siyle yeni sipariş oluşturun; herkese açık API paylara bölmeyi veya birden fazla alıcıyı desteklemez.

Dokümantasyona bakın

Güvenlik ve fonların tutulması

Suawave kriptoyu aktarmadan önce elinde tutar mı?

Suawave ödemeyi önce kendi kontrolündeki ödeme adresinde alır, ardından uygun fonları alıcı cüzdanınıza aktarır. Aktarım anlık veya koşulsuz değildir; zincir kontrolleri, ücretler, alt limitler ve süre sonu kuralları geçerlidir, uygun olmayan transferler tutulabilir.

Dokümantasyona bakın
Bildirim URL’min tamamını neden gizli tutmalıyım?

Suawave bildirim URL’sinin tamamı, siparişin herkese açık API loglarına erişim sağlar; bu yüzden URL’yi sunucuda saklayın ve tahmin edilemez bir nonce ekleyin. Gelen bildirimlerin imzasını yine de doğrulamalısınız; geçerli imzalı bir bildirimin kayıtlı sipariş, beklenen token, adres ve tutarla da eşleşmesi gerekir.

Dokümantasyona bakın

Eklentiler, SDK ve MCP

WooCommerce, Magento, OpenCart veya PrestaShop ile kripto ödeme alabilir miyim?

Suawave, WooCommerce, Magento 2, OpenCart ve PrestaShop için mağaza entegrasyonları sunar. Eklentiyi kurup ayarlamak, ödeme adresini ve QR kodunu göstermek, imzalı ödeme bildirimlerini işlemek için kullandığınız platformun entegrasyon kılavuzuna bakın.

Dokümantasyona bakın
Suawave entegrasyonu için hangi SDK’ları kullanabilirim?

Suawave’in herkese açık API için Go ve JavaScript/TypeScript SDK’ları vardır. HTTP uç noktalarını doğrudan da çağırabilir, bildirim işleyiciniz için Go, JavaScript, PHP veya C# imza doğrulama örneklerini kullanabilirsiniz.

Dokümantasyona bakın
Bir yapay zekâ asistanı Suawave’i MCP üzerinden kullanabilir mi?

Evet. Suawave MCP sunucusu, ödeme adresi oluşturma ve ödeme loglarını kontrol etme dahil herkese açık ödeme API’si için araçlar sunar. Herkese açık ödeme akışı satıcı anahtarı gerektirmez ve yönetici işlemlerini açmaz; bildirim URL’lerini ve gizli nonce değerlerini paylaşılan istemlere veya herkese açık çıktılara koymayın.

Dokümantasyona bakın

CryptAPI’den geçiş

CryptAPI entegrasyonumu Suawave’e nasıl taşırım?

API adresini Suawave olarak değiştirin, yeni sipariş ve ödeme adresleri oluşturun, bildirimleri Suawave’in /pubkey/ uç noktasından aldığınız kendi anahtarıyla doğrulayın. Geçmeden önce ticker desteğini, süre sonunu, bildirim tekrarlarını ve desteklenmeyen parametreleri inceleyin; CryptAPI’nin açık anahtarını veya IP izin listesini kullanmayın.

Dokümantasyona bakın

Limitler, süre sonu ve iadeler

Suawave API isteklerini veya yeni ödeme adreslerini sınırlar mı?

Evet. Suawave istemci IP’si ve bildirim alan adına göre istek limitleri, yeni ticker ve bildirim URL’si çiftleri için de ayrı kotalar uygular. HTTP 429 yanıtında bekleyip yeniden deneyin ve varsa Retry-After değerine uyun; mevcut çifti yeniden kullanmak yeni çift kotasına takılmaz, ancak istek limitine dahildir.

Dokümantasyona bakın
Suawave bir kripto ödemeyi otomatik iade edebilir mi?

Suawave’in herkese açık API’sinde müşteriye iade uç noktası yoktur; fazla veya geç ödemeler otomatik geri gönderilmez. Uygun ödeme cüzdanınıza aktarıldıysa gereken iadeyi mağazanız kendi cüzdanından yapmalıdır; tutulan geç transferler elle mutabakat gerektirir ve otomatik iade edilmez.

Dokümantasyona bakın
Aynı Suawave adresini yeniden oluşturmak ödeme süresini uzatır mı?

Hayır. Mevcut ticker ve bildirim URL’si çifti için create çağrısını tekrarlamak, sipariş süresini uzatmadan ilk ödeme adresini ve expires_at değerini döndürür. Ödeme ekranında dönen UTC süre sonunu esas alın, süresi dolan adresi göstermeyin ve yeni sipariş için yeni bir bildirim URL’si kullanın.

Dokümantasyona bakın