기능 계획

기능을 켜거나 워크스페이스 플랜을 바꾸기 전에 이 페이지를 사용합니다. 첫 출시는 보통 가장 작은 유효 기능 범위가 가장 안전합니다.

기능 토큰과 유효 가용성Copy Anchor Link

tenant-admin 또는 super-admin이 활성 워크스페이스의 기능 선택을 검토합니다. 기능 토큰은 번역된 메뉴 이름과 별개인 고정 기계 식별자입니다. 최소 플랜과 자동 의존성은 다음과 같습니다.

선택한 기능 중 플랜이 허용하는 기능을 먼저 구한 뒤 필수 의존성을 추가합니다. 예를 들어 community나 membership을 선택하면 customers가 추가되며, ecommerce는 자동 추가되지 않습니다. 출시 전에 유효 기능, 자동 추가된 의존성, 플랜에 막힌 선택을 확인합니다.

기능 활성화가 역할 부여·콘텐츠 게시·고객 OAuth 클라이언트 등록을 대신하지 않습니다. 앱 구현은 도메인 작업 가이드를 사용하고, 이 페이지에서는 운영 범위와 가용성을 확인합니다.

플랜별 사용 가능 기능Copy Anchor Link

커머스·이벤트 일반 이메일은 KST 월간 공통 풀을 사용합니다: Free 100 / Starter 1,000 / Basic 1,000 / Pro 3,000건. Enterprise는 무제한입니다. 고객 OTP·비밀번호 재설정·행사 취소는 관측되지만 일반 한도·고객 과금에서 제외합니다. Sandbox는 세대별 월 공통 100회이며 필수 메일도 포함하고 외부 발송·청구는 없습니다. 동영상은 Starter·Basic·Pro에서, 라이브 스트리밍은 Enterprise에서 사용할 수 있습니다.

갤러리 아이템은 기본적으로 이미지를 사용합니다. 피드형 콘텐츠나 포트폴리오에서는 아이템마다 영상 하나를 연결해 같은 갤러리 순서로 배치할 수 있습니다. 영상 아이템은 워크스페이스의 현재 플랜에서 동영상 기능을 사용할 수 있고 해당 기능이 켜져 있어야 하며, 기존 영상 업로드·처리·재생 흐름을 사용합니다. 이미지 갤러리는 Free에서도 사용할 수 있습니다.

유료 플랜 포함량Copy Anchor Link

신규로 선택할 수 있는 유료 플랜은 Basic과 Pro이며, Pro보다 큰 규모는 Enterprise로 문의합니다. 가격은 VAT 포함이고 연간 결제는 월간 10개월분입니다.

• 연간 결제도 API 호출과 일반 이메일은 월 제공량입니다. 둘 다 KST 달력 월 1일에 초기화되며, 카드 결제일(구독 기간)과는 별개입니다.
• 스토리지·문서·웹훅은 보유량이며 매월 초기화되지 않습니다. 100GiB는 107,374,182,400바이트입니다.
• API 호출은 X-Publishable-Key를 보낸 /api 요청을 셉니다. 키가 없는 요청과 CORS preflight(OPTIONS)는 세지 않고, 처리 중 오류가 난 요청은 셉니다. 한도를 넘은 다음 요청부터 429 usage_limit_exceeded가 반환됩니다. Live에서 사용량 저장소에 일시적으로 접근할 수 없으면 요청을 허용하고, Sandbox에서는 거절합니다. 따라서 API 한도는 비용 상한을 보장하지 않습니다.
• 스토리지는 한도의 100%에서 경고하고, 기본 2배 안전 상한에 도달하면 용량을 늘리는 업로드를 막습니다. 기존 파일 읽기·삭제는 유지됩니다.
• 사용량이 낮은 플랜의 한도를 넘어도 자동 삭제, 자동 추가 청구, 자동 업그레이드는 없습니다. 한도를 넘는 동안 해당 항목의 새 생성·발송·업로드가 제한될 수 있습니다.
• 웹훅 등록 10개는 무제한 전송이나 재시도를 뜻하지 않습니다.

