토큰 발급 (로그인)

특정 고객을 위젯에 로그인된 상태로 연결하고 싶을 때 사용합니다.
고객 식별을 위해 발급받은 고객 전용 토큰을 위젯에 전달하면, 해당 고객으로 자동 로그인된 상태에서 위젯이 실행됩니다.

POST

https://api.bootapi.com/v1/users/login/token

사용 시나리오

1
서버에서 고객 전용 로그인 토큰을 발급받습니다.
2
프론트엔드에서 위젯 렌더링 시, 토큰을 함께 전달합니다.
3
해당 고객으로 자동 로그인된 상태에서 위젯이 실행됩니다.

SDK 설치

Server

서버에서 API를 호출하기 위해 Backend SDK를 설치합니다.

SDK 설치 및 설정 방법은 토큰 발급 가이드를 참고하세요.

토큰 발급

Server

user_id로 고객 전용 로그인 토큰을 발급받습니다.

요청 파라미터

user_idstring필수고객 고유 번호
corporate_typestring고객 유형 (individual: 개인, corporate: 기업), 기본값: individual
membership_typestring멤버십 유형 (guest: 게스트, member: 회원), 기본값: member

응답 처리

Server

응답에서 token 값을 프론트엔드로 전달합니다.

응답 필드

tokenstring고객 전용 로그인 토큰 (위젯에서 사용)

위젯 렌더링

Client

위젯 렌더링 시 서버에서 발급받은 토큰으로 로그인합니다.

window.BootpayCommerce.sendEvent('updateUserSession', token) 를 호출하면 특정 고객으로 로그인됩니다.

에러 코드

USER_NO_LOGIN_ID

로그인 아이디가 없습니다.

로그인 아이디가 등록된 고객인지 확인하세요.

API_NOT_PERMIT

API 호출 권한이 없습니다.

API 권한 설정을 확인하세요.

ACCESS_TOKEN_INVALID

유효하지 않은 Access Token입니다.

Access Token을 다시 발급받으세요.

언어

Node.js SDK 설치

1. npm으로 설치

npm install --save @bootpay/backend-js

2. Import

ES6 Module (권장)

import { BootpayCommerce } from '@bootpay/backend-js'

CommonJS

const { BootpayCommerce } = require('@bootpay/backend-js')

3. 초기화

const commerce = new BootpayCommerce({
    client_key: 'YOUR_CLIENT_KEY',
    secret_key: 'YOUR_SECRET_KEY',
    mode: 'development' // 'production' | 'development' | 'stage'
})

// 토큰 발급
await commerce.getAccessToken()

참고: client_key와 secret_key는 부트페이 관리자에서 확인할 수 있습니다.