프로젝트

하위 가맹점에 프로젝트를 더 만들고, 목록과 상세를 읽고, 담당자를 초대합니다. 커머스 연동이 실패했으면 여기서 다시 시도합니다.

인증·권한 오류는 각 표에 없어도 공통 오류 가 날 수 있습니다.

1프로젝트 생성

이미 만들어진 셀러 안에 새 프로젝트(=app)를 추가합니다. 본 서비스와 테스트 환경을 분리하거나, 한 셀러가 운영하는 여러 브랜드를 따로 정산·집계하려고 할 때 사용합니다.

동작 규칙

• 셀러 생성 시 자동으로 만들어지는 기본 프로젝트 외에 추가가 필요할 때만 호출합니다. 신규 셀러용 첫 프로젝트는 가맹점 생성 한 번으로 만들어집니다.
• provider_id 가 리셀러 본인 하위 셀러가 아니면 PROVIDER_NOT_FOUND 가 떨어집니다.
• 응답에는 프로젝트 기본 정보 7 개 필드(app_id, provider_id, app_name, real, desc, unit, status)와 결제 연동키(application_keys·private_key), 결제수단 목록(payment_apps), 커머스 연동 결과(commerce)가 함께 담깁니다.
• resources 를 함께 보내면 가맹점 생성 처럼 PG 결제수단을 같이 붙입니다. 프로젝트를 만들기 전에 PG·결제수단·필수 키를 먼저 검사하므로, 검사에 걸리면 프로젝트도 만들어지지 않습니다. 나중에 붙이거나 바꾸려면 PG 리소스 갱신 을 사용합니다.
• provider_id 만 있으면 됩니다. 안 보낸 값은 이름 기본프로젝트 · 통화(unit) KRW · 상품 종류(real) 비실물 · 시간대(timezone) Asia/Seoul 로 만듭니다.

API 정보

1-1. 요청 파라미터

1-2. 코드 예제

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 res = await fetch('https://api.bootpay.co.kr/v2/reseller/seller/app', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'Authorization': RESELLER_AUTH
    },
    body: JSON.stringify({
        provider_id: '65a1c0aa8f1b5b00367a0001',
        name:        '한입가게 — 정기구독',
        desc:        '월 정기구독 전용 프로젝트',
        unit:        'KRW',
        real:        '비실물',
        timezone:    'Asia/Seoul'
    })
})
const data = await res.json()
// data.app_id 저장
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()

payload = {
    'provider_id': '65a1c0aa8f1b5b00367a0001',
    'name':        '한입가게 — 정기구독',
    'desc':        '월 정기구독 전용 프로젝트',
    'unit':        'KRW',
    'real':        '비실물',
    'timezone':    'Asia/Seoul'
}
res = requests.post(
    'https://api.bootpay.co.kr/v2/reseller/seller/app',
    json=payload,
    headers={'Authorization': auth}
)
print(res.json())python

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

curl -X POST 'https://api.bootpay.co.kr/v2/reseller/seller/app' \
  -H "Authorization: Basic $RESELLER_AUTH" \
  -H 'Content-Type: application/json' \
  -d '{
    "provider_id": "65a1c0aa8f1b5b00367a0001",
    "name":        "한입가게 — 정기구독",
    "desc":        "월 정기구독 전용 프로젝트",
    "unit":        "KRW",
    "real":        "비실물",
    "timezone":    "Asia/Seoul"
  }'bash

1-3. 응답