API 계량 저장이 불명확해도 Live 워크스페이스와 Project에 속하지 않은 워크스페이스의 API 요청은 계속 처리됩니다. 완전성 근거가 없으므로 정상처럼 보이는 월을 포함해 Enterprise 월별 사용량의 최초 청구서 발행은 보류합니다. 기존 청구서의 후속 처리와 정액 구독 결제는 유지하며 추정 수량으로 청구하지 않습니다.

기능 결정Copy Anchor Link

폼 제출Copy Anchor Link

같은 폼 안의 입력 필드마다 서로 다른 이름을 입력하세요. 폼을 만들거나 필드 구성을 바꿀 때 이름이 중복되면 해당 필드에 수정 안내가 표시됩니다. 기존 폼의 필드 구성을 그대로 두면 제목만 수정할 수 있습니다.

접수한 응답은 Admin Panel의 폼 → 폼 제출에서 확인하세요. Live와 Sandbox 워크스페이스 모두 폼 제출 알림 메일을 지원하지 않습니다. 폼의 emails 설정(emailFrom, emailTo, replyTo, cc, bcc, 제목과 본문)은 호환성을 위해 보존되며 메일 발송에 사용되지 않습니다. 기존에 저장한 설정과 API로 저장한 설정에도 동일하게 적용됩니다.

의존 관계Copy Anchor Link

• Community는 고객 계정에 의존합니다.
• Membership은 고객 계정을 필요로 합니다. 상품과 주문도 사용하려면 ecommerce를 별도로 선택하세요.
• 진행 중이거나 설정이 끝나지 않은 멤버십 또는 미해결 청구가 있으면 Membership을 끌 수 없습니다. 다른 변경으로 기능이 비활성화되면 갱신 청구가 멈추고 기존 멤버십은 결제된 기간이 끝날 때 종료됩니다. 고객은 계속 조회·해지할 수 있으며, 기능을 다시 켜도 중지된 갱신은 자동 재개되지 않습니다.
• 기존 유료 회원은 갱신 결과가 확정되기 전까지 결제 기간 종료 후 최대 2시간 그룹 혜택을 유지합니다. 갱신 거절, 해지, 결제 수단 철회, 환불이 확정되면 즉시 종료됩니다. past_due에는 이 추가 시간이 적용되지 않으며, 결제 기간 안의 기존 혜택 규칙은 유지됩니다. 이미 확정된 Checkout·Order 가격은 바뀌지 않습니다.
• 플랜에 막힌 기능 의도는 저장될 수 있지만, 플랜이 허용하기 전까지는 유효하지 않습니다.
• 사용하지 않는 기능을 꺼두면 내비게이션과 준비 상태 점검이 선명해집니다.

Console 메뉴 검색Copy Anchor Link

사이드바의 검색 버튼이나 Cmd+K/Ctrl+K로 메뉴와 페이지를 검색합니다. 결과에는 메뉴 경로가 표시되며, 결제·배송 같은 설정 항목은 설명에 포함된 단어로도 찾을 수 있습니다.

Console 메뉴 이름Copy Anchor Link

Console에서 tenant-admin 또는 super-admin은 설정 → 워크스페이스 → 사이트·브랜딩 → 메뉴 표시명 항목을 열어 별도 설정 화면에서 활성 워크스페이스의 메뉴 이름을 바꿀 수 있습니다. 같은 이름이 컬렉션 화면의 제목, 경로 안내, Cmd+K에도 표시됩니다. 메뉴는 사이드바와 같은 순서로 묶여 보이고, 묶음 이름은 접을 수 있는 머리 행에서 바꿉니다. 각 메뉴는 기본 이름 옆의 새 이름 칸에서 바꾸고, 메뉴 찾기 결과에는 부모 경로가 붙습니다. 스크롤 중에도 아래쪽에서 저장하거나 기본 이름으로 되돌릴 수 있습니다. 메뉴 이름 변경은 필드명, 콘텐츠 문서 제목, URL, 메뉴 순서, 권한에 영향을 주지 않습니다.

커머스 설정과 브랜딩, SEO, 사업자 정보 설정 화면은 메뉴 이름을 문서 제목에도 사용합니다. 화면 상단의 경로 안내에서 설정(또는 지정한 이름)을 누르면 설정 화면으로 돌아갑니다.

