---
title: "Stripe Apps 연동 가이드 | Tajo"
description: "상태: 예정, 아직 구축되지 않음. 이 섹션은 구축 가이드입니다. Tajo에는 Stripe App이 없으며, 여기 있는 어떤 것도 현재 설치할 수 없습니다."
url: https://tajo.io/kr/docs/stripe-apps/
markdown: https://tajo.io/kr/docs/stripe-apps.md
lang: ko-KR
author: "Set Noa"
author_url: https://tajo.io/kr/set-noa/
robots: noindex
---

Tajo 사전 이용 신청

이름과 회사 이메일 주소를 입력하세요. Tajo 이용 신청을 확인할 수 있는 링크를 이메일로 보내드립니다.

# Stripe Apps 연동 가이드

[Set Noa](https://tajo.io/kr/set-noa/)

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

Caution

**상태: 예정, 아직 구축되지 않음.** Tajo에는 Stripe App이 없으므로 이 섹션의 어떤 것도 현재 설치할 수 없으며, 이 문서에 나오는 앱 식별자, URL, 자격 증명은 실제로 동작하는 엔드포인트가 아니라 예시용 자리표시자입니다. 지금 바로 Stripe를 Tajo에 연결하려면 [Stripe 커넥터](https://tajo.io/docs/connectors/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 대시보드와 Tajo가 고객 및 결제 데이터를 주고받고, Tajo는 연락처, 캠페인, 자동화를 Brevo와 동기화합니다.*

## 가이드 구성

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

### 시작하기

| 가이드 | 설명 |
| --- | --- |
| [마켓플레이스에 게시하기](https://tajo.io/kr/docs/stripe-apps/publish-app) | 앱 심사를 신청하기 위한 요건과 절차 |
| [앱 심사 요건](https://tajo.io/kr/docs/stripe-apps/review-requirements) | 승인을 위한 품질, 보안, UX 기준 |

### 설정 및 레퍼런스

| 가이드 | 설명 |
| --- | --- |
| [앱 매니페스트 레퍼런스](https://tajo.io/kr/docs/stripe-apps/app-manifest) | `stripe-app.json` 매니페스트 파일의 전체 스키마 |
| [권한 레퍼런스](https://tajo.io/kr/docs/stripe-apps/permissions) | Stripe API 권한 전체 목록과 요청 방법 |
| [뷰포트 레퍼런스](https://tajo.io/kr/docs/stripe-apps/viewports) | 앱 UI가 표시될 수 있는 대시보드 위치 |

### 기능 및 연동

| 가이드 | 설명 |
| --- | --- |
| [임베디드 Stripe Apps](https://tajo.io/kr/docs/stripe-apps/embedded-apps) | 플랫폼 연동을 위한 Connect 임베디드 컴포넌트 사용법 |
| [설치 링크와 딥 링크](https://tajo.io/kr/docs/stripe-apps/install-links) | 설치 URL 생성 및 특정 앱 화면으로의 딥 링크 |
| [설치 후 동작](https://tajo.io/kr/docs/stripe-apps/post-install) | 앱 설치 이후의 온보딩 흐름 설정 |

### 운영 및 성장

| 가이드 | 설명 |
| --- | --- |
| [앱 분석](https://tajo.io/kr/docs/stripe-apps/analytics) | 설치 수, 조회 수, 전환 지표 추적 |

## 사전 준비 사항

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

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

## 빠른 시작

```bash
# 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` 매니페스트가 있습니다. 전체 스키마는 [앱 매니페스트 레퍼런스](https://tajo.io/kr/docs/stripe-apps/app-manifest)를 참고하세요.

### UI 확장

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

### 권한

앱은 접근이 필요한 Stripe API 리소스를 구체적으로 선언해야 합니다. 사용자는 설치 과정에서 이 권한을 승인합니다. [권한 레퍼런스](https://tajo.io/kr/docs/stripe-apps/permissions)를 참고하세요.

### 서명 시크릿

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

## 개발 워크플로

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

Caution

Stripe는 마켓플레이스 배포용 앱을 영어로 작성하도록 요구합니다. 앱 소개, UI 문구, 문서가 모두 영어여야 합니다.

## 다음 단계

먼저 [게시 가이드](https://tajo.io/kr/docs/stripe-apps/publish-app)로 전체 요건을 파악한 다음, 기술 레퍼런스를 따라가며 앱 매니페스트와 권한을 설정하세요.