Polygon 스테이블코인 결제 연동

메인넷 지원 토큰 식별 정보

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

메인넷 지원 토큰 식별 정보

네트워크	통화	컨트랙트 / Mint	토큰 소수 자릿수
POLYGON	USDT	0xc2132D05D31c914a87C6611C10748AEb04B58e8F	6
POLYGON	USDC	0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359	6

판매자 설정

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

네트워크 및 자산 유의 사항

• Polygon PoS 메인넷은 network=POLYGON을 사용하며 ERC20으로 대체하지 마세요. USDC는 네이티브 버전이고 USDC.e로 대체할 수 없습니다. 낮은 비용이 확인 요건을 없애지는 않습니다.

서명된 요청 및 응답 예시

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

연동 관련 질문