호출한 리셀러 자신의 정보를 돌려준다. 계약 상태·유형·요율, 리셀러 웹훅 설정, 리셀러 프로젝트에 발급된 결제(PG) API 키 목록이 들어 있다.
핵심 요약
- 비밀값은 나오지 않는다. 웹훅 서명 비밀은 설정 여부(
secret_set)만, API 키의secret_key는 앞 5자 +*****로 가린 값만 온다. apps[].key_chains는 리셀러 자기 프로젝트의 키만이다. 하위 가맹점 프로젝트의 키는 키 생성·조회 로 본다.- 사용 중이고 만료되지 않은 키만 보인다. 폐기했거나 만료된 키는 빠진다.
- 계약 값(요율·체결일·만료일)은 부트페이가 넣는다. 아직 넣지 않았으면
null이다.
API 정보
GET
https://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())javascriptimport 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/me', headers={'Authorization': auth})
print(res.json())pythonRESELLER_AUTH=$(printf '%s' "$BOOTPAY_RESELLER_CLIENT_KEY:$BOOTPAY_RESELLER_SECRET_KEY" | base64)
curl "https://api.bootpay.co.kr/v2/reseller/me" -H "Authorization: Basic $RESELLER_AUTH"bash응답
{
"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) | 부트페이에 문의한다 |



