JavaScript 클라이언트 연동

타입을 제공하며 런타임 의존성이 없습니다. Node나 브라우저에서 API를 호출하고 Node에서 콜백을 검증합니다.

API 빠른 시작 보기

연동 도구 받기

요구 사항

설치와 설정

  1. 애플리케이션에 @suawave/gateway-client를 설치하세요. 런타임 의존성 없이 ESM, CommonJS, 타입 선언을 제공합니다.
  2. baseUrl로 GatewayClient를 생성하고 주문마다 티커, 정산 주소, 고유 콜백 URL로 publicCreate를 호출하세요.
  3. 필요에 따라 publicQrCode, publicLogs, publicInfo, publicEstimate, 환산 메서드를 사용해 결제 흐름을 구성하세요.
  4. Node 서버에서 @suawave/gateway-client/verify의 verifyCallbackSignature를 import하세요. publicCallbackKey를 가져와 캐시하고, 콜백을 반영하기 전에 정확한 GET URL 전체 또는 원본 POST 본문을 검증하세요.

구매자에게 표시되는 화면

애플리케이션에서 반환된 입금 주소, 토큰 금액, QR 코드를 표시합니다. 클라이언트가 쇼핑몰 결제 수단을 추가하거나 주문을 자동 업데이트하지는 않습니다. 결제 화면과 콜백 핸들러는 직접 구현해야 합니다.

결제 처리 방식

콜백 전달 · 수수료와 최소 금액

USDT 결제 네트워크와 수수료 · 결제 연동 가이드