{
  "app_id":      "65a1c0ab8f1b5b00367a0010",
  "provider_id": "65a1c0aa8f1b5b00367a0001",
  "app_name":    "한입가게 — 정기구독",
  "real":        { "name": "비실물", "value": 0, "desc": "" },
  "desc":        "월 정기구독 전용 프로젝트",
  "unit":        "KRW",
  "status":      20,
  "application_keys": [
    { "type": 1, "name": "WEB",     "key": "65a1c0ab8f1b5b00367a0011" },
    { "type": 2, "name": "Android", "key": "65a1c0ab8f1b5b00367a0012" },
    { "type": 3, "name": "iOS",     "key": "65a1c0ab8f1b5b00367a0013" },
    { "type": 4, "name": "REST",    "key": "65a1c0ab8f1b5b00367a0014" }
  ],
  "private_key": "kQ3f8vB2pN7sXq1wE5rT9yU0iO4aS6dF8gH2jK5lZ0c=",
  "payment_apps": [
    {
      "payment_resource_id": "65a1c0ab8f1b5b00367a0018",
      "pg_id":               "6098a1b2c3d4e5f600000101",
      "pg_name":             "나이스페이먼츠",
      "pg_alias":            "nicepay",
      "method_id":           "6098a1b2c3d4e5f600000201",
      "method_name":         "카드",
      "method_alias":        "card",
      "resource_mode":       null,
      "sandbox_mode":        true,
      "easypay":             false,
      "updated_at":          "2026-10-27T10:00:00+09:00",
      "status":              1,
      "resource":            { "mid": "nicep*****", "mkey": "EYzu8*****" },
      "cert_expire_at":      null
    }
  ],
  "commerce": {
    "status":     "created",
    "seller_id":  "65a1c0ab8f1b5b00367a0016",
    "project_id": "65a1c0ab8f1b5b00367a0017",
    "client_key": "example_commerce_client_key",
    "core_app_id": "65a1c0ab8f1b5b00367a0002",
    "key_chain": {
      "project_key_chain_id": "65a1c0ab8f1b5b00367a0020",
      "name":                 "reseller-default",
      "client_key":           "example_commerce_server_client_key",
      "secret_key":           "example_commerce_server_secret_key",
      "is_supervisor":        true,
      "expires_at":           "2099-12-31T23:59:59+09:00"
    }
  }
}json

응답 파라미터

1-4. 에러 코드

2프로젝트 목록

리셀러 본인 하위 셀러가 가진 프로젝트(app) 를 나열합니다. 가맹점 상세 화면에서 프로젝트 탭을 그릴 때 사용합니다.

동작 규칙

• provider_id 가 필수입니다. 본인 하위 셀러가 아니면 PROVIDER_NOT_FOUND 가 떨어집니다.
• 목록에는 결제 연동키와 커머스 정보가 없습니다. 키와 commerce 는 프로젝트 조회 를 사용합니다.
• count 는 페이지와 무관한 전체 프로젝트 수입니다.

API 정보

2-1. 요청 파라미터

2-2. 코드 예제

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 providerId = '65a1c0aa8f1b5b00367a0001'
const res = await fetch(`https://api.bootpay.co.kr/v2/reseller/seller/app?provider_id=${providerId}`, {
    method: 'GET',
    headers: {
        'Authorization': RESELLER_AUTH
    }
})
const data = await res.json()
console.log(data.count, data.list)javascript

import base64, os, requests

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

provider_id = '65a1c0aa8f1b5b00367a0001'
res = requests.get(
    'https://api.bootpay.co.kr/v2/reseller/seller/app',
    params={'provider_id': provider_id},
    headers={'Authorization': auth}
)
print(res.json())python

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

curl -X GET "https://api.bootpay.co.kr/v2/reseller/seller/app?provider_id=$PROVIDER_ID" \
  -H "Authorization: Basic $RESELLER_AUTH"bash

2-3. 응답

{
  "list": [
    {
      "app_id":      "65a1c0ab8f1b5b00367a0002",
      "provider_id": "65a1c0aa8f1b5b00367a0001",
      "app_name":    "한입가게",
      "real":        { "name": "실물", "value": 1, "desc": "" },
      "desc":        "",
      "unit":        "KRW",
      "status":      20
    },
    {
      "app_id":      "65a1c0ab8f1b5b00367a0010",
      "provider_id": "65a1c0aa8f1b5b00367a0001",
      "app_name":    "한입가게 — 정기구독",
      "real":        { "name": "비실물", "value": 0, "desc": "" },
      "desc":        "",
      "unit":        "KRW",
      "status":      20
    }
  ],
  "count": 2
}json

응답 파라미터

2-4. 에러 코드

3프로젝트 조회

app_id 로 프로젝트 한 건을 조회합니다. 프로젝트 기본정보에 결제 연동키와 커머스 프로젝트 정보가 함께 담깁니다.

동작 규칙

• 본인 하위 셀러의 프로젝트가 아니면 APP_NOT_PERMIT, 없는 프로젝트면 APP_NOT_FOUND 가 떨어집니다.
• 응답에는 application_keys, commerce 가 포함됩니다. private_key 는 가맹점 생성·프로젝트 생성 응답에서만 내려오고 조회에서는 다시 보여주지 않습니다.
• commerce 는 항상 status 가 있는 객체입니다 — exists 연결됨, none 커머스 프로젝트 없음(예전에는 null), failed 조회 실패.
• payment_setting_lock 은 결제 설정 잠금 상태입니다 — 가맹점이 켠 잠금(seller_locked)과 리셀러가 켠 잠금(reseller_locked). 리셀러 잠금은 결제 설정 잠금 으로 바꿉니다.
• 서버용 secret 은 응답에 없습니다. 키 생성·조회 에서 발급합니다.

