빠른 연동 가이드

아래의 4단계를 따라 BoltUtil 암호화폐 결제 게이트웨이를 귀하의 비즈니스 로직에 원활하게 통합하세요.

Backend

/api/v1/orders/create 엔드포인트를 호출합니다. 우리 게이트웨이는 미리 설정된 귀하의 수령 주소를 특정 트랜잭션에 매핑합니다.

보안 팁: HTTP 헤더에 X-Bolt-Key와 서명이 포함되어 있는지 확인하세요.

Frontend

응답으로 받은 checkoutUrl을 사용하여 사용자를 결제 페이지로 리다이렉트하거나 QR 코드를 직접 렌더링하세요. 사용자는 개인 지갑에서 귀하의 전용 주소로 자금을 직접 송금하게 됩니다.

트론(TRC20) 및 주요 지갑과 완벽하게 호환되며, 네이티브 앱 호출(App-invocation)을 지원합니다.

Webhook

당사의 노드 클러스터가 블록체인 원장을 실시간으로 모니터링합니다. 트랜잭션 컨펌이 감지되면 시스템은 즉시 txHash를 포함한 결제 상세 정보를 귀하의 notifyUrl로 POST 요청을 통해 전송합니다.

네트워크 변동에 대비하여, 중복 알림을 안전하게 처리할 수 있도록 엔드포인트에 멱등성(Idempotency)을 구현하세요.

Backend

Webhook을 수신하면 당사의 서명 알고리즘을 사용하여 데이터 소스를 검증하세요. 콜백된 금액이 주문 정보와 일치하면 시스템 상태를 업데이트하고 사용자에게 서비스를 제공(이행)합니다.

제로 트러스트: HMAC 서명 검증과 금액 일치 확인 없이는 절대로 주문을 처리하지 마십시오.