각 메뉴마다 모든 Console UI 언어에서 사용할 이름을 최대 40자의 한 줄로 입력합니다. 빈 값으로 저장하거나 기본 이름으로 복원하면 선택한 UI 언어의 기본 이름이 표시됩니다. 저장된 이름은 다른 워크스페이스 운영자에게도 적용됩니다.

캘린더의 기본 생성 제목은 목록·문서·설정 화면에서 메뉴 표시명을 따릅니다. 직접 입력한 제목과 저장된 제목은 유지됩니다. 화면 설명은 이름에 의존하지 않는 문구를 사용하며, 월별 일정의 새 이벤트 버튼은 이벤트의 메뉴 표시명을 따릅니다.

계정 이메일Copy Anchor Link

콘솔의 본인 계정에서 이메일을 저장하면 새 주소로 확인 메일을 보냅니다. 메일의 링크를 열고 1시간 안에 변경을 확인할 때까지 기존 주소와 로그인이 유지됩니다. 이메일 변경을 다시 요청하면 이전 확인 링크는 무효가 됩니다.

super-admin이 계정을 관리할 때도 이메일 변경은 계정 본인만 요청할 수 있습니다. Google로 연결된 계정도 로그인할 때 기존에 선택한 주소를 유지합니다.

워크스페이스 보안 이력Copy Anchor Link

tenant-admin 또는 super-admin은 워크스페이스를 명시적으로 선택한 뒤 설정 → 워크스페이스 접근 → 보안 이력에서 기록을 조회할 수 있습니다. 읽기 전용 화면에서 기록된 팀 멤버 추가·제거·역할 변경, 워크스페이스 접근·거부, 관리 IP 정책 변경을 조회합니다.

빈 결과는 현재 페이지에 조건에 맞는 표시 가능한 기록이 없다는 뜻입니다. 페이지를 나눈 뒤 표시할 수 없는 기록을 제외하므로 다음 페이지도 확인하세요. 빈 결과가 사건이 없었다는 뜻은 아닙니다. 수집 시작일은 확인되지 않았으며, 수집 도입 이전 기간에는 기록이 없고 접근 관측은 누락될 수 있습니다. Sandbox 환경의 접근·거부는 기록되지 않습니다. 전체 활동이 아닌 기록된 사건을 제공하며 계정 로그인·2단계 인증 결과는 제외합니다.

기간·행위자 ID·종류·결과로 필터링합니다. 기본 최근 30일, 한 번에 최대 90일, 페이지당 25건이며 날짜와 기록 시각에는 워크스페이스 시간대를 적용합니다. 삭제된 계정에 보존된 ID를 포함해 행위자는 ID만 표시하고 이름·이메일·원본 IP·원본 payload는 표시하지 않습니다. 접근 상세에는 방식·등록된 사유·기록 방식을, 정책 변경에는 설정 종류·변경 또는 복구 사유·기록 방식을 표시합니다.

관리 IP 허용목록도 같은 워크스페이스 접근 설정에서 사용합니다. 적용 자격 증명과 복구 절차는 관리 IP 허용목록을 확인하세요.

공용 결제 설정Copy Anchor Link

이커머스를 켜지 않아도 설정 → 커머스 → 결제 → 결제 제공자 연결에서 결제 제공자 연결을 관리할 수 있습니다. tenant-admin은 명시적으로 선택한 워크스페이스에서 제공자 설정과 자격 증명을 관리합니다. 저장한 비밀 값은 다시 표시되지 않습니다.

• 마켓 연결은 선택 사항입니다. 마켓이 없는 계정은 커머스 체크아웃에서 선택되지 않습니다.
• 토스 설정 확인과 활성화는 이커머스 없이 가능합니다.
• PortOne 활성화에는 연결의 결제 환경에서 검증된 웹훅 라우트가 필요합니다. 라우트 조회와 tenant-admin의 발급·확인·폐기는 이커머스 없이 가능하며, 기존 워크스페이스 권한과 명시적 활성 워크스페이스 조건은 유지됩니다.
• 커머스 연결 전환에는 여전히 이커머스가 필요합니다.
• 이 설정은 공개 Events 결제 API를 활성화하지 않습니다.

