Stripe Connect는 Atoms Backend에 통합된 결제 엔진입니다. 단 한 번의 설정 과정으로, 자체 결제 인프라를 유지 관리할 필요 없이 상품 판매, 구독 운영, 카드 결제 수락 및 결제 상태 추적이 가능합니다.
Stripe Connect란 무엇인가요?
Stripe Connect를 귀하의 Atoms 앱과 글로벌 결제 네트워크를 연결하는 '다리'라고 생각하세요.
개발자용
PCI 규정 준수나 은행 연동을 직접 처리할 필요 없음
서버 측 결제 코드 작성 불필요
간편한 API 및 대시보드 제어
비즈니스용
일회성 구매 및 정기 구독 지원
인보이스, 환불, 영수증 기능 내장
거래 및 지급(Payout) 상태에 대한 완전한 가시성 제공
언제 Stripe Connect를 사용해야 하나요?
Stripe Connect는 다음과 같이 내장 결제 방식이 필요한 앱에 권장됩니다.
SaaS 구독 (월간, 연간 요금제)
디지털 상품 (강의, 템플릿, 에셋 팩)
유료 커뮤니티 (비공개 콘텐츠, 멤버십 권한)
이커머스 (장바구니, 결제 페이지)
비즈니스 모델에 어떤 형태든 유료 결제 흐름이 포함되어 있다면, Stripe Connect가 가장 빠르게 시작할 수 있는 방법입니다.
Stripe Connect 사용 방법
중요 Stripe Connect는 Atoms Backend가 필요합니다. 프로젝트를 생성할 때 Backend mode(백엔드 모드)가 반드시 활성화(ON)되어 있어야 합니다. 기존 프로젝트에는 나중에 이 모드를 활성화할 수 없습니다.
세 가지 방법으로 Stripe를 연결할 수 있습니다.
방법 1: 프로젝트 생성 시 (권장)
워크스페이스에서 New Project(새 프로젝트)를 클릭합니다.
Atoms Backend 토글을 ON으로 전환합니다.
왼쪽 사이드바에서 +를 클릭합니다.
Connect Stripe Account(Stripe 계정 연결)를 선택합니다.
아직 Stripe 계정이 없다면, 아래의 'Stripe 계정 만들기' 단계를 따르세요.
방법 2: 통합(Integrations) 패널에서
기존 Backend 프로젝트의 경우:
프로젝트의 Chat(채팅) 뷰를 엽니다.
우측 상단의 Integrations(통합)를 클릭합니다.
Stripe를 찾아 Connect(연결)를 클릭합니다.
방법 3: 에이전트에게 요청하기
자연어를 통해 설정을 트리거할 수도 있습니다.
채팅에서 에이전트에게 "I want to add payments(결제 기능을 추가하고 싶어)" 또는 "I want to sell a product(상품을 팔고 싶어)"라고 말합니다.
에이전트가 Connect Stripe 버튼을 띄워줍니다.
클릭하여 확인하고 안내 단계를 따릅니다.
상품 목록 관리
Stripe 연결 후에는 Atoms 내에서 직접 상품을 관리합니다.
상품 동기화 (Sync Products)
Settings(설정) → Integrations(통합) → Stripe Details(Stripe 상세)로 이동합니다.
Product Catalog(상품 목록)를 찾습니다.
Sync(동기화)를 클릭하여 Stripe에서 최신 상품 정보를 가져옵니다.
이 필드들은 Atoms가 상품을 인식하고 앱에 표시할 수 있게 해줍니다. Stripe의 각 상품에 상품명, 가격, 통화, 청구 유형(정기 또는 일회성)이 포함되어 있는지 확인하세요.
Stripe 계정 만들기
Stripe가 처음이라면 다음 단계를 완료하세요.
1단계: 등록
stripe.com을 방문하여 Get Started를 클릭합니다.법적 이름, 국가, 이메일을 입력합니다.
온보딩(등록) 절차를 따릅니다.
신원 확인을 위해 정확한 정보가 필요합니다.
2단계: 비즈니스 프로필
고객에게 비즈니스가 어떻게 보일지 설정합니다.
명세서 표기명 (Statement Descriptor) 고객의 은행 명세서에 표시되는 이름입니다. 지불 거절(Chargebacks)을 줄이려면 인식하기 쉬운 이름을 사용하세요.
비즈니스 유형 (Business Type)
Individual(개인): 프리랜서 또는 1인 크리에이터
Company(기업): 등록된 법인
3단계: 확인 및 지급
Stripe에서 다음 정보를 요청합니다.
개인 신원 문서
지급받을 은행 계좌
비즈니스 세부 정보
예상 소요 시간
계정 설정: 약 15~20분
확인(심사): 즉시 ~ 영업일 기준 1~7일
지급 가능 시기: 자금은 보통 결제 후 7일 뒤에 지급됩니다.
첫 지급: 보안 검토로 인해 2~3일이 추가로 소요될 수 있습니다.
예: 11월 20일에 받은 결제 대금은 11월 27일에 이용 가능합니다.
자주 묻는 질문 (FAQ)
1. 테스트 모드(Test Mode)를 사용할 수 있나요?
네, 가능합니다. Stripe 대시보드에서 Test Mode를 선택하세요. Stripe의 테스트 카드(예: 4242 4242 4242 4242)를 사용하여 실제 결제 없이 구매를 완료할 수 있습니다. 정식 출시(Launch)할 때만 Live Mode(라이브 모드)로 전환하세요.
2. 제 Stripe 계정이 왜 거절되었나요?
Stripe 대시보드에서 사유를 확인하세요. 흔한 원인은 다음과 같습니다.
불완전한 개인 정보
불명확한 비즈니스 설명
비어 있거나 접속 불가능한 웹사이트 링크
제한된 상품 또는 서비스
필요한 정보를 업데이트하고 신청서를 다시 제출(Resubmit) 하여 문제를 해결할 수 있습니다.