릴리즈 노트

새 기능과 바뀐 점을 짧게 알려 드립니다. API 필드 단위의 자세한 내용은 변경 이력에 있습니다.

2026-10-02

상점

상점 관리 › 마케팅 › 쿠폰의 발급 방식에 다운로드와 회원가입이 생겼습니다. 다운로드 쿠폰은 구매자가 스토어프론트의 쿠폰 목록·상품 상세에서 직접 받고, 회원가입 쿠폰은 회원가입한 구매자에게 1장씩 자동으로 지급됩니다. 둘 다 총 발급 한도와 받은 뒤 유효 일수를 설정할 수 있습니다. 쿠폰
모든 주문에 숫자 주문번호(14자리, 예: 2610-0284-7315-92)가 붙습니다. 주문 목록과 주문 상세에 주문번호가, 주문 상품마다 상품주문번호가 보이고, 클레임 상세에 클레임번호가 보입니다. 주문 목록 검색어에 주문번호를 넣어도 찾습니다. 이전 주문에도 번호가 채워져 있습니다. 주문·상품 번호
새 결제부터 토스페이먼츠·포트원 관리자 화면의 주문번호가 {주문번호}-01 형식입니다. 다른 결제수단으로 다시 시도하면 끝 순번이 올라갑니다.
기본 스토어프론트 템플릿(0.2.15) 주문 내역·주문 상세·비회원 주문 조회에 주문번호가 보입니다. 비회원 주문 조회는 주문번호로도 찾습니다.
상품마다 상점별로 1부터 매기는 상품번호가 붙습니다. 기본 스토어프론트 템플릿(0.2.15)의 상품 주소가 /products/{상품번호}로 바뀌고, 예전 상품 주소는 새 주소로 옮겨 가 공유·검색 링크가 그대로 열립니다.
적립금이 결제 금액 전체를 덮으면 결제창 없이 바로 주문됩니다. 결제수단을 고르지 않고, 주문 상세의 결제수단은 「적립금」입니다. 취소·반품하면 적립금으로 돌려줍니다. 남는 결제 금액이 1~99원일 때만 100원을 남깁니다. 적립금
기본 스토어프론트 템플릿(0.2.12) 주문서가 적립금으로 결제 금액 전체를 내면 결제수단 영역을 숨기고 「적립금으로 결제」 버튼을 보여 줍니다.
상점 관리 › 상품 › 컬렉션의 조건 자동 컬렉션에 판매량 상위 조건이 생겼습니다. 최근 7·30·90일 동안 많이 팔린 상품을 원하는 개수만큼 자동으로 담고, 다른 조건과 함께 켜면 그 조건을 만족하는 상품 중에서 고릅니다. 판매 수량은 실결제 주문에서 취소·반품을 뺀 값이고 10분마다 다시 집계합니다. 일치 상품 미리보기에 판매량 기준 시각이 보입니다. 상품 정렬에 판매량순도 생겼습니다. 컬렉션
상점 관리 › 마케팅 › 적립금에 적립금 사용이 생겼습니다. 켜면 회원이 결제에 적립금을 사용합니다. 최소 보유액·최소 사용액·사용 단위·최대 사용 비율·배송비 사용 여부를 설정합니다. 즉시할인과 쿠폰을 적용한 뒤 금액에 사용하고, 결제 금액은 100원 이상 남깁니다. 취소·반품하면 적립금으로 낸 몫은 적립금으로 돌려주고, 차감은 현금 환불에서 먼저 뺍니다. 주문 상세 결제 금액에 「적립금 사용」, 클레임 상세에 「예상 적립금 반환」이 보입니다. 적립금 사용은 준비가 끝나면 켤 수 있습니다. 적립금
기본 스토어프론트 템플릿(0.2.11) 주문서에 적립금 칸이 생겼습니다. 보유 적립금과 최대 사용액을 보여 주고 「전액 사용」을 누를 수 있습니다.
상점 관리 › 상품 › 컬렉션에서 조건 자동 컬렉션을 만듭니다. 등록일·카테고리(하위 포함)·가격·할인 상품 조건을 켜면 모두 만족하는 판매 중인 상품이 자동으로 담기고, 만들기 전에 일치 상품 수와 앞 상품을 미리 봅니다. 상품을 등록하거나 가격을 바꾸면 바로 반영됩니다. 조건에 사용하는 카테고리는 삭제할 수 없습니다. 컬렉션
상점 관리 › 마케팅 › 적립금에서 리뷰 적립(사진 리뷰 추가분)·구매 적립률·유효 기간을 설정합니다. 상품마다 적립률을 다르게 하거나 적립하지 않게 할 수 있고, 구매자 상세에서 적립금 내역을 보고 지급·차감합니다. 지금까지 리뷰를 작성하면 자동으로 주던 적립금(리뷰 500원, 사진 리뷰 500원 추가)은 상점이 켜야 지급하도록 바뀝니다. 이미 지급된 적립금은 그대로 남습니다. 지난 90일에 리뷰 적립금을 지급한 상점은 홈에 안내가 보이고 소유자에게 메일을 한 번 보냅니다. 적립금
상품 수정 화면 오른쪽 컬렉션에서 이 상품이 담긴 컬렉션을 보고 담거나 뺍니다. 상품 목록에서 상품을 골라 컬렉션에 담기로 한꺼번에 붙일 수도 있습니다. 컬렉션
기본 스토어프론트 템플릿(0.2.10)에 컬렉션 화면(/collections/{주소})과 컬렉션 모음(/collections)이 생겼습니다. 대표 이미지·제목·설명 아래에 판매 중인 상품을 진열순으로 보여 주고, 구매자가 정렬을 바꿀 수 있습니다. 컬렉션
상점 관리 › 상품 › 컬렉션에서 기획전·이벤트처럼 상품을 묶어 보여 줄 수 있습니다. 상품을 검색해 담고 끌어 놓아 순서를 지정하고, 노출 여부와 시작·종료 일시를 설정합니다. 한 상품을 여러 컬렉션에 담을 수 있습니다. 컬렉션
설정 › 결제에 같은 결제수단이 PG 설정 문제로 반복해서 실패하면 경고가 뜹니다. 조합·횟수·PG 원문 사유를 보여 주고, 소유자에게 하루 한 번까지 메일로 알립니다. PG 연결하기
AI 에이전트의 승인 요청이 생기면 그 요청을 승인할 수 있는 소유자·관리자에게 메일로 알립니다. 같은 상점의 요청은 10분에 한 번 모아서 보냅니다. 설정 › 보안 › 승인 요청 메뉴 옆에 대기 건수가 보입니다. 에이전트 쓰기 승인
기본 스토어프론트 템플릿(0.2.9)이 링크에 마우스를 올리거나 포커스하면 다음 화면의 데이터를 미리 불러옵니다. 클릭한 뒤 화면이 더 빨리 열립니다. 주문서는 미리 불러오지 않습니다. 빌드한 스크립트·스타일 파일(/assets/)은 브라우저가 1년 동안 캐시해 다시 방문할 때 받지 않습니다.
플랫폼 호스팅 스토어프론트가 상점 데이터를 더 빨리 받도록 실행 위치를 조정했습니다. 새로 발행하는 버전부터 적용됩니다.
기본 스토어프론트 템플릿(0.2.8)이 상점의 PG 설정 문제로 결제창이 열리지 않은 결제수단을 「사용 불가」로 표시하고 다른 결제수단을 고르게 합니다. 구매자에게는 PG 원문 대신 「이 결제수단은 지금 사용할 수 없습니다. 다른 결제수단을 선택하십시오」가 보이고, 원문 사유는 결제 내역에서 확인합니다.