PortOne 웹훅 라우트는 결제 연결 화면의 PortOne 웹훅 라우트에서 확인합니다.

1. 웹훅 URL을 발급합니다.
2. PortOne 콘솔에 추가합니다.
3. 연결의 결제 환경과 같은 설정 모드(테스트/실연동)에서 PortOne 콘솔 '호출 테스트'를 보냅니다.
4. 등록된 URL을 입력해 확인합니다.

호출 테스트는 샘플 스토어 ID를 보낼 수 있어 PortOne 콘솔에 실패(401)로 표시될 수 있습니다. 서명이 확인되면 수신은 기록되므로, 패널의 서명된 웹훅 수신이 예가 되면 다음 단계로 진행하세요. 아니요로 남으면 웹훅이 도착하지 않았거나 서명이 확인되지 않은 것입니다. URL을 연결의 결제 환경과 같은 설정 모드에 등록했는지, 저장한 웹훅 시크릿이 그 모드에서 발급한 값인지 확인하세요.

연결을 활성화한 뒤 실제 결제의 웹훅이 계속 거부되면 다음을 확인하세요.

• PortOne 콘솔에서 이 웹훅 URL을 등록한 스토어의 ID가 연결의 스토어 ID와 같은지 확인합니다.
• 연결의 스토어 ID를 잘못 입력했다면, 스토어 ID는 등록 뒤 바꿀 수 없으므로 올바른 스토어 ID로 새 연결을 만들고 새 연결에서 웹훅 라우트를 확인한 뒤 기존 연결은 비활성 상태로 둡니다. 연결은 삭제할 수 없으며, 비활성 연결은 신규 결제에 선택되지 않고 기록은 보존됩니다.
• 한 워크스페이스에서 같은 결제 환경과 같은 스토어 ID로는 연결을 하나만 만들 수 있습니다. 스토어 ID가 맞다면 새 연결로는 해결되지 않습니다.

자격 증명 교체와 재등록Copy Anchor Link

명시적 활성 워크스페이스를 선택한 tenant-admin이 결제 연결 문서를 엽니다. 저장하지 않은 변경 사항은 먼저 저장하거나 취소합니다.

1. 자격 증명 교체를 열고 제공자에서 발급한 새 비밀키를 입력합니다. Toss 클라이언트 키도 바뀌었다면 함께 입력합니다.
2. PortOne은 교체할 비밀키에서 API 시크릿 또는 웹훅 시크릿을 선택합니다. 둘 다 바꿀 때는 각각 실행합니다.
3. 오류가 나면 열린 화면의 사유를 확인하고 재시도합니다. 재입력이 필요하면 같은 화면에서 비밀키를 다시 입력합니다.
4. 성공하면 구성을 다시 확인한 뒤 신규 결제를 활성화합니다. 교체와 구성 변경은 기존 구성 확인을 해제하고 신규 결제를 비활성화합니다.

재등록은 새 비밀키를 입력해 실행합니다. PortOne은 새 API 시크릿과 새 웹훅 시크릿을 함께 입력합니다. 재등록 후 구성을 다시 확인한 뒤 신규 결제를 활성화합니다. 같은 계정 식별자의 새 연결 생성은 비활성 연결과 보관된 연결까지 포함해 중복으로 거절되므로, 오류에 표시된 기존 연결에서 작업합니다.

고객 적립금Copy Anchor Link

Console 적립금 설정 화면은 선택한 워크스페이스의 관리자(또는 super-admin)이고 ecommerce 기능이 유효한 경우에만 열 수 있습니다. 편집자·뷰어는 설정 화면 진입과 설정·템플릿 쓰기가 거부됩니다.

적립금은 ecommerce의 지원 기능이며 별도 유료 기능 토큰이 없습니다. Console 적립금 설정은 비활성으로 시작합니다. 활성화에도 기존 역할·고객 경계를 적용하며, 끄면 신규 지급·사용만 차단하고 기존 적립금 의무는 유지합니다. ecommerce 권한 자체를 바꾸지 않습니다. 적립금 참조 문서를 확인하세요.

Console 주문 상세 → 구매 금액과 결제 내역에서는 구매 총액, 체크아웃 확정 시 적립금·PG 배분액, 주문 배치 시 적립금 사용액, 환불 복원 누계를 구분합니다. PG 수납 여부는 배분액이 아니라 아래 거래별 기록으로 확인하세요.

