Sorular ve yanıtlar
Entegrasyonu yapanların ilk siparişten önce sorduğu şeyler — gruplanmış ve kısa. Yanıtın bizim alışkanlığımıza değil sözleşmeye ait olduğu yerlerde, aynı şeyi API belgeleri ayrıntısıyla söylüyor.
Enerji ve fiyat
TRON enerjisi nedir?
Akıllı sözleşme çalıştırmanın bedelini ödeyen bir ağ kaynağı. Gönderen cüzdanda yeterli enerji varsa bir USDT transferi neredeyse hiç TRX yakmaz.
Neden yakmaktan ucuz?
Yakmak enerjiyi protokol oranıyla fiyatlar, birim başına ~210 sun — hiç kıpırdamayan bir sayı. Biz devredilen enerjiyi toplu alır ve bu oranın küçük bir kısmına satarız; şu anda geçerli olan fiyat fiyatlar sayfasındadır.
Bütün fiyatları görün →
4 dakikalık pencereyi kaçırırsam ne olur?
mode A'da tahsilat yerinde kalır: enerji teslim edilmiştir ve ödediğiniz şey teslimattır. mode B'de pencere kapandıktan sonra hiçbir şey yayınlamayız; kalem başarısız olur ve rezerv olduğu gibi geri döner. Pencere her siparişle birlikte gelir — akışınızı ona göre kurun.
Gönderim penceresini kaçırmak iki modda da aynı mı tutuyor?
Hayır. mode A'da enerji teslim edilmiştir, tahsilat yerinde kalır — mode C'de de öyle: beklenecek bir transfer yoktur, kalem pencere kapanınca yalnızca süresi dolarak biter. mode B'de pencere kapandıktan sonra hiç yayınlamayız: geç çıkan bir transfer, devredilen enerjinin çoktan geri alındığı bir cüzdana denk gelir ve TRX'inizi yakar. Kalem, broadcast_window_missed ile failed olarak kapanır, rezerv olduğu gibi geri döner, onun için aldığımız enerji de bizim zararımızdır.
Para ve iadeler
Ödemeyi nasıl yaparım?
TRX cinsinden ön ödemeli servis bakiyesi: kişisel adresinize TRX gönderirsiniz, hizmetlere harcarsınız. Fiyatlar sipariş oluşturulurken sabitlenir.
Yatırma adresime hangi jetonu gönderebilirim?
TRX, yalnızca TRX. Yatırma adresine gönderilen USDT kendiliğinden hesaba geçmez: kur riskini üstlenmiyoruz ve dönüştürme hizmeti işletmiyoruz, bu yüzden böyle bir transfer bir insanın bakması için ayrılır ve hesaba geçirilip geçirilmeyeceği her seferinde bizim kararımızdır. Yanlış jeton mu gönderdiniz? Bize yazın ve daha fazlasını göndermeyin.
Yatırılan tutar ne kadar sürede harcanabilir?
3 onaydan sonra — yaklaşık on saniye. Bakiye bundan sonra üç parça hâlinde bildirilir: toplam, sürmekte olan siparişler için tutulan kısım ve kullanılabilir kısım. Sipariş kullanılabilir kısımdan oluşturulur, toplamdan değil.
Siparişi iptal edebilir miyim?
Yalnızca satın alma başlamadan önce; sonrasında yanıt order_not_cancelable olur, çünkü enerji çoktan alınmıştır. İptal edilen sipariş rezervinin tamamını bırakır ve hiçbir şey tahsil etmez.
İade nasıl oluyor?
Serbest bırakmalar kendiliğinden olur ve hiçbir zaman talep açmayı gerektirmez. Kural tek: teslim etmediğimiz enerjinin parası alınmaz ve rezerv servis bakiyesi olarak hesabınıza döner — başarısız bir teslimat, satın alma başlamadan iptal edilen bir sipariş, bir Auto-refill gününün harcanmayan kısmı. Teslim edilen enerji, kullanılmış olsun olmasın, ücretlendirilir.
Güvenlik ve anahtarlar
Hangi anahtarlara ihtiyacınız var?
Hiçbiri. Mode A işleminizi hiç görmez. Mode B zaten imzaladığınız bir işlemi alır ve onun tek bir baytını bile değiştiremeyiz.
Çok imzalı bir gönderici kabul ediyor musunuz?
mode B'de hayır: işlemde tam olarak bir sahip imzası bulunmalı, Permission_id 0 ile. Çok imzalı bir hesabın anahtar takımı ağda yaşar ve bizim haberimiz olmadan değişir, bu yüzden yayının kabul edileceğine söz veremeyiz. mode A'da imzalamanızla ilgili hiçbir şey bize ulaşmaz — transferi siz yayınlarsınız.
Neyi, ne kadar süre saklıyorsunuz?
mode B'de imzaladığınız işlem şifreli tutulur ve sipariş nihai bir duruma ulaştıktan 7 gün sonra silinir. Siparişler, defter kayıtları ve yatırmalar kalır: bu muhasebedir ve saklamakla yükümlü olduğumuz kısım odur. Burada size ait başka hiçbir şey yok — ne özel anahtar, ne kurtarma ifadesi, ne de paranızın saklanması.
Entegrasyon
Limit var mı?
Anahtar başına dakikada 120 sipariş, toplu sipariş başına en fazla 500 transfer. Limiti aşınca sessiz bir düşüş değil, Retry-After alırsınız.
completed aslında ne demek?
Enerjinin teslim edildiği — transferinizin gittiği değil. Taahhüt teslimattır ve sipariş onunla kapanır: mode A'da completed, siz daha hiçbir şey göndermeden gelebilir. Siparişte send_before'un görünmesini kollayın, ready sözcüğünü değil: iki saniyede bir sorarken ready'yi hiç görmeyebilirsiniz.
İdempotentlik nasıl çalışır?
Idempotency-Key, birlikte geldiği gövdenin ham baytlarına bağlıdır. Aynı anahtar ve bayt bayt aynı gövde size aynı siparişi geri verir; aynı anahtar başka bir gövdeyle çakışmadır; doğrulamanın geri çevirdiği bir istek anahtarı harcamaz, dolayısıyla gövde düzeltilince aynı anahtarla yinelenebilir. Gövdeyi bir kez serileştirin ve tam olarak o baytları yeniden gönderin — anahtarların başka bir sırası ya da fazladan bir boşluk zaten başka bir gövdedir.
Hiçbir şey ödemeden bir adresi kontrol edebilir miyim?
Evet, üstelik ücretsiz. GET /v1/address-check bir cüzdan hakkında bildiklerimizi anlatır, POST /v1/estimate ise 500 alıcıya kadar, bir siparişin uygulayacağı kurallarla fiyat çıkarır — hangilerinin jeton sözleşmesince kara listeye alındığı dâhil. İkisi de ne bir şey ayırır ne de bir şey tahsil eder.
Hesabınız
Bir cüzdan kendi kendine dolu kalabilir mi?
Evet — bir Auto-refill kuralı: bir adres artı bir günlük bütçe. Enerji her transferden sonra yeniden dolar; bütçe sert bir günlük tavandır.
balance.low kaça ayarlanmalı?
Sayı sizin ayarınız — PATCH /v1/settings içindeki balance_low_threshold_trx; balance.low ise ona göre düşen olay. İşe yarar ölçü aşağı yukarı bir günlük cironuzdur: o zaman uyarı, siparişler insufficient_balance almaya başlamadan bir gün önce gelir; ilk reddin yerine geçmez. Belirgin biçimde düşük olursa olay olup bittikten sonraki bir bildirime, belirgin biçimde yüksek olursa gürültüye dönüşür. Sıfır onu kapatır.
Test ortamı (sandbox) ya da asgari hacim var mı?
Ne asgari hacim, ne abonelik, ne de boş durma ücreti. Test ortamı (sandbox) da yok: temel adres canlı olanın kendisi ve başkası yok. Referans uç noktaları, bir tahmin ve bir webhook denemesi hiçbir şeye mal olmaz; böylece entegrasyonun büyük bölümü tek bir sipariş oluşmadan kurulabilir.