Tajo 사전 이용 신청

이름과 이메일 주소 또는 전화번호를 입력해 주세요. Tajo 이용 방법을 안내해 드립니다.

이 페이지에서

Stripe Apps 연동 가이드

Stripe Apps를 사용하면 Stripe 대시보드에 직접 맞춤 기능을 삽입할 수 있습니다. 이 섹션은 구축 가이드입니다. Tajo와 Brevo 연동을 위한 앱을 어떻게 만들고, 테스트하고, 게시하는지 설명합니다.

Caution

상태: 아직 게시되지 않음. 현재 Stripe App Marketplace에는 Tajo 앱이 없으며, 이 문서에 나오는 앱 식별자, URL, 자격 증명은 실제로 동작하는 엔드포인트가 아니라 예시용 자리표시자입니다. 지금 바로 Stripe를 Tajo에 연결하려면 Stripe 커넥터(제한 API 키, 읽기 전용 동기화)를 사용하세요.

Tip

목표는 Stripe App Marketplace에 Brevo 연동을 게시해, Stripe 판매자가 고객 데이터, 주문, 이벤트를 Brevo로 직접 동기화하여 마케팅 자동화와 CRM에 활용하도록 하는 것입니다.

Stripe Apps란 무엇인가요?

Stripe Apps는 맞춤 UI 컴포넌트와 백엔드 연동으로 Stripe 대시보드를 확장합니다. 서드파티 개발자는 이를 통해 다음을 할 수 있습니다.

Stripe 대시보드 페이지(고객, 결제, 인보이스 등)에 맞춤 화면 추가
범위가 지정된 권한으로 Stripe 데이터에 접근
Stripe와 Brevo 같은 외부 플랫폼 사이의 데이터 동기화
대시보드 안에서 온보딩 및 설정 흐름 제공

Tajo + Brevo 연동 목표

Tajo Stripe App은 Stripe와 Brevo를 연결해 다음을 제공합니다.

고객 인텔리전스: Stripe 고객 프로필, 결제 이력, 생애 가치를 Brevo 연락처로 동기화
이벤트 추적: Stripe 이벤트(결제, 구독, 환불)를 Brevo 트랜잭션 이벤트로 전송
자동화된 캠페인: Stripe 활동을 기준으로 Brevo 이메일, SMS, WhatsApp 캠페인 실행
로열티 프로그램: Brevo로 동기화된 Stripe 구매 데이터로 리텐션 워크플로 구축

아키텍처 개요

Stripe 앱의 데이터가 흘러가는 경로

가이드 구성

이 문서는 Stripe App을 만들고 게시하는 전체 과정을 다룹니다.

시작하기

가이드	설명
마켓플레이스에 게시하기	앱 심사를 신청하기 위한 요건과 절차
앱 심사 요건	승인을 위한 품질, 보안, UX 기준

설정 및 레퍼런스

가이드	설명
앱 매니페스트 레퍼런스	`stripe-app.json` 매니페스트 파일의 전체 스키마
권한 레퍼런스	Stripe API 권한 전체 목록과 요청 방법
뷰포트 레퍼런스	앱 UI가 표시될 수 있는 대시보드 위치

기능 및 연동

가이드	설명
임베디드 Stripe Apps	플랫폼 연동을 위한 Connect 임베디드 컴포넌트 사용법
설치 링크와 딥 링크	설치 URL 생성 및 특정 앱 화면으로의 딥 링크
설치 후 동작	앱 설치 이후의 온보딩 흐름 설정

운영 및 성장

가이드	설명
앱 분석	설치 수, 조회 수, 전환 지표 추적
파트너 생태계	Stripe 파트너 프로그램을 활용한 공동 마케팅과 성장

사전 준비 사항

Stripe App을 만들기 전에 다음을 갖추었는지 확인하세요.

Stripe 계정: 활성화된 Stripe 계정 (테스트 모드로 제한되지 않은 계정)
Stripe CLI: 로컬 개발과 앱 업로드를 위한 Stripe CLI 설치
Node.js: 앱 UI 확장을 위한 16 버전 이상
Tajo 플랫폼 이용 권한: Brevo API 자격 증명이 설정된 활성 Tajo 계정

빠른 시작

# Install Stripe CLI
brew install stripe/stripe-cli/stripe

# Login to your Stripe account
stripe login

# Create a new Stripe App project
stripe apps create tajo-brevo-integration

# Start local development
stripe apps start

핵심 개념

앱 매니페스트

모든 Stripe App에는 권한, 뷰포트, 설정을 선언하는 stripe-app.json 매니페스트가 있습니다. 전체 스키마는 앱 매니페스트 레퍼런스를 참고하세요.

UI 확장

Stripe Apps는 특정 대시보드 뷰포트에 React 기반 UI 컴포넌트를 렌더링할 수 있습니다. UI 툴킷은 Stripe 대시보드 디자인 시스템과 일치하는 사전 제작 컴포넌트를 제공합니다.

권한

앱은 접근이 필요한 Stripe API 리소스를 구체적으로 선언해야 합니다. 사용자는 설치 과정에서 이 권한을 승인합니다. 권한 레퍼런스를 참고하세요.

서명 시크릿

각 앱은 설치 서명을 검증하고 백엔드와 Stripe 사이의 통신을 보호하기 위한 서명 시크릿을 받습니다.

개발 워크플로

필요한 권한과 뷰포트를 담아 매니페스트를 정의합니다
Stripe의 React 컴포넌트 라이브러리로 UI 확장을 개발합니다
Tajo를 통해 Brevo와 데이터를 동기화할 백엔드 엔드포인트를 구현합니다
stripe apps start로 로컬에서 테스트합니다
stripe apps upload로 업로드합니다
Stripe 대시보드에서 심사를 신청합니다
게시하고 분석으로 모니터링합니다