Base 스테이블코인 결제 연동

메인넷 지원 토큰 식별 정보

컨트랙트와 Mint는 기본 설정이며 실시간 채널 상태가 아닙니다. 주문 생성에는 활성 네트워크와 자산, 유효한 판매자 지갑이 필요합니다. API의 payment.address로 보내고 컨트랙트나 Mint에는 송금하지 마세요.

메인넷 지원 토큰 식별 정보

네트워크	통화	컨트랙트 / Mint	토큰 소수 자릿수
BASE	USDT	0xfde4c96c8593536e31f229ea8f37b2ada2699bb2복사	6
BASE	USDC	0x833589fcd6edb6e08f4c7c32d4f71b54bda02913복사	6

판매자 설정

1. 해당 네트워크의 수신 지갑과 활성 Webhook URL 및 키를 설정하세요. API Key와 HMAC 키는 서버에만 보관하세요.
2. network / currency 조합의 사용 가능 여부를 확인하세요. 관리자가 RPC, 네트워크, 자산을 관리하므로 판매자는 스캐너를 배포할 필요가 없습니다.
3. 응답의 payment.amount, payment.address, currency, network 및 만료 시간을 표시하세요. QR 데이터는 이미지가 아닙니다.
4. 서명을 검증하고 중복을 제거한 후 이벤트를 영구 저장하고 HTTP 2xx를 반환하세요. 주문 처리는 멱등성을 유지하세요.

네트워크 및 자산 유의 사항

• Base 메인넷 chain ID는 8453이며 Base Sepolia가 아닙니다. 판매자는 지갑을 설정하고 관리자는 RPC 및 네트워크 활성화를 관리합니다. USDC는 Circle 네이티브 버전, USDT는 설정된 브리지 버전이며 USDbC는 제외됩니다. L1-finalized 안전 높이로 스캔합니다. 카운트다운 종료 전에 송금하면 확인은 나중에 도착할 수 있으며 고정 시간을 보장하지 않습니다. WooCommerce 설치 버전과 지원 네트워크 및 통화를 확인하세요.

서명된 요청 및 응답 예시

25.00은 형식 예시입니다. 실제 주문 금액을 사용하고 자산의 최소 금액을 충족하세요. 주소, 주문, 해시는 가상입니다. 복사한 cURL / Java는 요청을 전송하므로 실행 전에 본인의 키를 설정하세요.

# 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"

확인 및 콜백 처리

감지와 확인은 다릅니다. 상태와 검증된 콜백으로 판단하세요. PAID는 확인 대기 중입니다. CONFIRMED / COMPLETED는 수동 수락 결과일 수도 있으므로 paidAmount, shortfallAmount, settlementType을 확인하세요. COMPLETED는 상품 제공을 증명하지 않습니다.

연동 관련 질문