실제 PG 수납은 성공 거래의 서버 확인 금액·통화·확인 일시를 건별로 표시하며, 환불을 차감한 잔액이나 합계가 아닙니다. 기록이 없거나 확인 값을 읽지 못하면 미확인으로 남깁니다. 전체 거래와 환불은 주문의 관련 문서 → 거래에서 확인하세요.

적립금 설정의 허용·차단 상태는 마지막으로 저장·조회한 결과이며 저장 전 체크박스와 구분됩니다. 고객 잔액에는 조회 기준 시각, 최초 지급·복원 유예별 만료와 내역이 표시됩니다. 사용 가능 잔액이 있어도 신규 사용에는 적립금 설정과 이커머스 권한이 필요합니다.

쿠폰(할인)Copy Anchor Link

이커머스에서 사용 방식에 맞는 쿠폰 항목을 선택합니다.

• 결제 쿠폰·자동 할인: 주문 결제에 적용할 쿠폰 코드와 자동 할인, 적용 조건 및 사용 한도를 관리합니다.
• 교환·이용 쿠폰 종류: 무료 음료나 서비스 1회 이용처럼, 고객에게 발급한 뒤 직원이 주문 없이 사용 처리할 쿠폰의 내용과 유효 기간을 설정합니다.

교환·이용 쿠폰은 종류를 등록한 뒤 워크스페이스 서버에서 고객별로 발급합니다. 고객은 본인 목록을 조회합니다. 콘솔 고객 상세의 교환·이용 쿠폰에서 tenant-admin·tenant-editor는 사용 가능한 쿠폰을 사용 처리하고, tenant-admin은 무효화할 수 있습니다. 발급 연동과 사용 범위를 확인하세요.

고객 계정Copy Anchor Link

고객 계정은 회원가입 또는 권한이 있는 서버 연동을 통해 생성할 수 있습니다. 활성 워크스페이스의 tenant-admin과 super-admin은 고객 목록 헤더의 고객 등록으로 인증 정보가 없는 고객을 등록할 수 있습니다(고객 수동 등록 참고). 로그인 준비는 고객 자신의 인증 절차를 거칩니다. 관계 필드에서는 기존 고객을 선택합니다.

로컬 비밀번호가 있는 고객은 재인증 후 셀프 탈퇴할 수 있습니다. 멤버십 제한과 기록 보존은 고객 셀프 탈퇴를 확인하세요.

멤버십 위임 결제 연결Copy Anchor Link

Membership이 활성화된 워크스페이스의 tenant-admin, 또는 해당 워크스페이스를 선택한 super-admin은 설정 → 커머스 → 결제 → 멤버십 결제 연결을 열 수 있습니다. 연결 화면의 **복구 세대 (현재 배포)**는 비밀이 아닌 읽기 전용 식별자이며 최초 연결 발급 전에도 확인할 수 있습니다.

새 위임 서버는 인증된 SDK billingCustodyContext 호출로 이 값을 자동으로 받습니다. 서버 처리 순서는 결제 키 암호화 보관을 확인하세요. generation을 직접 설정하는 기존 연동은 계속 사용할 수 있습니다. 복구 후 기존 설정을 갱신할 때는 플랫폼 운영자의 재개 공지를 받은 뒤 화면을 새로고침해 값을 확인하세요.

복구 후에는 결제 수단마다 결제 제공자 재승인과 새 암호화 값의 업로드·조회 확인을 완료하세요. 값을 사용할 수 없다는 안내가 나오면 플랫폼 운영자에게 배포 설정 수정을 요청하세요.

멤버십 결제 검토Copy Anchor Link

멤버십 관리자는 결제 성공이 확인됐지만 당시 멤버십 활성화 또는 기간 연장에 반영되지 않았던 기록을 콘솔의 멤버십 → 멤버십 미반영 결제 목록 또는 연결된 멤버십·결제 상세 화면에서 확인할 수 있습니다. 보존된 행에는 결제 내역, 결과 경로(dispatch, webhook 또는 queryCharge), 미반영 사유가 표시됩니다. 같은 결제가 결과 경로별로 여러 행에 표시될 수 있으며, 이후 처리 여부와 관계없이 기록은 보존됩니다.

