NODE.JS SDK · MIT
패키지 하나로 JavaScript와 TypeScript를.
Node.js 백엔드에 Wholly Crypto 결제를 추가하세요. 타입을 내장하고 ES modules와 CommonJS를 지원해 별도 TypeScript 패키지가 필요 없어요.
npm으로 설치
Node.js 22+가 필요해요. 브라우저 코드가 아닌 서버에서 사용하세요.
npm install whollycrypto타입이 있는 요청으로 개발
- 청구서를 만들고 고객에게 결제 URL 반환
- 결제 상태, 스토어, 받는 자산 조회
- 백엔드에서 서명된 결제 알림 검증
- JavaScript와 TypeScript에서 같은 패키지 사용
키는 백엔드에 보관하세요.
내 설치의 API URL과 프로젝트로 제한한 API 인증 정보를 사용하세요. 스토어 → 기본에서 프로젝트·스토어 API ID를 복사하세요. API 키나 서명 비밀 키를 프런트엔드 번들에 절대 넣지 마세요.
JSON을 파싱하기 전에 서명 검증용 원본 요청 본문을 보관하세요. IPN은 스토어 IPN 비밀 키를, 웹훅은 각 엔드포인트 비밀 키를 사용해요. 주문 이행 전에 정산을 확인하세요.
운영자 설치 관리를 자동화하세요.
SDK 2.6.0에는 별도의 다음이 추가돼요: OperatorClient 는 Wholly Crypto 7.4.0+에서 직접 또는 초대로 판매자 가입, 사용자, 스토어, 로컬 크레딧, 서명된 수명 주기 웹훅을 지원해요.