Base stablecoin ödeme entegrasyonu

Ana ağda desteklenen token kimlikleri

Sözleşmeler ve Mint adresleri ön tanımlıdır, canlı kanal durumu değildir. Sipariş için etkin ağ ve varlık ile geçerli satıcı cüzdanı gerekir. Her zaman API’nin payment.address adresine ödeme yapın; sözleşme veya Mint adresine göndermeyin.

Ana ağda desteklenen token kimlikleri

Ağ	Para birimi	Sözleşme / Mint	Token ondalık basamakları
BASE	USDT	0xfde4c96c8593536e31f229ea8f37b2ada2699bb2Kopyala	6
BASE	USDC	0x833589fcd6edb6e08f4c7c32d4f71b54bda02913Kopyala	6

Satıcı kurulumu

1. Ağa ait alıcı cüzdanı ve etkin Webhook URL’si ile anahtarını ayarlayın. API Key ve HMAC anahtarını yalnızca sunucuda tutun.
2. network / currency çiftinin kullanılabilirliğini kontrol edin. RPC, ağ ve varlıkları yöneticiler yönetir; satıcılar tarayıcı dağıtmak zorunda değildir.
3. Yanıttaki payment.amount, payment.address, currency, network ve süre sonunu gösterin. QR verisi bir görüntü değildir.
4. HTTP 2xx yanıtından önce imzayı doğrulayın, tekrarları ayıklayın ve olayı kalıcı kaydedin. Sipariş teslimatını idempotent işleyin.

Ağ ve varlık notları

• Base ana ağ chain ID 8453’tür, Base Sepolia değildir. Satıcı cüzdanı ayarlar; yönetici RPC ve ağ etkinliğini yönetir. USDC yerel Circle, USDT yapılandırılmış köprü sürümüdür; USDbC dahil değildir. L1-finalized güvenli yüksekliğiyle taranır: geri sayım bitmeden aktarın, onay daha sonra gelebilir ve sabit süre yoktur. WooCommerce kurulu sürümünü, desteklenen ağ ve para birimlerini kontrol edin.

İmzalı istek ve yanıt örnekleri

25.00 örnek tutardır. Gerçek sipariş tutarını kullanın ve varlığın alt sınırını karşılayın. Adres, sipariş ve işlem karmaları örnektir. Kopyalanan cURL / Java istek gönderir: çalıştırmadan önce kendi anahtarlarınızı ayarlayın.

# Run against your account only when ready; this sends an API request.
: "${BOLTUTIL_API_KEY:?Set your complete API Key}"
: "${BOLTUTIL_WEBHOOK_SECRET:?Set your Webhook secret}"
timestamp=$(python3 -c 'import time; print(int(time.time()*1000))')
body='{"amount":"25.00","currency":"USDT","network":"BASE","externalOrderId":"INV-20260209-99281"}'
signature=$(printf '%s.%s' "$timestamp" "$body" | openssl dgst -sha256 -hmac "$BOLTUTIL_WEBHOOK_SECRET" | awk '{print $NF}')

curl --request POST "https://api.boltutil.com/api/v1/order/create" \
  --header 'Content-Type: application/json' \
  --header "X-Bolt-Key: $BOLTUTIL_API_KEY" \
  --header "X-Bolt-Timestamp: $timestamp" \
  --header "X-Bolt-Signature: $signature" \
  --data-binary "$body"

Onay ve bildirim işleme

Algılama onay değildir. Durumu ve doğrulanmış callback’leri kullanın: PAID onay bekler. CONFIRMED / COMPLETED elle kabul sonucu da olabilir; paidAmount, shortfallAmount, settlementType alanlarını kontrol edin. COMPLETED teslimatı kanıtlamaz.

Entegrasyon soruları