
Web sitenizde tek API çağrısıyla USDT ödemesi nasıl alınır?
Suawave ile USDT alın: ödeme adresi oluşturun, ağı ve QR kodunu gösterin, callback imzalarını doğrulayın ve aktarım sonrası siparişi güncelleyin.
Yayın tarihi , güncelleme
Suawave ile USDT almak için aktarım cüzdanınızı ve HTTPS callback URL’nizi göndererek ödeme adresi oluşturun. Müşteriye adresi, ağı ve minimum tutarı gösterin. Her callback imzasını doğrulayın, olayı siparişle eşleştirin ve yalnızca onaylı callback yeterli USDT alındığını gösterince siparişi tamamlayın.
Başlıktaki tek çağrı ödeme adresini oluşturur. Sitenizin ayrıca ödeme ekranına ve callback işleyicisine ihtiyacı vardır. Hızlı başlangıç rehberi tüm akışı açıklar.
1. Ağı seçin ve minimumu okuyun
Ticker hem ağı hem varlığı belirler. Örneklerdeki trc20/usdt, TRON üzerindeki USDT’dir. Ödeme boyunca ağı görünür tutun; yalnızca “USDT” yazmak müşterinin gönderim için ihtiyaç duyduğu bilgiyi eksik bırakır.
Siparişi oluşturmadan GET /trc20/usdt/info/ isteyin:
curl "https://api.suawave.com/trc20/usdt/info/"
Yanıttaki minimum_transaction_coin alanını okuyun. Tutarları ondalık dize olarak tutun; kesin ondalık aritmetik veya varlığın tamsayı birimlerini kullanın.
| Ödeme ekranındaki bilgi | Kaynak |
|---|---|
| Seçilen ticker için minimum | info veya create yanıtındaki minimum_transaction_coin |
| Oluşturulan adresin ücretleri | create yanıtı |
| Gerçekte aktarılan tutar | Onaylı callback içindeki value_forwarded_coin |
Ücret rehberi kesintileri açıklar. Aktarım maliyeti tahmini ağın yerel parasında yapılandırılmış üst sınırı döndürür; USDT ödemesinden kesilecek ücretin kotasyonu değildir.
2. Ödeme adresini oluşturun
Sunucuda sipariş referansı ve yeni, tahmin edilemez nonce saklayın. Sonradan karşılaştırmak için ikisini callback URL’sine ekleyin. GET /trc20/usdt/create/ çağrısını aktarım adresiniz ve callback ile yapın. Örnekteki adres, sipariş ve nonce değerlerini kendi değerlerinizle değiştirin:
curl -G "https://api.suawave.com/trc20/usdt/create/" \
--data-urlencode "address=TXyzPayoutAddressExample0000000000000" \
--data-urlencode "callback=https://shop.example/hook?order=1001&nonce=7f3a9c" \
--data-urlencode "pending=1"
Kısa nonce yalnızca örnektir. Gerçek değeri platformunuzun kriptografik rastgele sayı üreteciyle oluşturun.
Dönen address_in değerini siparişle saklayın; müşteri ödemeyi buraya gönderir. address_out sizin aktarım hedefinizdir. İkisini karıştırmak ödeme akışını bozar.
Kanonik ticker ve callback çifti siparişi belirler. Aynı çift mevcut adresi döndürür ve ilk çağrı seçenekleri sabitler. Aynı çifte farklı aktarım adresi verilmesi reddedilir. Bağımsız izlenecek her siparişte farklı callback URL’si kullanın.
API referansı callback URL normalizasyonunu ve tüm parametreleri açıklar. HTTPS kullanın ve her sorgu değerini URL kodlamasıyla gönderin. Özel ağ ve loopback hedefleri reddedilir.
3. Adresi ve QR kodunu gösterin
Adresi, varlığı, ağı, sipariş tutarını ve minimumu gösterin. QR olsa da tutar metin olarak görünür kalsın. GET /trc20/usdt/qrcode/ için gerçek address_in değerini kullanın; aşağıdaki adres ve tutar örnektir:
curl -G "https://api.suawave.com/trc20/usdt/qrcode/" \
--data-urlencode "address=TDepositAddressExample0000000000" \
--data-urlencode "value=25.5"
Yanıtta PNG data URI olan qr_code ve QR içeriğinin tam metni olan payment_uri bulunur.
TRON’da QR yalnızca adres içerir. API value alanını doğrular ama QR’a koymaz; müşteri tutarı cüzdanında girer. EVM token’larında value, EIP-681 aktarım isteği oluşturur. Cüzdan desteği değişir ve müşteri tutarı değiştirebilir. QR taramak ödeme kanıtı değildir; kararı doğrulanmış callback verileri verir.
4. Siparişi değiştirmeden callback’i doğrulayın
Varsayılan GET’tir. İlk create çağrısında post=1 form POST, json=1 JSON POST seçer; JSON önceliklidir. Özel sorgu parametreleriniz URL’de kalır.
x-ca-signature başlığını GET /pubkey/ anahtarıyla doğrulayın. GET için özgün sorgu sırası dahil tam URL, POST için ayrıştırılmamış ham gövde kullanılır. İmza örneklerini izleyin.
Ardından sipariş referansını, nonce, address_in ve coin alanlarını kontrol edin. trc20/usdt için callback coin değeri trc20_usdt olur.
| Alan | Anlam | İşlem |
|---|---|---|
pending değeri "1" |
Ödeme tespit edildi | Bekleyin; siparişi tamamlamayın |
pending değeri "0" |
Aktarım işlemi onaylandı | Onaylı tutarı siparişle karşılaştırın |
İsteğe bağlı tespit olayını pending=1 ile isteyin. Bekleyen ve onaylı olayların UUID’leri farklıdır; aynı olayın tekrarlarında UUID değişmez. Teslimatın yinelenmemesi için UUID’leri kalıcı saklayın.
5. Ödemeyi kaydedin ve alındı yanıtı verin
Onaylı callback içinde value_coin ödeme, fee_coin kesilen ücret ve value_forwarded_coin net aktarım tutarıdır. Sipariş politikanızın hangi değeri esas aldığını belirleyip kesin aritmetikle karşılaştırın.
Yanıt vermeden olayı ve sipariş değişikliğini birlikte kaydedin. 30 saniye içinde HTTP 200 ve düz *ok* döndürün. İşlenmiş olayda işi tekrarlamadan aynı yanıtı verin.
Callback sırası değişebilir. Geç gelen bekleyen olay onaylanmış ödemeyi geri almamalıdır. Callback rehberi iletim ve tekrarları açıklar.
Eksik callback için özgün URL ile GET /trc20/usdt/logs/ sorgulayın. sent, aktarımın onaylandığını ama callback’in alındı yanıtı almadığını belirtir; tükenen denemeler de buna dahildir.
Küçük veya tekrarlanan ödemeler
Minimum USDT ödemesi ne kadar?
Seçilen ticker’ın minimum_transaction_coin değerini okuyun. İlk tespit anında geçerli olan minimum uygulanır.
Müşteri siparişten az gönderirse ne olur?
Sipariş toplamı ile ticker minimumunu ayırın. Uygun bir ödeme toplamı karşılamayabilir. Onaylı ödemeler politikanızı karşılayana kadar siparişi ödenmemiş tutun. Her ödemenin aktarımı ve callback’i ayrıdır; toplamadan önce tekrarları eleyin.
Minimum altı ödeme aktarılmaz, callback üretmez ve genel loglarda görünmez. Minimumu müşteriye önceden gösterin.
Ödeme ne zaman onaylıdır?
İmza ve sipariş ayrıntıları doğrulandıktan sonra pending değeri "0" olan olayı esas alın. Tespit, QR taraması veya create yanıtı siparişin ödendiğini kanıtlamaz.