Stripe 커넥터

Stripe 계정을 Tajo에 연결하면 결제 데이터(고객, 청구, 구독, 인보이스)를 읽기 전용으로 동기화해 연락처 확인, 세그먼테이션, 매출 기반 자동화(Brevo 및 기타 인게이지먼트 제공업체를 통해)에 활용할 수 있습니다.

개요

속성	값
인증	Stripe 시크릿 키(`sk_live_...` / `sk_test_...`) 또는 제한 키
접근 권한	읽기 전용. Tajo는 Stripe 계정에 절대 쓰지 않습니다
기본 API	`https://api.stripe.com/v1`
동기화 방향	Stripe → Tajo
실시간 웹훅	아직 지원하지 않습니다. 현재 동기화는 폴링 방식입니다

Stripe 대시보드에서 Developers → API keys를 엽니다.
제한 키를 생성합니다. Customers, Charges, Subscriptions, Invoices에 대한 읽기 권한이면 충분합니다. 전체 시크릿 키보다 제한 키를 강력히 권장합니다. Tajo는 읽기만 하므로 읽기 권한만 부여하세요.
생성한 키를 Tajo의 Stripe 연결에 붙여넣습니다.

동기화가 시작되기 전에 읽기 전용 요청으로 연결을 검증합니다. 언제든지 Stripe에서 키를 교체하거나 취소할 수 있습니다.

데이터	Tajo가 하는 일
고객	신원 확인과 세그먼테이션을 위해 연락처(이메일, 이름, 전화번호, 주소)로 정리됩니다. 고객 레코드가 존재한다는 사실만으로 동의를 추론하지 않습니다.
청구	구매 기반 라이프사이클 자동화와 LTV 세그먼테이션에 사용하는 매출 이벤트
구독	미납 안내, 윈백, 리텐션 플로우를 위한 라이프사이클 상태(active, past_due, canceled…)
인보이스	청구 관련 메시지를 위한 결제 상태

페이지네이션은 Stripe의 커서 모델(starting_after)을 사용하므로, 대규모 계정도 빠짐없이 그리고 중단된 지점부터 이어서 동기화됩니다.

계획을 세울 수 있도록 있는 그대로 밝힙니다.

아직 실시간 웹훅이 없습니다. 변경 사항은 결제가 성공하는 순간이 아니라 동기화 일정에 따라 도착합니다. 웹훅 수신은 로드맵에 있습니다.
읽기 전용입니다. Tajo는 Stripe에서 고객, 결제, 구독을 생성하거나 수정하지 않습니다.
Stripe App이 없습니다. 현재 Stripe App Marketplace에는 Tajo 앱이 없으며, 연결은 Stripe 대시보드가 아니라 Tajo에서 설정합니다.

증상	원인 및 해결
Stripe에서 401 응답	키가 취소되었거나 교체되었습니다. 현재 키를 연결에 붙여넣으세요
고객은 동기화되지만 청구는 되지 않음	제한 키에 Charges 읽기 권한이 없습니다
연락처에 이메일이 없음	이메일이 없는 Stripe 고객은 익명 매출 레코드로 동기화되며, 나중에 이메일이 추가되면 연락처 그래프에 합류합니다