하위 가맹점

리셀러 하위 가맹점(셀러)을 만들고 읽고 고칩니다. 만들 때 첫 프로젝트와 결제수단까지 한 번에 붙일 수 있습니다.

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

1가맹점 생성

리셀러 계정으로 하위 가맹점(셀러)을 만들고, 셀러의 기본 프로젝트와 첫 결제수단(PG·메서드) 까지 한 트랜잭션 안에서 같이 등록합니다.

동작 규칙

• 셀러를 식별할 외부 키 primary_key 가 필수입니다. 본사 DB 의 회원 ID 와 묶어두면 동일 리셀러 안에서 중복도 자동으로 막힙니다.
• 가맹점과 함께 프로젝트 하나를 만듭니다. project 로 이름·통화·상품 종류·시간대를 정하고, 안 보내면 기본프로젝트 · KRW · 비실물 · Asia/Seoul 로 만듭니다.
• resources 배열을 함께 보내면 그 프로젝트에 PG·결제수단까지 한 번에 붙습니다. 비워두면 빈 프로젝트만 만들어집니다.
• 응답으로 받은 apps[].application_keys 가 곧 셀러가 결제창(SDK) 에 쓸 키입니다. apps[].private_key 는 프로젝트 단위 백엔드 키입니다. 둘 다 안전한 자리에 저장합니다.
• 한 트랜잭션이라 중간에 어디가 실패하면 셀러·프로젝트 둘 다 만들어지지 않습니다. 같은 키로 다시 호출하면 됩니다.

API 정보

1-1. 요청 파라미터

project 객체 형식

프로젝트 생성 과 같은 값·기본값을 사용합니다.

resources 배열 형식

각 원소는 PG · 결제수단 · 발급키를 한 묶음으로 가집니다.

resource 안에 들어가는 키 이름은 PG 사가 정한 그대로입니다. 나이스페이먼츠 카드라면 mid, mkey(카드자동은 cancel_pwd 까지) 같은 식이고, KCP 라면 site_cd, site_key 같은 식입니다. 가맹점 발급 통보서에 있는 값을 그대로 넣으면 됩니다. 꼭 넣어야 하는 키는 PG·필수 연동 값 목록 에서 required: true 인 키입니다(부트페이 관리자 화면과 같은 기준) — 하나라도 비면 RESOURCE_KEY_BLANK 로 가맹점도 만들어지지 않습니다.

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', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'Authorization': RESELLER_AUTH
    },
    body: JSON.stringify({
        primary_key:  'host-member-1024',
        company_name: '한입가게',
        email:        'owner@hanip.shop',
        owner_name:   '김대표',
        manager_name: '박매니저',
        regist_no:    '1234567890',
        phone:        '01012345678',
        homepage:     'https://hanip.shop',
        zip:          '06236',
        address1:     '서울 강남구 테헤란로 123',
        address2:     '4층',
        send_email:   true,
        project:      { name: '한입가게', real: '실물' },   // 안 보내면 기본프로젝트·KRW·비실물·Asia/Seoul
        resources: [
            {
                pg:     'nicepay',
                method: '카드',
                resource: {
                    mid:          'nicepay00m',
                    mkey:         'EYzu8jGGMfqaDEp76gSckuvnaHHu+...='
                }
            }
        ]
    })
})
const data = await res.json()
// data.provider_id, data.apps[0].application_keys 저장
console.log(data)javascript

import base64
import os
import requests

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

payload = {
    'primary_key':  'host-member-1024',
    'company_name': '한입가게',
    'email':        'owner@hanip.shop',
    'owner_name':   '김대표',
    'manager_name': '박매니저',
    'regist_no':    '1234567890',
    'phone':        '01012345678',
    'homepage':     'https://hanip.shop',
    'zip':          '06236',
    'address1':     '서울 강남구 테헤란로 123',
    'address2':     '4층',
    'send_email':   True,
    'project':      {'name': '한입가게', 'real': '실물'},
    'resources': [
        {
            'pg':     'nicepay',
            'method': '카드',
            'resource': {
                'mid':          'nicepay00m',
                'mkey':         'EYzu8jGGMfqaDEp76gSckuvnaHHu+...='
            }
        }
    ]
}
res = requests.post(
    'https://api.bootpay.co.kr/v2/reseller/seller',
    json=payload,
    headers={'Authorization': auth}
)
print(res.json())python

<?php
$auth = 'Basic ' . base64_encode($_ENV['BOOTPAY_RESELLER_CLIENT_KEY'] . ':' . $_ENV['BOOTPAY_RESELLER_SECRET_KEY']);

