앱 등록하기
쇼핑몰 관리자에서 앱을 등록하고 Client ID · 비밀 키를 받습니다.
업데이트됨 10.13 — 회원이 마이페이지에서 연결된 앱을 해지합니다어디서 등록하나요
앱은 쇼핑몰 관리자에서 등록합니다. 쇼핑몰 소유자(마스터)만 등록 · 수정할 수 있고, 부운영자에게는 열리지 않습니다.
메뉴 위치
쇼핑몰 관리자 > 설정 > 외부연동 설정 > 앱 관리 > [앱 등록]
등록한 앱은 그 쇼핑몰에 묶입니다. 다른 쇼핑몰에서 쓰려면 그 쇼핑몰 관리자에서 따로 등록합니다.
입력 항목
| 항목 | 형식 | 설명 |
|---|---|---|
앱 이름필수 | string | 동의 화면에 그대로 보입니다. 판매자가 알아볼 수 있는 서비스 이름을 적으세요. 50자까지입니다. |
앱 종류필수 | 서버 | 브라우저·모바일 | 서버 앱은 비밀 키로 토큰을 받습니다(주문관리 · AI 에이전트 등). 브라우저 · 모바일 앱은 비밀 키 없이 PKCE 만으로 받고, 회원 본인 권한만 고를 수 있습니다 — 외부에서 만든 쇼핑몰 화면 · 회원용 앱이 씁니다. 등록한 뒤에는 바꿀 수 없습니다. |
Redirect URI필수 | URL[] | 인가가 끝나면 돌아올 주소입니다. 최대 5개, 정확히 같은 문자열만 허용됩니다(앞부분 일치 · 와일드카드 불가). https 를 쓰고, 개발 중에는 http://127.0.0.1:포트 를 쓸 수 있습니다. |
권한필수 | scope[] | 이 앱이 요청할 수 있는 최대 범위입니다. 실제 권한은 판매자가 동의 화면에서 승인해야 생깁니다. → 권한(스코프) |
이용 목적 | 100자 | 회원 본인 권한을 고르면 나옵니다. 회원 동의 화면의 제3자 제공 고지에 실립니다. 비우면 "회원 확인 및 서비스 제공". |
개인정보처리방침 | https URL | 회원 본인 권한을 고르면 나옵니다. 회원 동의 화면에 링크로 실립니다. |
회원 해지 | 마이페이지에서 바로 | 고객센터로 요청 | 회원 본인 권한을 고르면 나옵니다. 회원이 동의를 철회하는 길입니다. 마이페이지에서 바로(기본)면 쇼핑몰 마이페이지 > 연결된 앱에서 [해지] 로 끊고, 고객센터로 요청이면 그 자리에 쇼핑몰 고객센터 연락처가 보입니다. 어느 쪽이든 철회 자체를 막지는 않습니다(개인정보보호법 제37조) — 동의 화면 보유 기간에도 이 길이 적힙니다. |
상태 | 사용 | 중지 | 중지하면 새 인가와 토큰 발급이 막힙니다. |
Client ID 와 비밀 키
| 값 | 모양 | 다루는 법 |
|---|---|---|
client_id | ms_ 로 시작 | 공개 식별자입니다. 브라우저 주소에 실려도 됩니다. |
client_secret | 임의 문자열 | 서버에만 둡니다. 브라우저 · 앱 · 저장소에 넣지 마세요. |
비밀 키는 발급 직후 한 번만 보입니다
창을 닫으면 다시 볼 수 없습니다. Mall Story 는 비밀 키를 암호화해 저장하며 원문을 보관하지 않습니다.잃어버렸거나 새어 나갔다면 앱 목록의 ⋯ > 비밀 키 재발급을 누르세요. 재발급하는 순간 이전 키는 쓸 수 없습니다.
등록 전 확인
- Redirect URI 를 운영 · 스테이징 · 로컬 각각 정확히 적었나요? 끝의 / 하나만 달라도 거절됩니다.
- 권한은 지금 꼭 필요한 것만 골랐나요? 쓰기 권한이 많을수록 판매자가 승인을 망설입니다.
- 비밀 키를 보관할 서버 쪽 비밀 저장소(환경변수 · Secret Manager)를 준비했나요?