마켓플레이스

리셀러 내 정보

리셀러 계정이 지금 어떤 상태인지 한 번에 확인한다.

호출한 리셀러 자신의 정보를 돌려준다. 계약 상태·유형·요율, 리셀러 웹훅 설정, 리셀러 프로젝트에 발급된 결제(PG) API 키 목록이 들어 있다.

핵심 요약

  • 비밀값은 나오지 않는다. 웹훅 서명 비밀은 설정 여부(secret_set)만, API 키의 secret_key 는 앞 5자 + ***** 로 가린 값만 온다.
  • apps[].key_chains 는 리셀러 자기 프로젝트의 키만이다. 하위 가맹점 프로젝트의 키는 키 생성·조회 로 본다.
  • 사용 중이고 만료되지 않은 키만 보인다. 폐기했거나 만료된 키는 빠진다.
  • 계약 값(요율·체결일·만료일)은 부트페이가 넣는다. 아직 넣지 않았으면 null 이다.

API 정보

GEThttps://api.bootpay.co.kr/v2/reseller/meBasic Auth (리셀러 계정 키)

요청 파라미터

없음.

코드 예제

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/me', {
    headers: { 'Authorization': RESELLER_AUTH }
})
console.log(await res.json())javascript

응답

{
  "provider_id":  "63ff0aa1a1b2c30000d20001",
  "company_name": "클래스클론",
  "reseller_contract": {
    "status":             null,
    "type":               "B",
    "fee_rate":           0.3,
    "fee_rate_overrides": { "65a1c0aa8f1b5b00367a0001": 0.25 },
    "signed_at":          "2026-10-01T00:00:00+09:00",
    "expires_at":         "2027-09-30T23:59:59+09:00",
    "message_billing_payer": true
  },
  "webhook": {
    "url":        "https://reseller.example.com/bootpay/webhook",
    "events":     ["seller.onboarding.changed", "seller.activated"],
    "secret_set": true,
    "updated_at": "2026-10-27T10:00:00+09:00"
  },
  "apps": [
    {
      "app_id":   "63ff0aa1a1b2c30000d20010",
      "app_name": "클래스클론 연동",
      "status":   20,
      "key_chains": [
        {
          "app_key_chain_id": "63ff0aa1a1b2c30000d20020",
          "name":             "연동 서버",
          "client_key":       "example_client_key",
          "secret_key":       "Ab3dE*****",
          "is_supervisor":    true,
          "expires_at":       "2099-12-31T23:59:59+09:00",
          "api_scopes":       [],
          "created_at":       "2026-10-20T10:00:00+09:00",
          "server_at":        "2026-10-27T10:00:00+09:00",
          "is_copiable":      false,
          "status":           1
        }
      ]
    }
  ]
}json
필드 타입 필수 설명
provider_id String 필수 리셀러 provider_id
company_name String 필수 리셀러 상호
reseller_contract Object 필수 계약 정보
status String 선택 null·signed = 사용 중, suspended = 부트페이가 사용을 멈춤(이때는 이 API 도 403 RESELLER_SUSPENDED)
type String 선택 리셀러 유형. A 대표가맹점형, B 영업대행형, null = 고른 적 없음(영업대행형으로 동작)
fee_rate Number 선택 기본 리셀러피 요율(%)
fee_rate_overrides Object 필수 하위 가맹점별 요율 { provider_id: 요율 }. 없으면 {}
signed_at String 선택 계약 체결일
expires_at String 선택 계약 만료일
message_billing_payer Boolean 필수 알림톡 이용료 대납 옵션. true 면 하위 가맹점 전체의 유료 알림톡 이용료를 리셀러가 낸다. 바꾸려면 부트페이에 문의한다
webhook Object 필수 리셀러 웹훅 조회 응답과 같다(url·events·secret_set·updated_at)
apps Array 필수 리셀러 자기 프로젝트 목록(만든 순)
app_id String 필수 프로젝트 식별자
app_name String 필수 프로젝트명
status Number 필수 프로젝트 상태
key_chains Array 필수 그 프로젝트의 결제(PG) API 키 목록. 항목은 키 생성·조회 조회 응답의 PG 항목과 같다(secret_key 는 가린 값)

에러 코드

코드 메시지 대처 방법
API_ONLY_RESELLER (601) 리셀러만 이용이 가능한 API 다 리셀러 권한 계정 키로 호출한다
API_SCOPE_INVALID 허용되지 않은 API 권한의 키다 (HTTP 401) 키에 이 API 의 리셀러 스코프 를 주거나 전체 권한(supervisor) 키로 호출한다
RESELLER_SUSPENDED (343) 리셀러 사용이 멈췄다 (HTTP 403) 부트페이에 문의한다

함께 보기