상점

인증된 프로젝트(쇼핑몰)의 기본 정보와 판매자 정보를 읽습니다. 쇼핑몰 화면의 상호·고객센터·사업자 정보 표시에 씁니다. 설정을 바꾸려면 쇼핑몰 설정을 봅니다.

두 API 모두 상품 상세와 같은 scope(user:product_detail)로 검사합니다.

GET /v1/store

쇼핑몰 설정과 판매자 요약을 조회합니다.

인증

  • Authorization: Basic base64(clientKey:secretKey) 필수 — 인증
  • 필요한 scope: user:product_detail
  • 회원 JWT(Bootpay-User-JWT): 필요 없음

요청

파라미터가 없습니다.

응답

200 OK

{
  "mall": {
    "name": "부트커피",
    "description": "매일 볶는 원두",
    "status": 1,
    "seller_name": "부트커피",
    "biz_tel": "02-000-0000",
    "use_logo": true,
    "logo": "https://.../logo.png",
    "use_non_member_order": true,
    "use_cart": true,
    "product_sort_type": 4,
    "subdomain": "bootcoffee",
    "order_cancel_reasons": [],
    "social_login_key": {},
    "created_at": "2026-01-10T10:00:00+09:00"
  },
  "seller": {
    "seller_id": "65f0...",
    "company_name": "부트커피",
    "email": "help@example.com",
    "level": 1,
    "tel": "02-000-0000",
    "guide_no": null,
    "registration_no": "123-45-67890",
    "level_name": "가맹점"
  }
}json
필드 타입 설명
mall object 쇼핑몰 설정. 키는 쇼핑몰 설정 조회 응답과 같습니다(단 mall_setting_id 는 없음). 아래 키가 더해집니다
mall.subdomain string 쇼핑몰 서브도메인
mall.order_cancel_reasons array 주문 취소 사유 목록
mall.social_login_key object 소셜 로그인 설정. 비밀값(client_secret, private_key)은 빈 문자열로 가리고 <키>_saved 로 저장 여부만 알려 줍니다
mall.created_at string 쇼핑몰 생성 시각
seller.seller_id string 판매자 ID
seller.company_name string 상호
seller.email string 사업자 이메일(없으면 계정 이메일)
seller.level integer 판매자 등급
seller.level_name string 등급 이름 (가맹점, 리셀러, 대리점, 총판, 본사)
seller.tel string 사업자 전화번호
seller.guide_no string 안내 번호
seller.registration_no string 사업자등록번호

오류

HTTP error_code 언제
442 MALL_INACTIVE 쇼핑몰이 비활성 상태

공통 오류(인증·scope·방화벽)는 오류를 봅니다.

변경 이력

  • 2026-09-23 문서 최초 작성

GET /v1/store/detail

판매자의 사업자 상세 정보를 조회합니다. 쇼핑몰이 비활성 상태여도 응답합니다.

인증

  • Authorization: Basic base64(clientKey:secretKey) 필수 — 인증
  • 필요한 scope: user:product_detail
  • 회원 JWT(Bootpay-User-JWT): 필요 없음

요청

파라미터가 없습니다.

응답

200 OK

{
  "seller": {
    "seller_id": "65f0...",
    "company_name": "부트커피",
    "email": "help@example.com",
    "level": 1,
    "level_name": "가맹점",
    "tel": "02-000-0000",
    "registration_no": "123-45-67890",
    "seller_name": "부트커피",
    "seller_name_english": "Boot Coffee",
    "corp_reg_no": null,
    "business_type": "도소매",
    "business_item": "커피",
    "owner_name": "홍길동",
    "addr1": "서울시 ...",
    "addr2": "3층",
    "zip": "06000",
    "fax": null,
    "mail_order_sales_number": "2026-서울-0000",
    "message_send_blocked": false,
    "ai_product_assistant_enabled": true,
    "mall_custom_domain_enabled": true
  }
}json

seller 에는 GET /v1/store 의 seller 필드에 다음이 더해집니다. 값이 없는 필드는 빠집니다.

필드 타입 설명
seller_name, seller_name_english string 상호(국문·영문)
corp_reg_no string 법인등록번호
business_type, business_item string 업태, 종목
owner_name string 대표자명
zip, addr1, addr2 string 사업장 주소
fax string 팩스
mail_order_sales_number string 통신판매업 신고번호
service_payment_enabled, settle_payment_status, settle_payment_day, settle_payment_charge_type 서비스 이용료 결제 상태
message_service_payment_enabled, message_settle_payment_status, message_settle_payment_charge_type 메시지 이용료 결제 상태
message_send_blocked boolean 쇼핑몰 자동 알림 발송이 막혀 있는지
message_send_blocked_reason string 막힌 이유. not_affiliated(부트페이 결제 미가맹)
ai_product_assistant_enabled, ai_product_assistant_disabled_reason AI 상품 등록 사용 가능 여부·이유
mall_custom_domain_enabled, mall_custom_domain_disabled_reason 개별 도메인 연결 가능 여부·이유
ai_notice_assistant_enabled, ai_notice_assistant_disabled_reason 공지사항 AI 작성 사용 가능 여부·이유

오류

공통 오류(인증·scope·방화벽)만 있습니다 — 오류.

변경 이력

  • 2026-09-23 문서 최초 작성

함께 보기