Emanetsiz tahsilat
Fonlar doğrudan merchant cüzdanına gider. BoltUtil zinciri izler ve bildirim gönderir, fon tutmaz.
Entegrasyon rehberi
USDT / USDC ödeme webhooku neden sadece retry ile başarılı olabilir
Ödeme completed olduğu halde merchant uygulaması ikinci denemede güncelleniyorsa sorun genellikle endpoint erişilebilirliği, imza doğrulama, timeout veya idempotent olmayan teslimattadır.
Adımlar
Webhook retry teşhis akışı
İlk callbacki başarısız olan completed USDT / USDC siparişlerini debug eden geliştiriciler için uygundur.
01 Siparişin BoltUtil içinde completed olduğunu doğrulayın.
02 Başarısız ilk deneme ile başarılı retryı karşılaştırın: status, latency, timeout ve response body.
03 JSON parse etmeden önce raw body ile HMAC doğrulayın.
04 External order ID ve tx hash ile idempotent teslimat yapıp sonra webhooku yeniden gönderin.
BoltUtil ödemeyi kontrol eder ve imzalı callback gönderir. Sunucunuz imzayı, durumu ve tekrarları kontrol ettikten sonra teslimat, etkinleştirme veya bakiye işlemini yapar.
Entegrasyon notları
Canlıdan önce önemli noktalar
Beş USDT / USDC ağı
TRC20, ERC20, BEP20, Polygon ve Solana USDT / USDC ödemelerini tek sipariş API ve birleşik webhook payload ile kabul edin.
Webhook otomasyonu
Ödeme tespit edilip onaylandığında backend imzalı callback alır ve sipariş otomatik işlenir.
timestamp + "." + raw_request_body
→ HMAC_SHA256 with webhook secret
→ Verify timestamp / signature
→ Validate order and payment
→ Persist and deduplicate
→ 2xx responseEntegrasyon ve sorun giderme örnekleridir. İstek gönderilmez. Sipariş verilerinizi, ağ yapılandırmanızı ve API belgelerini kullanın.
API dokümanlarını okuEmanetsiz tahsilat
Fonlar doğrudan merchant cüzdanına gider. BoltUtil zinciri izler ve bildirim gönderir, fon tutmaz.
Beş USDT / USDC ağı
TRC20, ERC20, BEP20, Polygon ve Solana USDT / USDC ödemelerini tek sipariş API ve birleşik webhook payload ile kabul edin.
Webhook otomasyonu
Ödeme tespit edilip onaylandığında backend imzalı callback alır ve sipariş otomatik işlenir.
Entegrasyon rehberi
Canlıya çıkmadan önce sorulan sorular
Retry, USDT / USDC ödemenin geç algılandığı anlamına mı gelir?
Şart değil. Sipariş completed ise scanner çalışmıştır; retry merchant callback teslimatıyla ilgilidir.
Webhook endpointim ne döndürmeli?
İmzayı doğrulayıp olayı kalıcı kaydettikten sonra 2xx döndürün. Redirect ve uzun bloklayıcı işlerden kaçının.
Hangi ağlar USDT ve USDC destekler?
TRON yalnızca USDT destekler. Ethereum, BNB Smart Chain, Polygon, Solana ve Base yapılandırılmış USDT / USDC sürümlerini kullanır. Kullanılabilirlik etkin kanallara ve satıcı cüzdanlarına bağlıdır.
Daha net bir USDT / USDC ödeme akışı başlatın
Müşterilerden ödeme ekran görüntüsü istemeden sipariş oluşturun, transferleri izleyin ve backendinizi bilgilendirin.