Entegrasyon rehberi

Node.js ile bir web sitesinde USDT / USDC ödemeleri nasıl kabul edilir?

Üretim USDT / USDC ödemesi için bir cüzdan adresinden daha fazlasına ihtiyaç vardır. Node.js'den bir sipariş oluşturun, ödeme verilerini tarayıcıya gönderin ve ardından yalnızca doğrulanmış zincir üstü ödeme web kancasından sonra siparişinizi yerine getirin.

Adımlar

Üretim USDT / USDC ödemesi için bir cüzdan adresinden daha fazlasına ihtiyaç vardır. Node.js'den bir sipariş oluşturun, ödeme verilerini tarayıcıya gönderin ve ardından yalnızca doğrulanmış zincir üstü ödeme web kancasından sonra siparişinizi yerine getirin.

Node.js ile bir web sitesinde USDT / USDC ödemeleri nasıl kabul edilir?

  1. 01

    Tutar, ağ, sipariş ID ve dönüş URL bilgileriyle ödeme siparişi oluşturun.

  2. 02

    Alıcıya cüzdan adresini, QR kodunu, checkout sayfasını ve kesin USDT / USDC tutarını gösterin.

  3. 03

    BoltUtil TRC20, ERC20, BEP20, Polygon veya Solana transferlerini tarar ve ağ, adres, tutar bilgileriyle eşleştirir.

  4. 04

    On-chain onaydan sonra BoltUtil işlem hash ve durum bilgisini içeren imzalı webhook gönderir.

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

Emanetsiz tahsilat

Fonlar doğrudan merchant cüzdanına gider. BoltUtil zinciri izler ve bildirim gönderir, fon tutmaz.

Altı ödeme ağı

TRON, Ethereum, BNB Smart Chain, Polygon, Solana ve Base. TRON yalnızca USDT / USDC destekler; diğer USDT / USDC kanalları etkin varlık ve geçerli cüzdan gerektirir.

Webhook otomasyonu

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

Node.js 22+ · USDC / Base checkout
import crypto from 'node:crypto'

// Node.js 20+ server module. Call only after authenticating the buyer.
// order must come from your database, with ownership and price checked.
// Never pass req.body directly; persist externalOrderId before calling.
export async function createStablecoinCheckout(order) {
  const key = process.env.BOLTUTIL_API_KEY
  const secret = process.env.BOLTUTIL_API_SECRET
  if (!key || !secret) throw new Error('Missing server credentials')

  const payload = JSON.stringify({
    externalOrderId: order.externalOrderId,
    amount: order.amount,
    currency: 'USDC',
    network: 'BASE',
    notifyUrl: 'https://merchant.com/webhooks/boltutil',
    returnUrl: 'https://merchant.com/orders/complete'
  })
  const timestamp = Date.now().toString()
  const signature = crypto.createHmac('sha256', secret)
    .update(`${timestamp}.${payload}`).digest('hex')

  // A timeout does not prove creation failed. Query order/status using
  // the SAME externalOrderId before deciding whether to retry.
  const response = await fetch('https://api.boltutil.com/api/v1/order/create', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-Bolt-Key': key,
      'X-Bolt-Timestamp': timestamp,
      'X-Bolt-Signature': signature
    },
    body: payload,
    signal: AbortSignal.timeout(10000)
  })
  const result = await response.json()
  if (!response.ok || result.code !== 200 || !result.data?.checkoutUrl) {
    throw new Error('Create order failed; reconcile the saved order')
  }
  // Save result.data on the server. Return only checkout data to the buyer.
  return result.data
}

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

Emanetsiz 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

BoltUtil merchant fonlarını tutar mı?

Hayır. BoltUtil emanetsiz bir izleme ve bildirim katmanıdır. Merchant kendi tahsilat cüzdanını yapılandırır.

BoltUtil bir ödemeyi siparişle nasıl eşleştirir?

Sistem ağ, hedef adres, kesin USDT / USDC tutarı, sipariş durumu ve geçerlilik süresini birlikte doğrular.

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.