$payload = [
    'primary_key'  => 'host-member-1024',
    'company_name' => '한입가게',
    'email'        => 'owner@hanip.shop',
    'owner_name'   => '김대표',
    'manager_name' => '박매니저',
    'regist_no'    => '1234567890',
    'phone'        => '01012345678',
    'homepage'     => 'https://hanip.shop',
    'zip'          => '06236',
    'address1'     => '서울 강남구 테헤란로 123',
    'address2'     => '4층',
    'send_email'   => true,
    'project'      => ['name' => '한입가게', 'real' => '실물'],
    'resources'    => [
        [
            'pg'       => 'nicepay',
            'method'   => '카드',
            'resource' => [
                'mid'          => 'nicepay00m',
                'mkey'         => 'EYzu8jGGMfqaDEp76gSckuvnaHHu+...='
            ]
        ]
    ]
];

$ch = curl_init('https://api.bootpay.co.kr/v2/reseller/seller');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => ['Content-Type: application/json', 'Authorization: ' . $auth],
    CURLOPT_POSTFIELDS     => json_encode($payload, JSON_UNESCAPED_UNICODE)
]);
$response = curl_exec($ch);
echo $response;php

require 'base64'
require 'json'
require 'net/http'

auth = 'Basic ' + Base64.strict_encode64(
  "#{ENV['BOOTPAY_RESELLER_CLIENT_KEY']}:#{ENV['BOOTPAY_RESELLER_SECRET_KEY']}"
)

uri = URI('https://api.bootpay.co.kr/v2/reseller/seller')
req = Net::HTTP::Post.new(uri, 'Content-Type' => 'application/json', 'Authorization' => auth)
req.body = {
  primary_key:  'host-member-1024',
  company_name: '한입가게',
  email:        'owner@hanip.shop',
  owner_name:   '김대표',
  manager_name: '박매니저',
  regist_no:    '1234567890',
  phone:        '01012345678',
  homepage:     'https://hanip.shop',
  zip:          '06236',
  address1:     '서울 강남구 테헤란로 123',
  address2:     '4층',
  send_email:   true,
  project:      { name: '한입가게', real: '실물' },
  resources: [
    { pg: 'nicepay', method: '카드',
      resource: { mid: 'nicepay00m', mkey: 'EYzu8jGGMfqaDEp76gSckuvnaHHu+...=' } }
  ]
}.to_json

res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(req) }
puts res.bodyruby

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

curl -X POST 'https://api.bootpay.co.kr/v2/reseller/seller' \
  -H "Authorization: Basic $RESELLER_AUTH" \
  -H 'Content-Type: application/json' \
  -d '{
    "primary_key":  "host-member-1024",
    "company_name": "한입가게",
    "email":        "owner@hanip.shop",
    "owner_name":   "김대표",
    "manager_name": "박매니저",
    "regist_no":    "1234567890",
    "phone":        "01012345678",
    "homepage":     "https://hanip.shop",
    "zip":          "06236",
    "address1":     "서울 강남구 테헤란로 123",
    "address2":     "4층",
    "send_email":   true,
    "project":      { "name": "한입가게", "real": "실물", "unit": "KRW", "timezone": "Asia/Seoul" },
    "resources": [
      { "pg": "nicepay", "method": "카드",
        "resource": { "mid": "nicepay00m", "mkey": "EYzu8jGGMfqaDEp76gSckuvnaHHu+...=" } }
    ]
  }'bash

1-3. 응답

생성된 셀러 정보와 함께 첫 프로젝트가 apps[] 안에 같이 담겨 옵니다.

