키 생성·조회

프로젝트의 서버 연동 키(Client Key / Secret Key)를 조회하고 새로 발급한다. 결제(PG) 키와 커머스 키를 target 으로 구분한다.

핵심 요약

• 조회는 GET, 발급은 POST 다. 모두 app_id 로 프로젝트를 지정한다.
• target: pg 키는 셀러 프로젝트로 결제 REST API(Basic Auth)를 호출할 때 쓴다. target: commerce 키는 커머스 API 를 호출할 때 쓴다.
• 목록의 secret_key 는 앞 5자 + ***** 로 마스킹된다. secret_key 가 평문으로 나오는 응답은 발급 응답뿐이다.
• 발급 응답은 다시 볼 수 없다. 받은 즉시 셀러 레코드에 안전하게 저장한다.
• target: commerce 는 커머스 프로젝트가 있어야 한다. 없으면 먼저 커머스 연동 재시도 를 부른다.

API 정보

요청 파라미터

조회 (GET /v2/reseller/seller/app/key-chain/:app_id)

발급 (POST /v2/reseller/seller/app/key-chain)

코드 예제

import fetch from 'node-fetch'

const RESELLER_AUTH = 'Basic ' + Buffer
  .from(`${process.env.BOOTPAY_RESELLER_CLIENT_KEY}:${process.env.BOOTPAY_RESELLER_SECRET_KEY}`)
  .toString('base64')

const appId = '65a1c0ab8f1b5b00367a0002'

// 조회
const list = await fetch(`https://api.bootpay.co.kr/v2/reseller/seller/app/key-chain/${appId}`, {
    method: 'GET',
    headers: { 'Authorization': RESELLER_AUTH }
})
console.log(await list.json())

// 발급
const res = await fetch('https://api.bootpay.co.kr/v2/reseller/seller/app/key-chain', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'Authorization': RESELLER_AUTH
    },
    body: JSON.stringify({
        app_id: appId,
        target: 'pg',
        name:   '주문 서버',
        is_supervisor: false,
        api_scopes: ['example_scope_id'],
        expires_at: '2027-10-20T00:00:00+09:00'
    })
})
const data = await res.json()
// data.secret_key 는 이 응답에서만 평문이다. 즉시 저장한다
console.log(data)javascript

import base64, os, requests

auth = 'Basic ' + base64.b64encode(
    f"{os.environ['BOOTPAY_RESELLER_CLIENT_KEY']}:{os.environ['BOOTPAY_RESELLER_SECRET_KEY']}".encode()
).decode()

app_id = '65a1c0ab8f1b5b00367a0002'

# 조회
res = requests.get(
    f'https://api.bootpay.co.kr/v2/reseller/seller/app/key-chain/{app_id}',
    headers={'Authorization': auth}
)
print(res.json())

# 발급
res = requests.post(
    'https://api.bootpay.co.kr/v2/reseller/seller/app/key-chain',
    json={
        'app_id': app_id,
        'target': 'pg',
        'name':   '주문 서버',
        'is_supervisor': False,
        'api_scopes': ['example_scope_id'],
        'expires_at': '2027-10-20T00:00:00+09:00'
    },
    headers={'Authorization': auth}
)
# secret_key 는 이 응답에서만 평문이다. 즉시 저장한다
print(res.json())python

RESELLER_AUTH=$(printf '%s' "$BOOTPAY_RESELLER_CLIENT_KEY:$BOOTPAY_RESELLER_SECRET_KEY" | base64)
APP_ID='65a1c0ab8f1b5b00367a0002'

# 조회
curl -X GET "https://api.bootpay.co.kr/v2/reseller/seller/app/key-chain/$APP_ID" \
  -H "Authorization: Basic $RESELLER_AUTH"

# 발급
curl -X POST 'https://api.bootpay.co.kr/v2/reseller/seller/app/key-chain' \
  -H "Authorization: Basic $RESELLER_AUTH" \
  -H 'Content-Type: application/json' \
  -d '{
    "app_id": "65a1c0ab8f1b5b00367a0002",
    "target": "pg",
    "name":   "주문 서버",
    "is_supervisor": false,
    "api_scopes": ["example_scope_id"],
    "expires_at": "2027-10-20T00:00:00+09:00"
  }'bash

응답

조회 응답

secret_key 는 마스킹되어 온다. 커머스 프로젝트가 없으면 commerce 는 null 이다.

{
  "pg": [
      {
        "app_key_chain_id": "65a1c0ab8f1b5b00367a0020",
        "name":             "서버 연동용",
        "client_key":       "65a1c0ab8f1b5b00367a0021",
        "secret_key":       "Ab3dE*****",
        "is_supervisor":    true,
        "expires_at":       null,
        "api_scopes":       [],
        "created_at":       "2026-10-20T10:00:00+09:00",
        "server_at":        "2026-10-20T10:00:00+09:00",
        "is_copiable":      false,
        "status":           1
      }
  ],
  "commerce": [
      {
        "project_key_chain_id": "65a1c0ab8f1b5b00367a0030",
        "name":             "서버 연동용",
        "client_key":       "65a1c0ab8f1b5b00367a0031",
        "secret_key":       "Ab3dE*****",
        "is_supervisor":    true,
        "expires_at":       null,
        "api_scopes":       [],
        "created_at":       "2026-10-20T10:00:00+09:00",
        "server_at":        "2026-10-20T10:00:00+09:00",
        "is_copiable":      false,
        "status":           1
      }
  ]
}json

발급 응답

발급된 키체인 하나가 온다. secret_key 가 평문이다.

{
  "app_key_chain_id": "65a1c0ab8f1b5b00367a0020",
  "name":             "주문 서버",
  "client_key":       "65a1c0ab8f1b5b00367a0021",
  "secret_key":       "example_secret_key_plaintext",
  "is_supervisor":    false,
  "expires_at":       "2027-10-20T00:00:00+09:00",
  "api_scopes":       ["example_scope_id"],
  "created_at":       "2026-10-20T10:00:00+09:00",
  "server_at":        "2026-10-20T10:00:00+09:00",
  "is_copiable":      true,
  "status":           1
}json

응답 파라미터

에러 코드

다음 단계

• 커머스 프로젝트를 먼저 연결하려면 → 커머스 연동 재시도
• 프로젝트의 연동키 전체를 보려면 → 프로젝트 조회