Hızlı Entegrasyon Rehberi

BoltUtil kripto ödeme ağ geçidini mevcut işletme mantığınıza sorunsuz bir şekilde entegre etmek için bu dört adımı izleyin.

1

Arka Yüz (Backend) Başlatma: Sipariş Oluştur

Backend

/api/v1/orders/create uç noktasını çağırın. Ağ geçidimiz, önceden yapılandırılmış alıcı adresinizi ilgili işleme atayacaktır.

Güvenlik İpucu: HTTP Üstbilgisinde (Header) X-Bolt-Key ve imzanın yer aldığından emin olun.
2

Ön Yüz (Frontend) Yönlendirme: Ödeme Arayüzü

Frontend

Kullanıcıları minimalist ödeme sayfamıza yönlendirmek için yanıttaki checkoutUrl bilgisini kullanın veya QR kodunu doğrudan oluşturun. Kullanıcılar, fonları kendi özel cüzdanlarından doğrudan size özel adrese transfer edeceklerdir.

TRON (TRC20) ve yerel Uygulama çağırma desteğine sahip ana akım cüzdanlarla tam uyumludur.
3

Sistem Gönderimi: Geri Bildirimleri (Callbacks) Dinleyin

Webhook

Düğüm (node) kümelerimiz blok zinciri defterini gerçek zamanlı olarak izler. Bir işlem onayı tespit edildiğinde, sistem txHash dahil tüm ödeme detaylarını içeren bir POST isteğini notifyUrl adresinize anında gönderir.

Ağ dalgalanmalarını yönetmek için uç noktanızın, olası mükerrer bildirimleri güvenli bir şekilde işleyebilecek 'idempotency' yapısına sahip olduğundan emin olun.
4

İş Teslimatı: Doğrula ve Tamamla

Backend

Webhook bildirimini aldığınızda, imza algoritmamızı kullanarak veri kaynağını doğrulayın. Geri bildirimdeki tutar siparişle eşleştiğinde, sistem durumunu güncelleyin ve kullanıcıya teslimatı tamamlayın.

Sıfır Güven (Zero Trust): Başarılı HMAC imza doğrulaması ve tutar eşleşmesi olmadan asla bir siparişi tamamlamayın.