비수탁형 정산
USDT / USDC는 가맹점 지갑으로 직접 전송되며 BoltUtil은 자금이나 개인 키를 보관하지 않습니다.
연동 가이드
주문을 완료하기 전에 USDT / USDC 결제를 확인하는 방법
고객이 지불했지만 주문이 아직 보류 중이라고 하면 블록체인 사실과 주문 사실을 비교할 수 있는 반복 가능한 방법이 필요합니다. 이 가이드에서는 판매자가 TRC20, ERC20, BEP20, Polygon 및 Solana에서 실행해야 하는 수표를 설명합니다.
절차
고객이 지불했지만 주문이 아직 보류 중이라고 하면 블록체인 사실과 주문 사실을 비교할 수 있는 반복 가능한 방법이 필요합니다. 이 가이드에서는 판매자가 TRC20, ERC20, BEP20, Polygon 및 Solana에서 실행해야 하는 수표를 설명합니다.
주문을 완료하기 전에 USDT / USDC 결제를 확인하는 방법
01 백엔드에서 금액, 네트워크, 외부 주문 ID를 지정해 결제 주문을 생성합니다.
02 구매자에게 결제 URL, 네트워크, 수신 주소, QR 코드와 정확한 USDT / USDC 금액을 표시합니다.
03 BoltUtil이 네트워크, 토큰 컨트랙트, 주소, 금액, 주문 만료와 컨펌 수를 확인합니다.
04 결제 확인 후 Webhook 서명을 검증하고 멱등하게 상품 또는 서비스를 제공합니다.
BoltUtil은 결제를 확인하고 서명된 콜백을 보냅니다. 판매자 서버가 서명과 주문 상태를 확인하고 중복을 제거한 후 상품 제공, 서비스 활성화 또는 잔액 반영을 처리합니다.
통합 참고사항
제작 전 중요한 것
6개 결제 네트워크
TRON, Ethereum, BNB Smart Chain, Polygon, Solana, Base를 지원합니다. TRON은 USDT / USDC만 가능하며 다른 USDT / USDC 경로도 자산 활성화와 유효한 수신 지갑이 필요합니다.
서명된 Webhook
HMAC 서명, 타임스탬프와 재전송 로그로 결제 후 처리를 안전하게 자동화합니다.
Network matches the order
Configured token contract / mint matches
Destination matches the order wallet
Full payable amount matches
Payment time and order window checked
Required confirmations reached
Transaction association and fulfillment checked연동 및 진단용 예시이며 요청은 전송되지 않습니다. 주문 데이터, 네트워크 설정 및 API 문서를 확인하세요.
API 문서 읽기다음으로 확인할 사항
원래 주문 번호와 거래 해시를 보관하세요. 전송 성공, 결제 확인, Webhook 전달은 각각 확인해야 합니다.
A = 1.000, B = 1.010, C = 1.020인 경우 1.020 결제는 다른 조건도 충족해야 C와 일치합니다. 1.030은 정확히 일치하는 주문이 없습니다.
설명용 예시입니다. 차액을 자동 수락하지 않으며 규칙, 주문 시간, 귀속을 확인해야 합니다. 무료 계정도 본인 검토 기록을 볼 수 있지만 연결 수락 또는 거절에는 유효한 Pro가 필요합니다.
- 금액 정확히 일치
- 전체 금액, 네트워크, 토큰, 지갑, 결제 시간을 비교하세요. 조건을 충족하는 정확한 일치가 차액 검토 후보보다 우선합니다.
- 부족 결제 또는 초과 결제
- 조건에 맞는 수동 이체는 검토 기록을 만들 수 있습니다. 차액 한도와 주문 귀속을 확인하고 가장 가까운 금액만으로 주문을 선택하지 마세요.
- 결제 확인 중
- PAID는 결제가 기록되었지만 확인이 진행 중이라는 뜻입니다. 네트워크 확인과 스캔 진행을 살피고 다시 결제하도록 요청하지 마세요.
- 결제는 확인됐지만 상점이 갱신되지 않음
- Webhook 전달, HTTP 응답, 원문 서명, 주문 저장을 확인하세요. 수신 측을 수정한 뒤 권한에 따라 재전송하고 한 번만 제공하세요.
- 네트워크 또는 토큰 불일치
- 실제 네트워크와 계약 또는 Mint를 확인하세요. 같은 기호나 주소 형식만으로 다른 경로의 이체가 이 주문의 결제가 되지는 않습니다.
주문은 서버에서 생성하세요
API 키를 브라우저에 노출하지 말고 checkout을 표시하기 전에 외부 주문 ID를 저장하세요.
네트워크를 명확히 표시하세요
주소와 함께 TRC20, ERC20, BEP20, Polygon 또는 Solana 네트워크를 분명히 안내하세요.
검증 후 이행하세요
return URL은 결제 증명이 아닙니다. 서명된 Webhook이나 서버 상태 조회를 사용하세요.
연동 가이드
판매자가 라이브를 시작하기 전에 묻는 질문
BoltUtil은 가맹점 자금을 보관하나요?
아니요. 자금은 가맹점 지갑으로 직접 이동하고 BoltUtil은 전송을 모니터링해 알립니다.
USDT / USDC 결제는 어떻게 매칭하나요?
네트워크, 토큰, 수신 주소, 정확한 금액, 주문 상태와 만료 시간을 확인합니다.
USDT와 USDC를 지원하는 네트워크는 무엇인가요?
TRON은 USDT만 지원합니다. Ethereum, BNB Smart Chain, Polygon, Solana, Base는 설정된 USDT / USDC를 지원합니다. 사용 가능 여부는 활성 채널과 판매자 지갑에 따릅니다.