
JavaScript 클라이언트 연동
타입을 제공하며 런타임 의존성이 없습니다. Node나 브라우저에서 API를 호출하고 Node에서 콜백을 검증합니다.
API 빠른 시작 보기요구 사항
- Node 20 이상 또는 fetch를 지원하는 브라우저가 필요합니다. 콜백 서명 검증에는 Node가 필요하며 node:crypto를 사용합니다.
- 게이트웨이 기본 URL, 정산 지갑, 공개 콜백 URL이 필요합니다. 공개 호출에는 API 키가 필요하지 않습니다.
설치와 설정
- 애플리케이션에 @suawave/gateway-client를 설치하세요. 런타임 의존성 없이 ESM, CommonJS, 타입 선언을 제공합니다.
- baseUrl로 GatewayClient를 생성하고 주문마다 티커, 정산 주소, 고유 콜백 URL로 publicCreate를 호출하세요.
- 필요에 따라 publicQrCode, publicLogs, publicInfo, publicEstimate, 환산 메서드를 사용해 결제 흐름을 구성하세요.
- Node 서버에서 @suawave/gateway-client/verify의 verifyCallbackSignature를 import하세요. publicCallbackKey를 가져와 캐시하고, 콜백을 반영하기 전에 정확한 GET URL 전체 또는 원본 POST 본문을 검증하세요.
구매자에게 표시되는 화면
애플리케이션에서 반환된 입금 주소, 토큰 금액, QR 코드를 표시합니다. 클라이언트가 쇼핑몰 결제 수단을 추가하거나 주문을 자동 업데이트하지는 않습니다. 결제 화면과 콜백 핸들러는 직접 구현해야 합니다.
결제 처리 방식
- 금액은 십진수 문자열입니다. JavaScript number 대신 제공되는 최소 단위 헬퍼로 정수 연산을 수행하세요.
- 각 작업에 취소 신호를 전달할 수 있고 요청 제한 시간도 설정할 수 있습니다. 서명 헬퍼는 Node 전용 verify 진입점에 분리되어 있어 기본 클라이언트를 브라우저용으로 번들링할 수 있습니다.