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.

  1. 01

    CONFIRMED: Webhook teslimat denemelerini, yanıtları ve imzayı kontrol edin. Hatayı araştırmak için COMPLETED durumunu beklemeyin.

  2. 02

    Başarısız ilk deneme ile başarılı retryı karşılaştırın: status, latency, timeout ve response body.

  3. 03

    JSON parse etmeden önce raw body ile HMAC doğrulayın.

  4. 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

Ödeme onayı ve Webhook teslimatı

CONFIRMED, ödemenin onaylandığını gösterir. COMPLETED, Webhook alıcısının 2xx yanıtından sonra oluşur; uygulamanızın ürünü teslim ettiğini kanıtlamaz.

6 ödeme ağı

TRON, Ethereum, BNB Smart Chain, Polygon PoS, Solana, Base. TRON yalnızca USDT destekler. Ethereum, Polygon, Solana ve Base yerel USDC destekler; BNB Smart Chain Binance-Peg USDC kullanır. Base üzerindeki USDT, Bridged USDT sürümüdür. Checkout yalnızca etkin ve geçerli satıcı alıcı cüzdanı bulunan ağ/token çiftlerini gösterir. Yalnızca sembolü değil, yapılandırılmış sözleşmeyi veya mint adresini kontrol edin.

Webhook otomasyonu

Ödeme tespit edilip onaylandığında backend imzalı callback alır ve sipariş otomatik işlenir.

Webhook retry teşhisi
timestamp + "." + raw_request_body
→ HMAC_SHA256 with webhook secret
→ Verify timestamp / signature
→ Validate order and payment
→ Persist and deduplicate
→ 2xx response

Entegrasyon ve sorun giderme örnekleridir. İstek gönderilmez. Sipariş verilerinizi, ağ yapılandırmanızı ve API belgelerini kullanın.

API dokümanlarını oku

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 ve token sürümleri desteklenir?

TRON, Ethereum, BNB Smart Chain, Polygon PoS, Solana, Base. TRON yalnızca USDT destekler. Ethereum, Polygon, Solana ve Base yerel USDC destekler; BNB Smart Chain Binance-Peg USDC kullanır. Base üzerindeki USDT, Bridged USDT sürümüdür. Checkout yalnızca etkin ve geçerli satıcı alıcı cüzdanı bulunan ağ/token çiftlerini gösterir. Yalnızca sembolü değil, yapılandırılmış sözleşmeyi veya mint adresini kontrol edin.

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.