마켓플레이스

가맹점 조회

provider_id 만 알면 셀러 기본정보를 다시 꺼낸다.

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

핵심 요약

  • 리셀러 본인의 하위에 묶이지 않은 provider_id 를 넣으면 PROVIDER_NOT_FOUND 가 떨어진다. 다른 리셀러의 셀러를 들여다보는 건 막혀 있다.
  • 응답은 가맹점 생성 의 셀러 필드와 동일한 형태에 seller_name 과 parents 가 추가된다.
  • 프로젝트 목록·결제수단 정보는 응답에 포함되지 않는다. 프로젝트 단위 정보가 필요하면 별도 프로젝트 API 를 호출한다.

API 정보

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

요청 파라미터

파라미터 타입 필수 설명
provider_id String 필수 조회할 셀러의 provider_id (URL 경로)

코드 예제

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

응답

{
  "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"
  ]
}json

응답 파라미터

파라미터 타입 설명
provider_id String 셀러 식별자
email String 셀러 대표 이메일
company_name String 회사명
owner_name String 대표자명
manager_name String 담당자명
phone String 연락처
homepage String 서비스 URL
lv Number 가맹점 레벨 (1 = 셀러, 2 = 리셀러)
regist_no String 사업자등록번호
zip / address1 / address2 String 주소
seller_name String 콘솔 표시용 셀러명
parents Array 상위 리셀러 체인. 본인 리셀러 provider_id 가 포함되어 있다

에러 코드

코드 메시지 대처 방법
API_ONLY_RESELLER 리셀러만 이용이 가능한 API 다 리셀러 권한 계정 키로 호출한다
PROVIDER_NOT_FOUND 본인 하위에 해당 셀러가 없다 provider_id 가 본인 리셀러 소속인지 확인한다

다음 단계

최신 글가맹점 생성 이전 글프로젝트 생성