Proyecta Commerce 시작하기

모든 Proyecta 앱을 위한 내장 결제 기능. Admin > Commerce에서 Stripe를 연결한 후 구독, 일회성 상품 등 다양한 방식으로 판매를 시작하세요.

Proyecta Commerce는 builder를 벗어나지 않고도 모든 앱에 실제 결제 시스템을 제공합니다.

Commerce는 Proyecta의 플랫폼 기능(capability) 중 하나입니다. 별도의 데이터베이스를 가진 독립적인 사일로에 존재하는 것이 아니라, 앱의 나머지 부분과 유기적으로 결합됩니다. 스토어프론트(실물 또는 디지털 상품)의 경우, 카탈로그는 콘텐츠입니다. 판매하는 상품은 Proyecta의 CMS — 단일 영구 데이터 저장소 — 에 저장되므로, 이름, 가격, 사진을 일반 콘텐츠처럼 편집할 수 있으며 게시된 각 항목은 자동으로 실제 구매 가능한 상품이 됩니다. **구독, 플랜, 기능 권한(entitlement)**은 Admin > Commerce에서 직접 정의합니다. 어떤 방식이든 결제, 주문, 정산은 항상 Commerce + Stripe Connect를 통해 처리되며, 구매자에게 표시되는 가격과 실제 청구 금액은 하나의 소스에서 나오므로 불일치가 발생할 수 없습니다. 카탈로그-콘텐츠 모델에 대한 자세한 내용은 콘텐츠 관리를 참고하세요.

대시보드 > Commerce를 열면 6개의 최상위 탭이 있습니다:

탭	용도
Products	판매하는 항목(구독, 일회성, 무료) — Features 및 Coupons 서브탭 포함
Customers	앱의 청구 가능한 사용자
Subscriptions	활성 정기 구독 추적
Payments	성공한 청구, 환불, 분쟁
Payouts	수익 정산 및 지급 추적
Settings	Stripe 계정 연결(결제 계정 설정)

1단계: Stripe 연결

Commerce는 내부적으로 Stripe Connect를 사용합니다. 기존 Stripe 계정이 없어도 되지만, Stripe 온보딩 절차를 한 번 거쳐야 합니다.

Admin > Commerce를 열고 Settings 탭으로 이동
Connect Stripe 클릭
드롭다운에서 Country 선택
Create Account 클릭
Complete Setup을 클릭하여 패널 내 임베디드 Stripe 온보딩 열기
사업자 정보, 은행 정보, 인증 서류 입력
완료 후 결제 계정 상태가 onboarding → active로 변경됩니다

지원 국가

Proyecta Commerce는 Stripe Connect를 사용합니다. Stripe Connect가 지원되는 모든 국가를 사용할 수 있습니다. 최신 전체 목록은 Stripe 지원 국가 목록을 확인하세요.

해당 국가에서 온보딩 중 문제가 발생하면 고객 지원팀에 문의하세요.

글로벌 사용 가능 지역

현재 Stripe는 다음 국가/지역에서 지원되며, 앞으로 더 추가될 예정입니다. 해당 국가/지역에서 Stripe가 지원되면 전 세계 고객에게 판매할 수 있습니다.

