USDT 결제 연동 안내

메인넷 지원 토큰 식별 정보

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

메인넷 지원 토큰 식별 정보

네트워크	통화	컨트랙트 / Mint	토큰 소수 자릿수
TRC20	USDT	TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t복사	6
ERC20	USDT	0xdAC17F958D2ee523a2206206994597C13D831ec7복사	6
BEP20	USDT	0x55d398326f99059fF775485246999027B3197955복사	18
POLYGON	USDT	0xc2132D05D31c914a87C6611C10748AEb04B58e8F복사	6
SOLANA	USDT	Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB복사	6
BASE	USDT	0xfde4c96c8593536e31f229ea8f37b2ada2699bb2복사	6

판매자 설정

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

네트워크 및 자산 유의 사항

USDT는 6개 네트워크를 지원합니다. 설정된 BNB Smart Chain 토큰은 소수점 18자리, 나머지 5개는 6자리입니다. 이는 주문 금액 식별 정밀도와 다릅니다. Base는 설정된 브리지 USDT를 사용하며 BoltUtil은 네트워크 간 송금을 제공하지 않습니다. 주문의 네트워크와 명시된 토큰 버전을 선택하세요. 같은 기호나 지갑 주소라도 네트워크와 토큰을 서로 대체할 수 없습니다.

• TRC20은 TRON의 API 코드이며 USDT만 지원합니다. currency=USDC는 사용할 수 없습니다. USDT 토큰은 6자리지만 결제 금액은 API 반환값 그대로 사용하세요. 확인은 설정과 스캔 결과에 따르며 고정 초 단위 시간을 보장하지 않습니다.

서명된 요청 및 응답 예시

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":"TRC20","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는 상품 제공을 증명하지 않습니다.

연동 관련 질문