API 정보

3-1. 요청 파라미터

3-2. 코드 예제

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 res = await fetch(`https://api.bootpay.co.kr/v2/reseller/seller/app/${appId}`, {
    method: 'GET',
    headers: {
        'Authorization': RESELLER_AUTH
    }
})
const data = await res.json()
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/{app_id}',
    headers={'Authorization': auth}
)
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/$APP_ID" \
  -H "Authorization: Basic $RESELLER_AUTH"bash

3-3. 응답

{
  "app_id":      "65a1c0ab8f1b5b00367a0002",
  "provider_id": "65a1c0aa8f1b5b00367a0001",
  "app_name":    "한입가게",
  "real":        { "name": "실물", "value": 1, "desc": "" },
  "desc":        "",
  "unit":        "KRW",
  "status":      20,
  "application_keys": [
    { "type": 1, "name": "WEB",     "key": "65a1c0ab8f1b5b00367a0011" },
    { "type": 2, "name": "Android", "key": "65a1c0ab8f1b5b00367a0012" },
    { "type": 3, "name": "iOS",     "key": "65a1c0ab8f1b5b00367a0013" },
    { "type": 4, "name": "REST",    "key": "65a1c0ab8f1b5b00367a0014" }
  ],
  "commerce": {
    "status":      "exists",
    "project_id":  "65a1c0ab8f1b5b00367a0006",
    "core_app_id": "65a1c0ab8f1b5b00367a0008",
    "seller_id":   "65a1c0ab8f1b5b00367a0005",
    "name":        "한입가게",
    "seller_name": "한입가게",
    "client_key":  "example_commerce_client_key"
  },
  "payment_setting_lock": {
    "seller_locked":       false,
    "seller_changed_at":   null,
    "reseller_locked":     false,
    "reseller_changed_at": null
  }
}json

응답 파라미터

3-4. 에러 코드

4프로젝트 초대

리셀러가 하위 가맹점(셀러)의 프로젝트에 담당자를 초대합니다. app_id 하나로 그 프로젝트의 권한(level)과 그 프로젝트가 속한 가맹점의 권한(provider_level)을 함께 정합니다. 메일이 발송되고, 받는 사람이 메일 안의 링크로 초대를 수락해야 권한이 생깁니다.

동작 규칙

• app_id·email 에 프로젝트 권한 level, 가맹점 권한 provider_level 을 함께 보냅니다. 두 값 모두 안 보내면 관리자(admin)​​입니다.
• 가맹점 권한이 사용자(user)·관리자(admin)이면 그 가맹점의 모든 프로젝트에 관리자 권한​​이 생깁니다(부트페이 가맹점 권한 규칙). 이때 level 은 쓰이지 않습니다.
• 이 프로젝트에만 level 권한을 주려면 provider_level: "none" 을 함께 보냅니다(예: 조회만 하는 담당자 = level: "member" + provider_level: "none").
• 호출 시점에 권한이 바로 붙지는 않습니다. 수락 대기(READY) 초대가 만들어지고 메일이 나갑니다. 받는 사람이 링크로 수락해야 권한이 생깁니다.
• 초대 링크는 만든 때부터 24시간 뒤 만료됩니다.
• 응답으로 만든 초대(invite_id·정해진 두 권한·만료 시각)를 돌려줍니다.

API 정보

4-1. 요청 파라미터

level — 프로젝트 권한

provider_level — 가맹점 권한

두 값을 함께 보면

4-2. 코드 예제

가맹점 관리자로 초대 (기본값)

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 res = await fetch('https://api.bootpay.co.kr/v2/reseller/invite', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'Authorization': RESELLER_AUTH
    },
    body: JSON.stringify({
        app_id:         '65a1c0ab8f1b5b00367a0010',
        email:          'owner@hanip.shop',
        level:          'admin', // 안 보내도 admin
        provider_level: 'admin'  // 안 보내도 admin
    })
})
console.log(await res.json())javascript

import base64, os, requests

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

