인증된 프로젝트(쇼핑몰)의 기본 정보와 판매자 정보를 읽습니다. 쇼핑몰 화면의 상호·고객센터·사업자 정보 표시에 씁니다. 설정을 바꾸려면 쇼핑몰 설정을 봅니다.
두 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
}
}jsonseller 에는 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 문서 최초 작성
