가맹점 목록 | Bootpay 결제 매뉴얼

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

핵심 요약

목록은 최근 생성 순이다. 리셀러 본인은 목록에 포함되지 않는다.
list 의 각 원소는 가맹점 조회 의 셀러 객체와 같은 형태다.
count 는 페이지와 무관한 전체 하위 가맹점 수다.
프로젝트 정보는 포함되지 않는다. 프로젝트는 프로젝트 목록 으로 조회한다.

API 정보

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

요청 파라미터

파라미터	타입	필수	설명
`page`	Number	선택	페이지 번호 (쿼리). 기본 `1`
`limit`	Number	선택	페이지당 건수 (쿼리). 기본 `20`, 최대 `100`

코드 예제

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

응답

{
  "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":              "한입가게",
      "parents": [
        "63ff0aa1a1b2c30000d20001"
      ]
    }
  ],
  "count": 37
}json

응답 파라미터

파라미터	타입	설명
list	Array	하위 가맹점 배열. 원소 형식은 가맹점 조회 와 같다
count	Number	전체 하위 가맹점 수

에러 코드

코드	메시지	대처 방법
`API_ONLY_RESELLER`	리셀러만 이용이 가능한 API 다	리셀러 권한 계정 키로 호출한다
`API_SCOPE_INVALID`	허용되지 않은 API 권한의 키다	리셀러 프로젝트의 전체 권한(supervisor) Client Key 로 호출한다

다음 단계

특정 가맹점을 자세히 보려면 → 가맹점 조회
가맹점의 프로젝트 목록을 보려면 → 프로젝트 목록