셋업 만료 뒤 무효 처리된 첫 결제에 늦게 도착한 결제 완료도 voided 사유로 보관됩니다. 멤버십은 만료 상태를 유지합니다. 이 기록은 검토용이며, 환불은 워크스페이스가 처리합니다.

Embedded AdminCopy Anchor Link

워크스페이스 관리자는 단일 내장 앱의 실행 허용 역할을 설정할 수 있습니다. tenant-editor와 tenant-viewer는 허용된 실행 화면만 보며, 수신 서버도 역할을 허용하고 기능별 권한을 검증해야 합니다. Embedded Admin을 참고하세요.

내보내기 정책Copy Anchor Link

워크스페이스를 명시적으로 선택한 관리자는 워크스페이스 문서의 내보내기 탭에서 폼 제출 현재 페이지 CSV와 주문 택배사 CSV/XLSX를 각각 기본 내보내기·사용 안 함·앱으로 내보내기로 설정할 수 있습니다. 미설정은 기본 내보내기이며 워크스페이스 공통 기본값이나 상속은 없습니다.

앱으로 내보내기는 다음과 같이 동작합니다.

• 해당 컬렉션에 등록한 액션, 활성화된 앱, 파일 다운로드 허용이 필요합니다.
• 관리자만 최대 100개를 개별 선택해 실행합니다.
• 앱을 비활성화하거나 액션을 제거하거나 다운로드 허용을 해제하면, 저장된 정책은 그대로 두고 이후 앱 내보내기를 차단합니다.
• 실행이 실패해도 기본 파일로 전환하지 않습니다.

기본 폼 CSV는 ?limit= URL을 사용할 때도 페이지당 행 수를 100개 이하로 설정하세요. Sandbox 생성 시 이 정책은 복사하지 않으며 두 컬렉션 모두 기본 내보내기로 시작합니다.

폼 제출의 기본 CSV는 목록의 ⋮ 메뉴에 있습니다. 폼 제출의 사용 안 함 안내와 앱으로 내보내기 제어는 목록 본문에 표시되며, 실행한 앱도 같은 영역에 열립니다. 주문 택배사 파일은 주문을 선택한 뒤 선택 툴바에서 내보냅니다. 사용 안 함 안내와 앱으로 내보내기 제어도 이 툴바에 표시되며, 실행한 앱은 툴바 아래에 열립니다.

이 설정은 모든 정보 반출을 막지 않습니다. 다음은 계속 사용할 수 있으며 이 통제 범위 밖입니다.

• fulfillment-import-errors.csv, product-import-errors.csv, 가져오기 템플릿. 오류 CSV에는 주문 번호·상품 핸들·입력값과 오류 설명이 포함될 수 있고, 상품 템플릿에는 필드 설정 메타데이터가 포함될 수 있습니다.
• 일반 API 조회, 미디어 다운로드, 캔버스 PNG.

앱 실행은 고객 측 암호화 완료나 기기에 파일이 저장되었다는 증거가 아닙니다. 외부 앱이 자체 데이터 권한과 암호화를 구현해야 합니다.

다음 액션Copy Anchor Link

• 비커머스 영역은 콘텐츠 운영에서 준비합니다.
• 판매 흐름은 커머스 운영에서 준비합니다.
• 차단 요소는 출시 준비 점검에서 확인합니다.

이벤트별 등록 이메일 확인을 켜면 참석자가 이메일로 받은 코드를 확인한 뒤 등록과 좌석을 만듭니다. 기존 연동을 위해 기본값은 꺼짐입니다. 확정 메일에는 해당 등록을 취소하는 링크를 넣으며, 수신자별 발송 상한을 넘겨도 등록은 유지합니다.

탈퇴로 제공되지 않은 유료 기간은 멤버십 → 미제공 유료 기간—테넌트 처리 필요에서 검토합니다. 담당과 처리 상태를 변경할 수 있으며, 금액은 확인 필요로 표시됩니다. 상태 변경은 멤버십·결제 기록을 변경하거나 환불을 실행하지 않습니다.