Ö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.
Entegrasyon rehberi
Ö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
İlk callbacki başarısız olan completed USDT / USDC siparişlerini debug eden geliştiriciler için uygundur.
CONFIRMED: Webhook teslimat denemelerini, yanıtları ve imzayı kontrol edin. Hatayı araştırmak için COMPLETED durumunu beklemeyin.
Başarısız ilk deneme ile başarılı retryı karşılaştırın: status, latency, timeout ve response body.
JSON parse etmeden önce raw body ile HMAC doğrulayın.
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ı
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.
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.
Ö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ı okuEntegrasyon rehberi
Şart değil. Sipariş completed ise scanner çalışmıştır; retry merchant callback teslimatıyla ilgilidir.
İmzayı doğrulayıp olayı kalıcı kaydettikten sonra 2xx döndürün. Redirect ve uzun bloklayıcı işlerden kaçının.
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.
Müşterilerden ödeme ekran görüntüsü istemeden sipariş oluşturun, transferleri izleyin ve backendinizi bilgilendirin.