🇦🇺 호주 🇦🇹 오스트리아 🇧🇪 벨기에 🇧🇷 브라질 🇧🇬 불가리아 🇨🇦 캐나다 🇨🇮 코트디부아르 확장 네트워크 🇭🇷 크로아티아 🇨🇾 키프로스 🇨🇿 체코 공화국 🇩🇰 덴마크 🇪🇪 에스토니아 🇫🇮 핀란드 🇫🇷 프랑스 🇩🇪 독일 🇬🇭 가나 확장 네트워크 🇬🇮 지브롤터 🇬🇷 그리스 🇭🇰 홍콩 🇭🇺 헝가리 🇮🇳 인도 Preview 🇮🇩 인도네시아 Preview 🇮🇪 아일랜드 🇮🇹 이탈리아 🇯🇵 일본 🇰🇪 케냐 확장 네트워크 🇱🇻 라트비아 🇱🇮 리히텐슈타인 🇱🇹 리투아니아 🇱🇺 룩셈부르크 🇲🇾 말레이시아 🇲🇹 몰타 🇲🇽 멕시코 🇳🇱 네덜란드 🇳🇿 뉴질랜드 🇳🇬 나이지리아 확장 네트워크 🇳🇴 노르웨이 🇵🇱 폴란드 🇵🇹 포르투갈 🇷🇴 루마니아 🇸🇬 싱가포르 🇸🇰 슬로바키아 🇸🇮 슬로베니아 🇿🇦 남아프리카 공화국 확장 네트워크 🇪🇸 스페인 🇸🇪 스웨덴 🇨🇭 스위스 🇹🇭 태국 🇦🇪 아랍에미리트 🇬🇧 영국 🇺🇸 미국

2단계: 판매할 항목 추가

판매 항목을 구성하는 두 가지 방법이 있으며, Proyecta가 적합한 방식을 자동으로 선택합니다.

**구독, 플랜, 권한(entitlement)**은 Commerce에서 관리합니다. 결제 계정이 active 상태가 되면 Products 탭으로 이동하여 상품을 생성하세요. 모든 상품에는 최소 하나의 variant(가격 티어)가 있으며, 다음 정보를 포함합니다:

최소 화폐 단위(예: 센트)로 표시된 가격
통화 (USD, EUR, GBP 등 — 130개 이상 지원)
일회성 가격 또는 정기 청구 주기(주, 월, 연)
구매 시 권한을 부여하는 선택적 기능(features) (상품 및 기능 참고)

패널에서 직접 생성하거나 AI에게 요청할 수 있습니다: "Create a Pro plan at $29/month and a Business plan at $99/month."

스토어프론트 카탈로그(사진과 가격이 있는 상품)는 콘텐츠로 관리됩니다. Proyecta에 카드 결제가 가능한 스토어 구축을 요청하면, CMS에서 카탈로그를 판매 가능한 컬렉션으로 모델링합니다. 관리자 패널에서 각 항목(이름, 가격, 사진)을 일반 콘텐츠처럼 편집하면, 항목을 게시하는 순간 자동으로 Commerce에 실제 구매 가능한 상품으로 등록됩니다. 콘텐츠 필드의 가격이 그대로 복사되며, Stripe나 결제 연동을 수동으로 설정할 필요가 없습니다. 자세한 내용은 상품 및 기능과 콘텐츠 관리를 참고하세요.

3단계: 앱에 결제 연동

앱 코드에서 직접 결제 세션을 시작하고 권한을 확인할 수 있습니다. 코드 예제는 앱에 통합하기를 참고하세요.

기본 제공 기능

KYC, 인증, 은행 계좌 설정이 포함된 Stripe Connect 온보딩
상품 variant — 일회성, 정기, 무료
쿠폰 — 비율 또는 고정 할인, 1회/반복/영구 적용, 사용 한도, 만료일 설정
고객 — 앱의 청구 가능한 사용자
환불 지원이 포함된 거래(Transactions)
기능(Features) — 여러 상품에 연결할 수 있는 재사용 가능한 권한(entitlement)

아직 개발 중인 기능

더미 카드가 포함된 테스트 모드 토글
명세서 설명 설정 UI
고객 청구 포털
Stripe 온보딩 이후의 규정 준수 대시보드
커머스 관련 문의를 위한 builder 내 지원 수신함

요금제

Proyecta Commerce는 내부적으로 Stripe를 사용합니다. Stripe의 표준 처리 수수료는 사용자가 부담합니다. Proyecta Commerce는 각 거래에 Stripe 표준 처리 수수료 외에 2%의 플랫폼 수수료를 부과합니다. (플랫폼 수수료는 Stripe가 허용하지 않는 국가 — 현재 멕시코 — 의 연결 계정에는 면제되며, 해당 계정은 Stripe 수수료만 부담합니다.)