res = requests.post(
    'https://api.bootpay.co.kr/v2/reseller/invite',
    json={'app_id': '65a1c0ab8f1b5b00367a0010', 'email': 'owner@hanip.shop', 'level': 'admin', 'provider_level': 'admin'},
    headers={'Authorization': auth}
)
print(res.json())python

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

curl -X POST 'https://api.bootpay.co.kr/v2/reseller/invite' \
  -H "Authorization: Basic $RESELLER_AUTH" \
  -H 'Content-Type: application/json' \
  -d '{
    "app_id":         "65a1c0ab8f1b5b00367a0010",
    "email":          "owner@hanip.shop",
    "level":          "admin",
    "provider_level": "admin"
  }'bash

이 프로젝트만 관리하게 초대

body: JSON.stringify({
    app_id:         '65a1c0ab8f1b5b00367a0010',
    email:          'manager@hanip.shop',
    level:          'admin',
    provider_level: 'none'   // 가맹점의 다른 프로젝트·정보는 보지 못한다
})javascript

조회만 하는 CS 담당자

body: JSON.stringify({
    app_id:         '65a1c0ab8f1b5b00367a0010',
    email:          'cs@hanip.shop',
    level:          'member',
    provider_level: 'none'    // 꼭 none — 안 보내면 admin 이라 모든 프로젝트 관리자가 된다
})javascript

4-3. 응답

{
  "invite_id": "6b2a1c0ab8f1b5b00367a0f1",
  "app_id": "65a1c0ab8f1b5b00367a0010",
  "provider_id": "65a1c0aa8f1b5b00367a0001",
  "email": "owner@hanip.shop",
  "level": 10,
  "level_name": "관리자",
  "provider_level": 10,
  "provider_level_name": "관리자",
  "status": "ready",
  "member_exists": false,
  "expired_at": "2026-11-06T11:20:00+09:00"
}json

응답 파라미터

4-4. 동작 규칙

4-5. 에러 코드

5커머스 연동 재시도

프로젝트에 부트페이 커머스 프로젝트를 생성해 연결합니다. 생성 응답에서 커머스 생성이 실패했을 때, 또는 커머스 연동이 없던 시기에 만든 프로젝트에 커머스를 붙일 때 사용합니다.

동작 규칙

• 생성 응답의 commerce.status 가 failed 였다면 생성 API 를 다시 부르지 말고 이 API 로 커머스만 다시 시도합니다.
• 여러 번 불러도 커머스 프로젝트가 중복으로 생기지 않습니다. 이미 있으면 exists 로 응답합니다.
• 이 호출에서 커머스 프로젝트를 처음 만들었으면(created) 리셀러 전용 커머스 서버 키 commerce.key_chain 이 함께 옵니다. exists 에는 오지 않습니다.
• 요청 본문은 없습니다. 경로의 app_id 만 보냅니다.
• 커머스 연동 이전에 만든 하위 가맹점의 프로젝트에도 같은 방법으로 커머스를 붙입니다.

API 정보

5-1. 요청 파라미터

5-2. 코드 예제

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 res = await fetch(`https://api.bootpay.co.kr/v2/reseller/seller/app/commerce/${appId}`, {
    method: 'PUT',
    headers: {
        'Authorization': RESELLER_AUTH
    }
})
const data = await res.json()
console.log(data.commerce.status)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.put(
    f'https://api.bootpay.co.kr/v2/reseller/seller/app/commerce/{app_id}',
    headers={'Authorization': auth}
)
print(res.json())python

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

curl -X PUT "https://api.bootpay.co.kr/v2/reseller/seller/app/commerce/$APP_ID" \
  -H "Authorization: Basic $RESELLER_AUTH"bash

5-3. 응답

{
  "app_id": "65a1c0ab8f1b5b00367a0002",
  "commerce": {
    "status":     "created",
    "seller_id":  "65a1c0ab8f1b5b00367a0005",
    "project_id": "65a1c0ab8f1b5b00367a0006",
    "client_key": "example_commerce_client_key",
    "core_app_id": "65a1c0ab8f1b5b00367a0002",
    "key_chain": {
      "project_key_chain_id": "65a1c0ab8f1b5b00367a0020",
      "name":                 "reseller-default",
      "client_key":           "example_commerce_server_client_key",
      "secret_key":           "example_commerce_server_secret_key",
      "is_supervisor":        true,
      "expires_at":           "2099-12-31T23:59:59+09:00"
    }
  }
}json

응답 파라미터

5-4. 에러 코드