시작하기
가입부터 내 쇼핑몰 공개까지, 그리고 결제를 받는 경우
이 문서를 따라 하면 상점 플랫폼에서 클릭만으로 {주소}.sayren.co 쇼핑몰을 만들고 공개합니다. 코드는 쓰지 않고 10분 정도 걸립니다.
결제는 공개의 조건이 아닙니다. 결제를 받으려면 공개 전후 언제든 결제를 받는 경우를 따릅니다.
API·SDK로 직접 만들려면 개발자로 시작하기로 갑니다.
| 구성 | 하는 일 |
|---|---|
상점 플랫폼 (store.sayren.io) | 상점·상품·주문 관리, 쇼핑몰 만들기·공개, 결제 연결 |
| 스토어프론트 | 구매자가 보는 쇼핑몰 화면. 상점 플랫폼에서 만들거나 템플릿·SDK로 직접 만듭니다 |
| 관리 API · 스토어프론트 API | 셀러용 · 구매자 화면용 API. 규칙은 API 기본 사항 |
1. 가입
- sayren에서 **[무료로 시작하기]**를 누르면 가입 화면이 열립니다.
- 이메일·이름을 입력하고 약관에 동의합니다. 메일로 받은 인증 코드를 입력합니다. Google·카카오로도 가입할 수 있습니다.
완료 기준: 쇼핑몰을 만듭니다 화면이 열립니다.
2. 쇼핑몰 만들기
- 상점 이름을 확인합니다.
{이름}의 쇼핑몰로 미리 채워져 있고 나중에 바꿀 수 있습니다. - 필요하면 판매 품목과 현재 단계를 고릅니다. 고르지 않아도 됩니다.
- 판매 품목은 넣을 샘플 상품을 정합니다.
- 현재 단계가 다른 곳에서 판매 중이면 홈 체크리스트의 결제를 받는 경우가 펼쳐져 있습니다.
- 샘플 상품 넣기는 기본으로 켜져 있습니다. 샘플 3개로 쇼핑몰 화면을 먼저 보고, 공개할 때 지웁니다. 끄면 빈 쇼핑몰입니다.
- **[쇼핑몰 만들기]**를 누릅니다.
준비 화면에서 샘플 상품 넣기 → 쇼핑몰 만들기 → 주소 연결이 차례로 끝납니다. 1분 정도 걸리고, 화면을 닫아도 준비는 계속됩니다. 준비하지 못한 단계가 있으면 **[다시 시도]**를 누릅니다. 끝난 단계는 다시 하지 않습니다.
완료 기준: 미리보기가 준비됐습니다가 보입니다. **[미리보기 열기]**로 내 쇼핑몰을 봅니다. 쇼핑몰 주소는 상점 코드로 만들어집니다. 공개 전(오픈 준비중)에는 방문자에게 준비 중 화면이 보이고, 미리보기는 상점 플랫폼에 로그인한 소유자·관리자만 엽니다.
3. 오픈 준비
홈(상점 관리 › 대시보드)의 오픈까지 남은 일에 할 일이 묶음별로 있습니다. 완료는 저장한 내용을 보고 자동으로 체크됩니다.
| 묶음 | 항목 |
|---|---|
| 공개 필수 | 내 상품 등록(샘플이 아닌 판매 중 상품 1개 이상) · 상점 정보(이름·로고·고객센터 전화) |
| 선택 | 디자인 · 배송비 · 쇼핑몰 주소 · 내 도메인 · 개발자 도구 |
| 결제를 받는 경우 | 사업자 정보·정책 · PG 연결 · 테스트 주문 · 환불 테스트 · 라이브 결제 켜기 |
상품은 상점 관리 › 상품 › 상품 등록에서 등록합니다. 자세한 내용은 상품·옵션·재고 관리와
배송비와 출고지·반품지를 보십시오. 상점 플랫폼 상품 목록에서 샘플에는 샘플 배지가 붙고, 쇼핑몰에는 표시가 없습니다.
4. 상점 공개
- 홈의 **[상점 공개]**를 누릅니다. 내 상품이 없으면 누를 수 없습니다.
- 샘플이 남아 있으면 샘플 상품을 지우고 공개가 켜져 있습니다. 진행 중 주문이 있는 샘플은 지우지 않고 판매종료로 내립니다.
- 상점 정보나 결제가 비어 있으면 경고가 보입니다. 공개는 막지 않습니다.
- [샘플 지우고 공개](샘플이 없으면 [상점 공개])를 누릅니다.
완료 기준: 홈에 공개중이 보이고 **[쇼핑몰 열기]**로 누구나 볼 수 있는 쇼핑몰이 열립니다.
결제를 연결하지 않았으면 쇼핑몰은 상품만 보여 주고 「지금은 온라인 주문을 받지 않습니다」를 안내합니다(고객센터 전화가 있으면 문의 전화도).
공개 조건과 미리보기는 스토어프론트 호스팅에 있습니다.
결제를 받는 경우
PG(토스페이먼츠·포트원)는 셀러가 직접 계약합니다. 테스트 키로 먼저 확인하고 라이브로 전환합니다.
- 설정 › 결제에서 PG를 연결하고 연결 테스트를 합니다(소유자만). 순서는 결제 설정에 있습니다.
- 공개 전 미리보기에서 테스트 결제로 주문하고 취소해 환불까지 확인합니다. 공개한 쇼핑몰은 테스트 결제를 받지 않습니다.
- 라이브 전환으로 실제 결제를 엽니다.
완료 기준: 상점 관리 › 판매 › 주문에 테스트 결제 배지가 붙은 주문이 보이고, 라이브 전환 뒤에는 공개한 쇼핑몰이 주문을 받습니다.
이미 공개했다면 테스트 주문은 쇼핑몰을 오픈 준비중으로 되돌려 미리보기에서 합니다.
개발자로 시작하기
화면을 직접 만들거나 기존 프론트엔드에 붙이려면 템플릿이나 SDK로 시작합니다. 상점 플랫폼 쇼핑몰과 같은 API를 씁니다.
| 방법 | 이런 경우 | 시작 문서 |
|---|---|---|
| AI 에이전트 | 템플릿에서 시작해 디자인만 바꿀 때 | MCP 연결하기 → 첫 쇼핑몰 만들기 |
| 직접 개발 | 기존 프론트엔드에 붙이거나 처음부터 짤 때 | Storefront SDK → 결제 연동 |
| 상점 플랫폼 쇼핑몰 고치기 | 만든 쇼핑몰의 코드를 내 PC에서 고칠 때 | 스토어프론트 CLI |
템플릿만 받으려면 아래를 실행합니다. 토큰은 Sayren 계정 › 액세스 토큰에서 만듭니다(상점 플랫폼 개발자 › 자격 증명 › 액세스 토큰).
SAYREN_TOKEN=액세스_토큰 SAYREN_STORE_ID=store_abc123 npx -y @sayren/mcp create my-shop
cd my-shop && npm install && npm run dev토큰을 주면 .env의 SAYREN_API_URL·SAYREN_STORE_CODE와 원격 MCP 연결 설정 .mcp.json이 채워집니다. .mcp.json에는 주소와 상점 id만 있고 토큰은 없습니다.
직접 만드는 쇼핑몰도 GET /store의 checkoutAvailable이 false면 주문 버튼을 숨깁니다(상점 공개 설정).
API 응답을 먼저 보고 싶다면
카탈로그는 인증 없이 호출합니다. 상점이 아직 없으면 데모 상점 코드 rk6dzy3b49k0으로 응답 형태만 봅니다.
curl https://api.sayren.io/storefront/v1/products -H "X-Store-Code: {상점 코드}"상점 코드를 빠뜨리거나 틀리면 404 STORE_NOT_FOUND입니다. 상점 지정과
데모 상점으로 응답 미리 보기를 보십시오.