> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 모바일 커머스

워크스페이스의 스토어 상품과 주문을 관리합니다.

## 상품

/api/mobile/commerce/products의 GET과 POST는 상품을 나열하고 생성합니다 — owner와 admin만 가능합니다. 새 상품은 draft로 시작하고, 가격은 문자열로 입력되어 소수점 두 자리 정밀도의 센트로 저장되며, 재고 추적은 선택 사항입니다. 상품은 절대 삭제되지 않습니다. archived가 제거 상태이고, PATCH는 필드와 상태(draft, active, archived)를 함께 업데이트합니다.


## 주문은 앞으로만 진행됩니다

GET /api/mobile/commerce/orders는 주문을 나열합니다. 주문은 스토어 체크아웃이 만들며 앱이 만들지 않습니다. PATCH는 상태를 앞으로만 진행시킵니다 — pending에서 paid로, fulfilled로 — 결제 전에는 cancelled, 결제 후에는 refunded가 허용됩니다. 취소는 같은 트랜잭션에서 추적된 재고를 복원하고, 허용되지 않는 전이는 사용자가 닫아야 할 오류가 아니라 조용한 no-op입니다.


## 검증 및 문제 해결

공개 체크아웃으로 판매하고, 모바일에서 주문을 진행하고, pending 주문이 취소될 때 재고가 돌아오는지 확인하세요. admin 미만 멤버는 이 표면에 아예 도달할 수 없습니다 — 빈 화면이 아니라 사용할 수 없음으로 보이는지 확인하세요.


## 다음

[개발자 도구](https://supastack.dev/ko/docs/mobile/developers.md)