{
  "provider_id":              "65a1c0aa8f1b5b00367a0001",
  "company_alias":            null,
  "email":                    "owner@hanip.shop",
  "company_name":             "한입가게",
  "owner_name":               "김대표",
  "manager_name":             "박매니저",
  "mail_order_sales_number":  null,
  "information_manager_name": null,
  "biz_tel":                  null,
  "biz_email":                null,
  "phone":                    "01012345678",
  "homepage":                 "https://hanip.shop",
  "lv":                       1,
  "regist_no":                "1234567890",
  "zip":                      "06236",
  "address1":                 "서울 강남구 테헤란로 123",
  "address2":                 "4층",
  "apps": [
    {
      "app_id":      "65a1c0ab8f1b5b00367a0002",
      "app_name":    "한입가게",
      "real":        { "name": "실물", "value": 1, "desc": "" },
      "unit":        "KRW",
      "application_keys": [
        { "type": 1, "name": "WEB",     "key": "65a1c0ab8f1b5b00367a0003" },
        { "type": 2, "name": "Android", "key": "65a1c0ab8f1b5b00367a0004" },
        { "type": 3, "name": "iOS",     "key": "65a1c0ab8f1b5b00367a0005" },
        { "type": 4, "name": "REST",    "key": "65a1c0ab8f1b5b00367a0006" }
      ],
      "private_key": "kQ3f8vB2pN7sXq1wE5rT9yU0iO4aS6dF8gH2jK5lZ0c=",
      "payment_apps": [
        {
          "payment_resource_id": "65a1c0ab8f1b5b00367a0007",
          "pg_id":               "6098a1b2c3d4e5f600000101",
          "pg_name":             "나이스페이먼츠",
          "pg_alias":            "nicepay",
          "method_id":           "6098a1b2c3d4e5f600000201",
          "method_name":         "카드",
          "method_alias":        "card",
          "resource_mode":       null,
          "sandbox_mode":        false,
          "easypay":             false,
          "updated_at":          "2024-01-12T18:04:11+09:00",
          "status":              1,
          "resource": {
            "mid":          "nicepay00m",
            "mkey":         "EYzu8jGGMfqaDEp76gSckuvnaHHu+..."
          }
        }
      ],
      "status": 20,
      "commerce": {
        "status":     "created",
        "seller_id":  "65a1c0ab8f1b5b00367a0008",
        "project_id": "65a1c0ab8f1b5b00367a0009",
        "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가맹점 목록

리셀러 본인의 하위에 속한 셀러를 최근 생성 순으로 나열합니다. 본사 콘솔의 가맹점 목록 화면을 그릴 때 사용합니다.

동작 규칙

• 목록은 최근 생성 순입니다. 리셀러 본인은 목록에 포함되지 않습니다.
• list 의 각 원소는 가맹점 조회 의 셀러 객체(프로젝트 목록 apps 포함)에 목록 전용 세 필드(pg_wait·commerce_status·monthly_amount)가 더해진 형태입니다.
• pg_wait 는 가장 최근 PG 가맹 신청서의 진행 상태입니다. 신청서가 없으면 null. 자세한 내용은 등록 상태 조회 로 봅니다.
• monthly_amount 는 이번 달 1일 0시부터 지금까지 결제 완료 금액에서 취소 금액을 뺀 값입니다. 하루 단위 통계로 모으므로 방금 난 결제는 늦게 반영될 수 있고, 통화를 나누지 않고 더합니다.
• commerce_status 는 부트페이 커머스 쪽 판매자 계정이 있으면 exists, 없으면 none입니다. 커머스 쪽을 잠시 읽지 못하면 그 페이지 전부 failed 이고 목록은 그대로 옵니다.
• count 는 페이지와 무관한 전체 하위 가맹점 수입니다.
• apps 에는 프로젝트 기본 정보만 옵니다. 연동키와 커머스 정보는 프로젝트 조회 로 봅니다.

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 res = await fetch('https://api.bootpay.co.kr/v2/reseller/seller?page=1&limit=20', {
    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()

res = requests.get(
    'https://api.bootpay.co.kr/v2/reseller/seller',
    params={'page': 1, 'limit': 20},
    headers={'Authorization': auth}
)
print(res.json())python

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

curl -X GET "https://api.bootpay.co.kr/v2/reseller/seller?page=1&limit=20" \
  -H "Authorization: Basic $RESELLER_AUTH"bash

2-3. 응답

{
  "list": [
    {
      "provider_id":              "65a1c0aa8f1b5b00367a0001",
      "company_alias":            null,
      "email":                    "owner@hanip.shop",
      "company_name":             "한입가게",
      "owner_name":               "김대표",
      "manager_name":             "박매니저",
      "mail_order_sales_number":  null,
      "information_manager_name": null,
      "biz_tel":                  null,
      "biz_email":                null,
      "phone":                    "01012345678",
      "homepage":                 "https://hanip.shop",
      "lv":                       1,
      "regist_no":                "1234567890",
      "zip":                      "06236",
      "address1":                 "서울 강남구 테헤란로 123",
      "address2":                 "4층",
      "seller_name":              "한입가게",
      "pg_wait": {
        "status": 1,
        "stage":  "doc_wait",
        "due_at": "2026-10-30T18:00:00+09:00"
      },
      "commerce_status": "exists",
      "monthly_amount":  1250000,
      "apps": [
        {
          "app_id":      "65a1c0ab8f1b5b00367a0010",
          "provider_id": "65a1c0aa8f1b5b00367a0001",
          "app_name":    "기본프로젝트",
          "real":        { "name": "비실물", "value": 0, "desc": "" },
          "desc":        null,
          "unit":        "KRW",
          "status":      20
        }
      ]
    }
  ],
  "count": 37
}json

응답 파라미터

2-4. 에러 코드

3가맹점 조회

리셀러 본인의 하위에 속한 셀러를 provider_id 로 단건 조회합니다. 본사 콘솔에서 셀러 상세 화면을 그릴 때, 또는 가입 직후 캐시 동기화 용도로 사용합니다.

동작 규칙

• 리셀러 본인의 하위에 묶이지 않은 provider_id 를 넣으면 PROVIDER_NOT_FOUND 가 떨어집니다. 다른 리셀러의 셀러를 들여다보는 건 막혀 있습니다.
• 리셀러가 아닌 계정으로 부르면 API_ONLY_RESELLER, 본사가 사용을 멈춘 리셀러면 RESELLER_SUSPENDED 로 막힙니다(목록·생성·수정과 같습니다).
• 응답은 가맹점 생성 의 셀러 필드와 동일한 형태에 seller_name 이 추가됩니다.
• 그 셀러의 프로젝트 목록(apps)이 함께 옵니다. 형식은 프로젝트 목록 과 같고 최신순입니다. 연동 키·결제수단·커머스 연결은 프로젝트 조회 로 봅니다.

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 providerId = '65a1c0aa8f1b5b00367a0001'
const res = await fetch(`https://api.bootpay.co.kr/v2/reseller/seller/${providerId}`, {
    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()

provider_id = '65a1c0aa8f1b5b00367a0001'
res = requests.get(
    f'https://api.bootpay.co.kr/v2/reseller/seller/{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/$PROVIDER_ID" \
  -H "Authorization: Basic $RESELLER_AUTH"bash

3-3. 응답

{
  "provider_id":              "65a1c0aa8f1b5b00367a0001",
  "company_alias":            null,
  "email":                    "owner@hanip.shop",
  "company_name":             "한입가게",
  "owner_name":               "김대표",
  "manager_name":             "박매니저",
  "mail_order_sales_number":  null,
  "information_manager_name": null,
  "biz_tel":                  null,
  "biz_email":                null,
  "phone":                    "01012345678",
  "homepage":                 "https://hanip.shop",
  "lv":                       1,
  "regist_no":                "1234567890",
  "zip":                      "06236",
  "address1":                 "서울 강남구 테헤란로 123",
  "address2":                 "4층",
  "seller_name":              "한입가게",
  "apps": [
    {
      "app_id":      "65a1c0ab8f1b5b00367a0010",
      "provider_id": "65a1c0aa8f1b5b00367a0001",
      "app_name":    "기본프로젝트",
      "real":        { "name": "비실물", "value": 0, "desc": "" },
      "desc":        null,
      "unit":        "KRW",
      "status":      20
    }
  ]
}json

응답 파라미터

3-4. 에러 코드

4가맹점 정보 수정

본인 하위 가맹점의 사업자 정보를 고칩니다. 보낸 키만 바뀌고 보내지 않은 키는 그대로입니다. 응답은 가맹점 조회 와 같은 셀러 객체이고, 프로젝트 목록 apps 만 없습니다.

동작 규칙

• 바꿀 수 있는 키는 아래 표에 있는 것뿐입니다. 표에 없는 키(primary_key·lv 등)는 보내도 무시됩니다.
• 아무 키도 보내지 않으면 PARAMS_INVALID 로 거부됩니다.
• regist_no·phone 은 가맹점 생성 과 같이 - 를 빼고 저장합니다.
• 값에 null 이나 빈 문자열을 보내면 그 값을 비웁니다. 단 company_name 은 비울 수 없고 email 은 이메일 형식이어야 합니다.
• 상호·사업자등록번호가 바뀌면 변경 이력이 부트페이 관리자 화면에 남습니다.
• 커머스 쪽 판매자 정보는 이 호출로 바뀌지 않습니다.
• 본인 하위가 아니거나 리셀러 자신이면 PROVIDER_NOT_FOUND입니다.

API 정보

PATCH 로 불러도 같습니다.

4-1. 요청 파라미터

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 providerId = '65a1c0aa8f1b5b00367a0001'

const res = await fetch(`https://api.bootpay.co.kr/v2/reseller/seller/${providerId}`, {
    method: 'PUT',
    headers: { 'Content-Type': 'application/json', 'Authorization': RESELLER_AUTH },
    body: JSON.stringify({ company_name: '한입가게 본점', phone: '010-1234-5678', address2: '5층' })
})
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()

provider_id = '65a1c0aa8f1b5b00367a0001'

res = requests.put(
    f'https://api.bootpay.co.kr/v2/reseller/seller/{provider_id}',
    json={'company_name': '한입가게 본점', 'phone': '010-1234-5678', 'address2': '5층'},
    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 PUT "https://api.bootpay.co.kr/v2/reseller/seller/$PROVIDER_ID" \
  -H "Authorization: Basic $RESELLER_AUTH" \
  -H 'Content-Type: application/json' \
  -d '{"company_name":"한입가게 본점","phone":"010-1234-5678","address2":"5층"}'bash

4-3. 응답

{
  "provider_id":              "65a1c0aa8f1b5b00367a0001",
  "company_alias":            null,
  "email":                    "owner@hanip.shop",
  "company_name":             "한입가게 본점",
  "owner_name":               "김대표",
  "manager_name":             "박매니저",
  "mail_order_sales_number":  null,
  "information_manager_name": null,
  "biz_tel":                  null,
  "biz_email":                null,
  "phone":                    "01012345678",
  "homepage":                 "https://hanip.shop",
  "lv":                       1,
  "regist_no":                "1234567890",
  "zip":                      "06236",
  "address1":                 "서울 강남구 테헤란로 123",
  "address2":                 "5층",
  "seller_name":              "한입가게"
}json

응답 필드는 가맹점 조회 와 같습니다.

4-4. 에러 코드

5테스트 데이터 삭제

리셀러 본인 하위에 만들어둔 테스트 셀러 한 곳을 삭제합니다. 셀러 자신, 셀러의 모든 프로젝트(app), 프로젝트에 발급된 SDK 연동키(AppKey), 프로젝트 멤버 권한(AppRole), 셀러 단위 멤버 권한(ProviderRole) 이 정리됩니다.

동작 규칙

• 리셀러 본인의 하위가 아닌 셀러는 삭제되지 않습니다. provider_id 가 다른 리셀러 소속이면 PROVIDER_NOT_FOUND 가 떨어집니다.
• 본인(리셀러 자기 자신) 의 provider_id 를 넣어도 거부됩니다. 리셀러 자체는 이 API 로 삭제할 수 없습니다.
• 한 번에 한 셀러만 삭제됩니다. 대량 정리는 반복 호출이 필요합니다.

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 providerId = '65a1c0aa8f1b5b00367a0001'

const BASE_URL = process.env.BOOTPAY_TEST_API_URL // 개발 환경 주소(운영 api.bootpay.co.kr 는 404)
const res = await fetch(`${BASE_URL}/v2/reseller/test/seller/${providerId}`, {
    method: 'DELETE',
    headers: { 'Authorization': RESELLER_AUTH }
})
console.log(res.status) // 200javascript

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'
base_url = os.environ['BOOTPAY_TEST_API_URL']  # 개발 환경 주소(운영 api.bootpay.co.kr 는 404)
res = requests.delete(
    f'{base_url}/v2/reseller/test/seller/{provider_id}',
    headers={'Authorization': auth}
)
print(res.status_code)python

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

# BOOTPAY_TEST_API_URL = 개발 환경 주소(운영 api.bootpay.co.kr 는 404)
curl -X DELETE "$BOOTPAY_TEST_API_URL/v2/reseller/test/seller/$PROVIDER_ID" \
  -H "Authorization: Basic $RESELLER_AUTH"bash

5-3. 삭제 범위

한 번의 호출로 아래가 정리됩니다.

5-4. 응답

성공 시 본문은 비어 있고, HTTP 200 으로 떨어집니다.

5-5. 에러 코드

5-6. CI 에서 쓰는 패턴

테스트 흐름은 보통 셋업·검증·정리 세 단계로 묶입니다.

// 1) 셋업 — 테스트용 셀러 생성
const seller = await createTestSeller({
    primary_key: `ci-${process.env.GITHUB_RUN_ID}-${Date.now()}`,
    company_name: 'CI Sandbox',
    email: `ci+${Date.now()}@example.com`
})

try {
    // 2) 검증 — 결제 흐름 테스트
    await runPaymentFlow(seller.apps[0].application_keys[0].key)
} finally {
    // 3) 정리 — 어떤 결과든 셀러 일괄 삭제
    await fetch(`${process.env.BOOTPAY_TEST_API_URL}/v2/reseller/test/seller/${seller.provider_id}`, {
        method: 'DELETE',
        headers: { 'Authorization': RESELLER_AUTH }
    })
}javascript

primary_key 에 CI 빌드 식별자를 박아두면 누구의 어떤 실행에서 만든 셀러인지 추적이 쉽습니다. 정리에서 누락된 잔여 셀러가 있어도 primary_key 패턴으로 찾아 일괄 처리할 수 있습니다.