브랜드페이 SDK 연동 샘플 프로젝트(Node.js)

브랜드페이 JavaScript SDK를 이용해 자체 간편결제를 구축할 수 있는 Node.js 샘플 프로젝트입니다.

샘플 프로젝트를 사용한 브랜드페이 연동 방법은 브랜드페이 UI 연동하기에서 확인하세요.

준비하기

샘플 프로젝트를 사용하려면 Node.js가 필요합니다. 먼저 내 컴퓨터의 Node.js 버전을 확인하세요.

$ node -v
$ v16.15.1

Node.js 홈페이지에서 환경에 맞는 인스톨러를 다운로드 하거나 nvm(Node Version Manager)을 사용해서 설치하세요.

nvm으로 설치하기

nvm 최신 버전을 확인한 뒤 아래 커맨드의 {VERSION}에 추가해서 nvm을 설치합니다. (참고)

$ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/{VERSION}/install.sh | bash

nvm이 설치되었다면 아래 커맨드로 Node.js를 설치할 수 있습니다.

$ nvm install {NODE_VERSION}

시작하기

먼저 이 레포지토리를 클론합니다.

$ git clone https://github.com/tosspayments/brandpay-quickstart # 샘플 프로젝트 클론
$ cd brandpay-quickstart

의존성 패키지를 다운로드하고 서버를 실행합니다.

$ npm install   # 의존성 패키지 다운로드
$ node index.js # 서버 실행

브라우저에서 http://localhost:3000/checkout 페이지로 접속합니다.

샘플 프로젝트가 성공적으로 실행되면 아래와 같은 화면을 확인할 수 있습니다.

인증

클라이언트 코드의 clientKey, 서버 코드의 SECRET_KEY를 내 상점의 테스트용 API 키로 변경하세요. 테스트용 API 키는 개발 정보 페이지에서 확인할 수 있습니다.

API 키에 대한 더 자세한 내용은 API 사용하기 페이지를 참고하세요.