USDC ödeme entegrasyon rehberi

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ı
ERC20	USDC	0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48Kopyala	6
BEP20	USDC	0x8ac76a51cc950d9822d68b83fe1ad97b32cd580dKopyala	18
POLYGON	USDC	0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359Kopyala	6
SOLANA	USDC	EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1vKopyala	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ı

Ethereum, Polygon, Solana ve Base yerel USDC kullanır. BNB Smart Chain 18 ondalıklı Binance-Peg USDC kullanır. TRC20 USDC desteklemez. USDbC, USDC.e ve başka sözleşmeler listelenen kimliklerin yerini tutmaz.

• ERC20 burada Ethereum ana ağıdır, standardı kullanan tüm ağlar değildir. Aynı 0x adresi farklı EVM ağlarında bulunabilir; sipariş ağını ve token sürümünü kullanın. USDC yerel Circle sürümüdür; köprü sürümleri yerine geçmez.

İ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":"USDC","network":"ERC20","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ı