개발자

@sayren/store-sdk 0.29.7 · @sayren/storefront-sdk 0.20.7 — 쿠폰 발급 방식 DOWNLOAD·SIGNUP, 받을 수 있는 쿠폰 목록 catalog.listCoupons, 쿠폰 받기 me.downloadCoupon, 내 쿠폰의 받은 경로 source를 더했습니다. 쿠폰
@sayren/store-sdk 0.29.6 · @sayren/storefront-sdk 0.20.5 — 주문번호 orderNo, 상품주문번호 orderItemNo, 클레임번호 claimNo, 상품번호 productNo, 조합 번호 variantNo, 결제 내역 pgOrderId, 표기 함수 formatOrderNo를 더했습니다. 관리 API GET /v1/orders?orderNo=로 주문번호 조회, 스토어프론트 상품 상세는 상품번호로도 조회합니다. 주문·상품 번호
@sayren/mcp 0.23.7 — create로 받는 템플릿이 주문번호를 보여 주고 상품 주소가 상품번호인 0.2.15입니다. 상품 id 링크를 알리는 규칙 product-link(권고)를 더했습니다.
@sayren/mcp 0.23.5 — create로 받는 템플릿이 0.2.14이고 package.json에 기준 템플릿 표식(sayren.templateVersion)을 싣습니다. 편집으로 만든 버전의 templateVersion은 이 값이고, 없으면 발행 버전의 값을 이어받습니다(이전에는 그 시점 카탈로그 버전이었습니다). 템플릿으로 쇼핑몰 열기
@sayren/storefront-sdk 0.20.3 · @sayren/store-sdk 0.29.5 — 금액 미리보기의 paymentRequired, 결제 시작 option 선택화, payments.start의 pointAmount 전달(빠져 있던 것을 고쳤습니다). 결제가 필요한지는 서버와 SDK가 판단하고 스토어프론트는 고른 정보만 넘깁니다. 결제 흐름
@sayren/mcp 0.23.3 — create로 받는 템플릿이 적립금 전액 결제를 담은 0.2.12입니다.
@sayren/store-sdk 0.29.4 · @sayren/storefront-sdk 0.20.2 — 컬렉션 조건 bestSelling(판매량 상위), 정렬 BEST_SELLING, 응답의 salesComputedAt, 순수 함수 rankBestSelling을 더했습니다. 컬렉션
@sayren/store-sdk 0.29.3 · @sayren/storefront-sdk 0.20.1 — 적립금 사용 규칙(use), 주문서·금액 미리보기·결제 시작의 pointAmount, 주문의 payment.pointAmount·items[].pointAllocation, 환불의 pointRefundAmount를 더했습니다. 변경 이력
@sayren/mcp 0.23.2 — create로 받는 템플릿이 주문서 적립금 칸을 담은 0.2.11입니다.
@sayren/store-sdk 0.29.2 — 조건 자동 컬렉션(type: "AUTOMATIC", rules)과 미리보기(collections.preview), 조건 판정 함수 matchesCollectionRules를 더했습니다. 컬렉션
@sayren/store-sdk 0.29.1 — 적립금 정책(store.getPointPolicy·updatePointPolicy), 구매자 적립금 조회·지급·차감(customers.getPoints·listPointHistory·adjustPoints), 상점 전체 내역(points.listHistory), 상품 pointEarnRateBp를 더했습니다. 정책이 없으면 모든 적립이 꺼져 있습니다. 적립금
@sayren/storefront-sdk 0.20.0 — 적립금 전액 결제를 준비합니다. 주문의 결제수단을 모르는 값(POINT 등)도 읽고, 결제 시작 응답이 status: "completed"면 결제창을 열지 않고 바로 완료 결과를 돌려줍니다. payUrl·attemptId·option이 nullable이 되어 타입이 바뀝니다. 적립금 조회(catalog.getPointPolicy, member.getPoints·listPointHistory)를 더했습니다. 변경 이력
@sayren/mcp 0.23.1 — create로 받는 템플릿이 컬렉션 화면(src/routes/collections.$slug.tsx·collections.index.tsx)을 담은 0.2.10입니다. 레이아웃 설정의 사이트 안 경로에 /collections를 쓸 수 있습니다. 컬렉션
@sayren/store-sdk 0.29.0 · @sayren/storefront-sdk 0.19.0 — 컬렉션 관리 API(collections.*)와 스토어프론트 컬렉션 목록·상세·상품(catalog.listCollections·getCollection·listCollectionProducts)을 더했습니다. 컬렉션
@sayren/mcp 0.23.0 — 원격 MCP에서도 템플릿 원본(list_template_files·get_template_file)을 읽습니다. AI 도구가 고친 사이트 파일을 템플릿과 비교할 때 임시 폴더에 템플릿을 받지 않아도 됩니다. 원격 MCP
sayren 0.4.0 — npx sayren init으로 템플릿을 골라 호스팅 사이트를 만들고 소스를 바로 받습니다. 사이트가 이미 있으면 pull을 안내합니다. deploy가 올리기 전에 로컬에서 빌드(npm run build)를 확인합니다. 빌드가 실패하면 올리지 않고 출력을 보여 줍니다. 의존성을 설치하지 않은 폴더는 건너뛰고, --skip-build로 끌 수 있습니다. CLI로 호스팅 사이트 고치기
@sayren/store-sdk 0.28.3 — 결제 설정 조회의 warnings(결제수단 반복 실패 경고)를 더했습니다. 변경 이력
상점 플랫폼 시작하기와 개발자 › 스토어프론트 만들기가 설치 없는 원격 MCP(처음 연결할 때 Sayren 계정 로그인)와 npx sayren login·sayren init을 먼저 안내합니다. 액세스 토큰을 넣는 로컬 MCP는 템플릿 받기·규칙 검사 도구가 필요할 때 펼쳐 봅니다. 설치 없이 MCP 연결하기
@sayren/mcp 0.22.2 — create로 받는 템플릿이 링크 미리 불러오기(defaultPreload: "intent")를 켠 0.2.9입니다. 부수 효과가 있는 loader(주문서·주문 완료)는 라우트에서 preload: false로 끕니다. 직접 만든 loader가 데이터를 바꾸면 같은 방법으로 끄십시오. public/_headers가 해시가 붙은 빌드 파일(/assets/*)에 Cache-Control: public, max-age=31536000, immutable을 줍니다.
@sayren/storefront-sdk 0.18.4 — 결제 상태의 lastFailure.optionUnavailable과 결제 결과(FAILED)의 optionUnavailable을 더했습니다. 구매자가 고칠 수 없는 실패면 true입니다. 변경 이력
@sayren/mcp 0.22.1 · sayren 0.3.4 — 검사(verify_storefront·sayren verify)에 규칙 server-only-import를 더했습니다. 브라우저도 가져가는 파일이 *.server.ts(api.server 등)의 값을 서버 함수(createServerFn().handler) 밖에서 쓰면 오류입니다. 지금까지는 버전 빌드에서야 import 보호로 실패했습니다. create로 받는 템플릿은 결제수단 사용 불가 안내를 담은 0.2.8입니다. 디자인 수정하기

2026-10-01

상점

설정 › 상점 정보 › 사업자 정보에서 상호·대표자명·사업자등록번호·통신판매업 신고번호·사업장 주소·고객센터 전화·이메일·개인정보 보호책임자를 입력합니다. 스토어프론트 푸터에 표시되고, 비운 항목은 표시되지 않습니다.
기본 스토어프론트 템플릿이 정가를 입력한 상품에 정가 취소선과 할인율을 표시합니다.
요금제를 Free·Pro·프리미엄·엔터프라이즈 4단계로 바꿨습니다. 쇼핑몰 기능은 모든 요금제에서 쓰고, 상위 요금제는 하위 요금제 기능을 모두 포함합니다. 표시 가격은 부가세 포함이고 결제는 월 단위입니다. 베타 기간에는 지금처럼 무료입니다. 요금제와 한도
구성원은 모든 요금제에서 무료이고 인원 제한이 없습니다. 라이브 주문 수와 메일에도 한도가 없습니다.
계정당 상점은 요금제와 무관하게 3개까지입니다. 무료 상점 개수 제한은 없어졌습니다.
애널리틱스는 Pro부터입니다. 방문 데이터는 요금제와 무관하게 쌓입니다.
상점 복제가 없어졌습니다. 새 상점은 템플릿이나 빠른 시작으로 만듭니다.
관리 화면(store.sayren.io)의 이름을 상점 플랫폼으로, 화면과 문서의 「스토어」를 상점으로 바꿨습니다. 기능은 그대로입니다.

개발자

@sayren/storefront-sdk 0.18.3 — 스토어프론트 리뷰 목록에 옵션(조합)별 필터(variantId)를, 내가 쓴 리뷰 목록(reviews.listMine)과 리뷰 사진 업로드(reviews.createImageUpload)를 더했습니다. 변경 이력
sayren 0.3.3 — pull·deploy가 스토어프론트 문구 파일(messages/)을 받고 올립니다. 이전 버전으로 deploy하면 서버의 messages/가 지워지니 업데이트하십시오. verify가 상대 경로 import 대상 파일이 없는 경우를 잡습니다.
@sayren/mcp 0.22.0 — MCP 도구 upload_image를 더했습니다. 이미지 주소나 base64를 주면 상품 이미지를 올리고 공개 주소를 돌려줍니다. 로컬 MCP와 원격 MCP 모두에 있습니다. 상품 이미지 등록
@sayren/store-sdk 0.28.2 · @sayren/storefront-sdk 0.18.2 — 상점 사업자 정보(PATCH /v1/store, 스토어프론트 GET /store), 스토어프론트 상품 정가(originalPrice), 상품 문의의 상품 정보·문의 유형(category)을 더했습니다. 변경 이력
@sayren/mcp 0.21.0 — create의 --link 옵션을 없앴습니다. 저장소 안 예제에서만 쓰던 옵션이고, create는 늘 npm에 게시된 SDK 버전으로 프로젝트를 만듭니다.
@sayren/mcp 0.20.3 — create로 받는 스토어프론트 템플릿의 화면 문구가 messages/ko.json 한 곳에 모였습니다. 코드에서는 m.키()로 부르고, 언어는 ?lang= → Accept-Language 순서로 고릅니다. 지금은 한국어만 제공합니다.
@sayren/mcp 0.20.2 · sayren 0.3.2 — MCP 도구 설명·안내와 CLI 출력이 언어 설정을 따릅니다. CLI·로컬 MCP는 --lang, SAYREN_LANG, 시스템 로케일 순서로, 원격 MCP는 요청의 Accept-Language로 고릅니다. 지금은 한국어만 제공합니다.
@sayren/store-sdk 0.28.1 · @sayren/storefront-sdk 0.18.1 · @sayren/mcp 0.20.1 · sayren 0.3.1 — 설명·안내 문구의 용어를 바꿨습니다(관리 화면은 「상점 플랫폼」, 개별 상점은 「상점」). API와 타입은 바뀌지 않았습니다.
오류 응답의 message는 요청 언어를 따릅니다. 쿼리 lang이 먼저이고 다음이 Accept-Language입니다. 지금은 한국어만 제공합니다. 오류는 code로 판단하십시오.
@sayren/store-sdk 0.28.0 · @sayren/mcp 0.20.0 — 요금제 비교표 GET /v1/public/plans(plans.listPublic()), MCP 읽기 한도(aiReads)를 더했습니다. 관리 API(액세스 토큰·외부 앱)는 Pro부터입니다. 변경 이력
@sayren/store-sdk 0.27.0 이하는 새 요금제 코드 PREMIUM을 몰라 요금제 조회가 실패합니다. 0.28.0으로 올리십시오.

2026-09-30

상점

설정 › 요금제에서 현재 요금제와 이번 달 사용량(라이브 주문·AI 작업·구성원·내 도메인, 메일·편집 미리보기·빌드·관리 API 요청)을 봅니다. 베타 기간에는 모든 상점이 무료입니다. 정식 요금제는 시작 60일 전에 알려 드리고 자동으로 결제하지 않습니다. 요금제와 한도
상점을 만들어도 쇼핑몰(스토어프론트)이 함께 생기지 않습니다. 스토어프론트 공간에 들어가면 템플릿 선택 → 주소 입력 → 배포 순서로 만들고, 배포 단계와 기록을 실시간으로 봅니다. 만들기를 마칠 때까지 이 공간의 메뉴는 숨습니다. 템플릿은 만들 때만 고르고 만든 뒤에는 바꿀 수 없습니다. 템플릿으로 쇼핑몰 열기
상품 등록 화면의 상품 유형 선택이 없어졌습니다. 배송 정책 섹션 맨 위의 배송 있음/없음으로 배송이 필요한 상품과 필요 없는 상품만 가릅니다. 상품·옵션·재고 관리
배송 없는 상품은 주문 상세의 **[제공 처리]**로 제공합니다. 파일 다운로드·코드 발급·이용권·방문 수령 구분, 자동 제공, 청약철회 제한 고지, 제공 안내 메일은 없어졌습니다. 비실물 상품 판매하기
설정 › 주소록의 방문 수령지와 설정 › 상점 정보의 비실물 상품 카드가 없어졌습니다.

개발자

@sayren/store-sdk 0.24.0 · @sayren/mcp 0.17.0 — 요금제·사용량 조회 GET /v1/store/subscription(subscription.get())과 한도 오류 코드를 더했습니다. 변경 이력
@sayren/store-sdk 0.20.0 · @sayren/storefront-sdk 0.16.0 · @sayren/mcp 0.13.0
호환성 변경: 상품 유형이 SHIPPING·MANUAL 둘입니다. 코드 발급·파일 다운로드·방문 수령·청약철회 제한·제공 안내 메일 API가 없어졌습니다. 변경 이력
이미 배포한 스토어프론트가 깨지지 않도록 옛 SDK가 읽는 필드 몇 개를 고정값으로 한 릴리스 더 싣습니다. 다음 릴리스에서 빠지니 SDK를 올리십시오.
호환성 변경: 템플릿 변경 API(POST /v1/storefront/site/template)를 폐기했습니다. 항상 409 TEMPLATE_CHANGE_NOT_SUPPORTED입니다. 변경 이력

2026-09-29

상점

상품 등록 화면이 상품 유형을 먼저 고르는 구조로 바뀌었습니다. 고른 유형에 맞는 섹션(배송 정책·판매 파일·코드 제공·이용권 제공·방문 수령)만 보입니다. 상품·옵션·재고 관리
유형을 바꾸면 이전 유형에만 쓰던 입력이 초기화됩니다. 입력한 값이 있으면 초기화될 항목을 보여 주고 **[초기화하고 바꾸기]**로 확인받습니다.
판매 이력이 있는 상품은 유형이 잠깁니다. 다른 유형으로 팔려면 새 상품으로 등록하십시오.
청약철회 제한은 환불 정책 섹션에서 켭니다(파일 다운로드·코드 발급).
주문 뒤 상품을 고쳐도 이미 들어온 주문의 다운로드 횟수·반품지·방문 수령지·환불 정책은 주문 시점 값 그대로입니다.

개발자

@sayren/store-sdk 0.18.0 · @sayren/storefront-sdk 0.15.0 · @sayren/mcp 0.9.0
호환성 변경: 상품의 유형과 속성을 fulfillment 하나로 모았습니다. 옛 평면 필드는 요청에서 400입니다. 변경 이력
호환성 변경: 주문 상품과 웹훅의 유형 필드가 fulfillmentSnapshot으로 바뀌었습니다. 변경 이력
호환성 변경: 스토어프론트 상품·장바구니·주문서의 유형 필드가 fulfillment로 바뀌었습니다. 변경 이력

2026-09-28

상점

배송이 없는 상품을 팔 수 있습니다. 상품 유형으로 파일 다운로드·코드 발급·이용권·방문 수령을 고르면 주문서가 배송지를 묻지 않고, 결제와 함께 자동으로 제공하거나 주문 상세의 **[제공 처리]**로 제공합니다. 제공하면 구매자에게 안내 메일이 갑니다. 비실물 상품 판매하기
파일 다운로드·코드 발급 상품은 청약철회 제한을 켤 수 있습니다. 주문서에서 고지와 동의를 받고, 첫 다운로드·열람 뒤에는 구매자의 단순 변심 취소·반품을 받지 않습니다. 고지 문구는 설정 › 상점 정보에서 바꿉니다.

개발자

@sayren/store-sdk 0.17.0 · @sayren/storefront-sdk 0.14.0 · @sayren/mcp 0.8.0
추가: 비실물 상품 API(제공 처리·코드 발급·판매 파일·코드 열람·다운로드)와 웹훅 ORDER.FULFILLED. 변경 이력
변경: 청약철회 제한 상품이 든 주문은 결제 시작에 withdrawalAgreement: true가 필요합니다.
추가: 웹훅 본문에 리소스별 순번 sequence가 실립니다. 웹훅은 도착 순서를 보장하지 않으니 같은 주문의 이벤트는 이 값으로 정렬하십시오. 웹훅

2026-09-27 (8차)

상점

판매자 취소를 웹훅으로 받을 수 있습니다. 개발자 › 이벤트 › 웹훅에서 판매자 취소 이벤트를 고르십시오. 웹훅

개발자

@sayren/storefront-sdk 0.13.0 · @sayren/store-sdk 0.16.0 · @sayren/mcp 0.6.1
추가: 웹훅 이벤트 ORDER.CANCELED(판매자 취소, 취소 수량·환불액 포함)
변경: 비회원 주문 조회는 주문번호마다 시도 한도가 있습니다. 여러 번 틀리면 30분 동안 429입니다. 틀린 연락처·비밀번호는 주문이 없을 때와 같은 404입니다. 비회원 주문 조회 비밀번호는 128자까지입니다.
변경: MCP 스토어프론트 템플릿의 화면 탭 제목이 {화면} | {상점 이름}입니다.

2026-09-27 (7차)

상점

문서를 현재 화면에 맞게 정리했습니다. 상점 플랫폼 작업마다 메뉴 경로를 첫 줄에 적었습니다.
주문 상세의 **[발송처리]**는 발주확인한 상품에만 보입니다.

개발자

@sayren/storefront-sdk 0.12.0 · @sayren/store-sdk 0.15.1 · @sayren/mcp 0.5.2
추가: 스토어프론트 SDK ApiError.docs(해결 문서 주소)
변경: MCP 스토어프론트 토큰 권한은 store:r·product:r이면 충분합니다.

2026-09-27 (6차)

상점

상점 양도는 받는 사람이 수락해야 완료됩니다. 소유자가 설정 › 상점 정보에서 양도를 요청하면 받는 사람에게 메일과 상점 플랫폼 알림이 가고, 받는 사람이 수락하거나 거절합니다. 요청은 7일 뒤 만료되며 소유자가 취소할 수 있습니다. 상점 복제·이전
발송한 주문의 배송 추적이 켜졌습니다. CJ대한통운·롯데·한진·우체국·로젠 송장을 조회하고, 택배사가 배송완료로 알려 오면 자동으로 배송완료 처리합니다.
결제 설정의 연결 테스트 이력이 없으면 「-」로 표시합니다.

2026-09-27 (5차)

상점

구성원 초대: 설정 › 구성원에서 이메일로 구성원을 초대하고, 대기 중인 초대를 재발송·취소할 수 있습니다. 관리자 초대는 소유자만 할 수 있습니다. 구성원 관리
초대받은 사람은 메일의 링크로 로그인해 수락합니다. 초대받은 이메일과 같은 계정이어야 하며, 최근 10분 안에 로그인한 상태여야 합니다.
초대 메일은 받는 주소당 하루 5통, 상점당 시간당 20통까지 발송합니다.

개발자

@sayren/store-sdk 0.15.0
추가: 초대 응답의 발송 상태(deliveryStatus 등), 재발송 POST /v1/store/invitations/{invitationId}/resend, SDK invite·resendInvitation·cancelInvitation·updateMemberRole·removeMember
호환성 변경: 관리자는 다른 관리자의 역할을 바꾸거나 내보낼 수 없습니다. 역할이 없는 토큰(PAT·M2M)은 관리자를 지정할 수 없습니다. 초대 목록의 status에 허용되지 않는 값을 주면 400입니다.

2026-09-27 (4차)

상점

상점 플랫폼·문서·결제 화면의 문구를 격식체(하십시오체)로 통일했습니다.

개발자

@sayren/store-sdk 0.14.1 · @sayren/storefront-sdk 0.11.1 · @sayren/mcp 0.5.1
변경: API 에러 응답의 message와 SDK 오류 메시지 문구가 격식체로 바뀌었습니다. code는 그대로이므로 오류 판별은 code로 하십시오.
MCP 스토어프론트 템플릿의 구매자 화면 문구도 격식체로 바뀌었습니다.

2026-09-27 (3차)

상점

상점 복제: 만들어 둔 상점의 설정·카테고리·주소록·상품을 골라 새 상점으로 복제합니다. 결제·로그인 키, 토큰, 구성원, 주문·구매자는 복제되지 않습니다. 상점 복제·이전
상점 양도: 설정 › 상점 정보에서 구성원에게 소유권을 넘기고, 넘긴 뒤 관리자로 남을지 나갈지 고를 수 있습니다.
상점 폐쇄를 상점 플랫폼에서 할 수 있습니다(소유자만).
상점 선택 화면에서 상점별 주문·처리할 일·결제 연결·최근 오류를 한눈에 볼 수 있습니다.

2026-09-27 (2차)

상점

AI 에이전트(MCP)가 취소·환불·가격·할인 같은 중요한 작업을 요청하면 승인 대기가 됩니다. 설정 › 보안 › 승인 요청에서 확인하고 승인·거절합니다.
결제 설정·토큰 발급·구성원 변경은 에이전트가 할 수 없습니다.
누가(사람·에이전트·앱·토큰) 무엇을 바꿨는지 감사 로그로 볼 수 있습니다(설정 › 보안 › 감사 로그).
API 토큰을 만들 때 AI 에이전트(MCP)용을 고를 수 있습니다. 시작하기에서 만든 MCP 토큰은 에이전트용입니다.

개발자

@sayren/store-sdk 0.14.0 · @sayren/mcp 0.5.0
추가: 감사 로그 GET /v1/audit-logs(스코프 audit:r), 승인 요청 API, 토큰 agent 플래그
추가: 에이전트 요청은 고위험 작업에 202 APPROVAL_REQUIRED로 보류됩니다. SDK는 ApprovalPendingError를 던집니다. 헤더 x-sayren-dry-run: 1로 실행 없이 영향만 미리 볼 수 있습니다. AI 작업 승인과 감사 로그
MCP call_api_write에 dryRun, 새 도구 get_approval_request

2026-09-27

상점

문서의 시작하기·결제·클레임·주문 처리 안내를 지금 화면과 동작에 맞게 고쳤습니다.
"주문 취소", "결제 연결", "현금영수증", "전송 실패"로 검색하면 해당 문서가 나옵니다.

개발자

@sayren/store-sdk 0.13.0 · @sayren/mcp 0.4.0
MCP verify_storefront 검사 결과(규칙별 통과·위반 수)를 sayren에 보내 검사 품질을 개선합니다. 파일 경로·소스는 보내지 않고 SAYREN_TELEMETRY=0으로 끌 수 있습니다. MCP 도구

2026-09-26 (3차)

상점

웹훅 전송 기록 상세에서 실패 원인(DNS·TLS·시간 초과·HTTP 오류 등)과 조치 방법을 보여 줍니다. 보낸 본문·헤더·받은 응답도 복사할 수 있습니다.
전송 기록을 이벤트 종류·리소스 ID로 찾고, 전송 기록과 API 로그를 서로 오갈 수 있습니다.
에러 메시지에 해결 방법 문서 링크가 붙습니다.

개발자

@sayren/store-sdk 0.12.0 · @sayren/mcp 0.3.0
추가: 에러 응답 error.docs(해결 문서 주소, SDK ApiError.docs)
추가: 웹훅 전송 기록 failureReason·resource, 상세 GET /v1/webhooks/{id}/deliveries/{deliveryId}(SDK webhooks.getDelivery), 목록 필터 eventType·resourceId. 웹훅
추가: API 로그 traceId 필터(에러 응답의 error.traceId로 그 요청을 찾습니다). API 로그
변경: 웹훅 응답 본문 발췌가 4,096자로 늘고, 토큰·비밀 값으로 보이는 키는 가려서 저장합니다.
MCP verify_storefront가 위반마다 고칠 파일·줄, 수정 방법, 예시 코드, 관련 문서를 알려 줍니다. MCP 도구

2026-09-26 (2차)

상점

배송비 규칙을 상점에서 정합니다. 기본 배송비, N원 이상 무료, 제주·도서산간 추가 배송비(설정 › 배송).
같은 출고지·같은 배송 정책의 상품은 묶음배송으로 배송비를 한 번만 받습니다.
출고지·반품지 주소록을 관리하고 상품마다 지정할 수 있습니다(설정 › 주소록). 반품·교환 안내에 반품지가 나갑니다.
계좌이체·가상계좌 결제에 현금영수증이 자동 발급되고, 환불하면 그만큼 취소됩니다. 주문 상세에서 재발급할 수 있습니다.
주문 상세에 배송 추적 카드가 생겼습니다. 추적 서비스를 연결하면 배송완료가 자동으로 반영됩니다(연결 준비 중).

개발자

@sayren/store-sdk 0.11.0 · @sayren/storefront-sdk 0.11.0 · @sayren/mcp 0.2.3
호환성 변경: 배송비는 배송 묶음(같은 출고지 + 같은 배송 정책)마다 붙습니다. 상품 deliveryFee를 생략하면 상점 기본 배송비입니다.
호환성 변경: 결제 금액은 결제 시작 응답의 amounts로 확정됩니다(배송지에 따라 추가 배송비). 미리 보려면 checkout.quoteDelivery(). 배송비와 출고지·반품지
추가: 결제 시작의 cashReceipt(계좌이체·가상계좌), 주문 상세 payment.cashReceipt
추가: 주소록 API /v1/seller-addresses, 상점 shippingPolicy
추가: 배송 조회 응답의 추적 단계(trackingStage)와 이벤트별 stage

2026-09-26

상점

발송한 주문을 배송완료로 처리할 수 있습니다. 발송 7일 뒤 자동 배송완료, 배송완료 7일 뒤 자동 구매확정도 됩니다(설정 › 상점 정보에서 일수 변경).
상품 등록에서 이미지를 바로 올릴 수 있습니다. 끌어다 놓기, 순서 변경, 대표 이미지 지정이 됩니다.
환불 정책을 정할 수 있습니다. 상점 기본값을 두고 상품마다 다르게 둘 수도 있습니다(반품·교환 배송비, 발송 전 취소 시 배송비 환불 등).
주문 상품을 수량 단위로 부분 취소할 수 있습니다. 환불 금액과 재고가 수량만큼 계산됩니다.
교환하면 재고가 자동으로 맞춰집니다. 수거 완료 때 원래 옵션을 돌려놓고, 재배송 때 새 옵션을 뺍니다.
약관 버전과 주소를 관리할 수 있습니다. 버전을 올리면 구매자에게 다시 동의를 받습니다(상점 소유자만 변경).
구매자 상세에서 동의 이력(약관·개인정보·마케팅)을 볼 수 있습니다.

개발자

@sayren/store-sdk 0.10.0 · @sayren/storefront-sdk 0.10.0 · @sayren/mcp 0.2.2
호환성 변경: 상품 이미지는 POST /v1/uploads로 올립니다. POST /v1/product-images는 없어졌습니다. 상품 이미지
호환성 변경: 스토어프론트 thumbnailUrl은 이미지가 없으면 null입니다.
추가: 배송완료 API(POST /v1/order-items/{id}/delivered), 클레임·직권취소 수량(quantity), 환불 정책(refundPolicy)
추가: 클레임 응답·웹훅에 환불액과 배송비 환불·차감액이 따로 실립니다.
추가: 구매자 동의 API(/storefront/v1/me/consents)와 재동의 필요 표시(GET /me의 reconsentRequired). 구매자 인증
변경: 소셜 가입 동의는 auth.idp(provider, { agreements })로 보냅니다.

2026-09-25

상점

결제창이 sayren 결제 화면(payments.sayren.io)에서 열립니다. PC는 팝업, 모바일은 페이지 이동입니다.
간편결제(네이버페이·카카오페이·토스페이·페이코)를 PG마다 켤 수 있습니다.
구매자가 결제수단을 직접 고릅니다. PG 자동 전환은 없어졌습니다.
결제 도메인을 등록하면 그 주소로만 결제가 돌아옵니다(선택 사항, 비워 두면 모든 https 주소 허용).
주문·결제 내역에 간편결제사가 보입니다.

개발자

호환성 변경: 결제는 결제 시작 응답의 payUrl을 열어 진행합니다. SDK는 payments.start(), 복귀 화면은 payments.result()입니다. 결제 연동
호환성 변경: 공개 결제 승인(POST /payments/{id}/confirm)이 없어졌습니다. 승인은 결제 화면이 합니다.
추가: 주문서 응답의 결제 옵션(paymentOptions), 결제 상태의 결과 구분(result)·실패 사유(lastFailure)
SDK 없이도 연동할 수 있습니다: payUrl 열기 → 팝업 메시지 또는 복귀 주소 → 결제 상태 조회. SDK 없이 결제 연동

2026-09-24

상점

시작하기 화면으로 첫 상점 설정을 안내합니다.
구매자 소셜 로그인(카카오·네이버·구글)을 켤 수 있습니다.
구매자 관리 화면에서 구매자 목록·상세·구매 통계를 보고 탈퇴를 처리할 수 있습니다.
비회원 주문을 끄고 회원만 주문받게 할 수 있습니다.
방문 분석에서 방문·유입·상품·검색·결제 퍼널을 볼 수 있습니다.

개발자

구매자 인증 SDK @sayren/storefront-sdk/auth(로그인·가입·소셜·익명 세션·탈퇴)
방문 분석 SDK @sayren/storefront-sdk/analytics
MCP 스토어프론트 템플릿이 TanStack Router(SSR) 기반으로 바뀌었습니다.

이 페이지 목차