서버 토큰 발급받기

가맹점 ↔ 부트페이 서버 간 통신을 위해 서버 토큰(AccessToken)을 먼저 발급받아야 합니다.
발급받은 토큰은 HTTP 헤더의 Authorization에 넣어 전송합니다.

Access Token은 발급 후 30분간 유효합니다. 0~25분 내 재요청 시 동일 토큰 반환, 25분 이후 재요청 시 새 토큰 발급됩니다.

Application ID와 Private Key 준비

Admin

부트페이 관리자 결제설정 > 프로젝트 설정에서 발급받습니다.

상세 정보

Application ID공개키 (외부 노출 가능)
Private Key비밀키 (외부 노출 금지)

Private Key는 백엔드 서버 내 안전한 곳에 저장하세요.

SDK 설치 및 토큰 요청

Server

서버 SDK를 설치하고 토큰을 발급받습니다.

상세 정보

지원 언어Node.js, Python, PHP, Java, Ruby, Go, .NET
발급 방식Application ID + Private Key로 요청

API 요청 시 토큰 사용

Server

발급받은 토큰을 Authorization 헤더에 넣어 전송합니다.

상세 정보

유효시간발급된 토큰은 30분간 유효
재요청0~25분 내 재요청 시 동일 토큰 반환

파라미터

요청 파라미터

application_id필수string
REST API Application ID는 공개키의 역할을 하며, 백엔드에서 요청을 할 때 가맹점 정보를 구분하는 데 사용됩니다. 프로젝트별로 발급되는 고유한 값입니다. 부트페이 관리자 페이지에서 확인할 수 있습니다.
private_key외부에 노출되면 안되는 중요한 개인키필수string
Private Key는 만약 외부에 노출되었다면, 재발급을 받아야 합니다. 이 키는 백엔드 서버 내에서 접근할 수 없는 안전한 파일 형태로 저장되어 있어야 합니다. 프로젝트별로 발급되는 고유한 값입니다. 부트페이 관리자 페이지에서 확인할 수 있습니다.

응답 결과

expire_innumber
토큰의 만료 시간 (초)
access_tokenstring
발급 받은 토큰 값

토큰 사용하기

모든 REST API 사용 시 토큰을 먼저 발급받아야 합니다. API 요청 시 HTTP Header Authorization에 발급받은 access_token을 입력해서 보내야 합니다.

백엔드

토큰 발급 요청

import { Bootpay } from '@bootpay/backend-js' Bootpay.setConfiguration({    application_id: '[ REST API용 Application ID ]',    private_key: '[ Private KEy ]'}) try {    const response = await Bootpay.getAccessToken()    console.log(response)} catch (e) {    // 발급 실패시 오류    console.log(e)}