Stripe App Marketplace에 게시하기

Stripe App을 마켓플레이스에 게시하면 모든 Stripe 사용자가 이용할 수 있게 됩니다. 이 가이드에서는 요구 사항, 준비 단계, 제출 과정을 다룹니다.

사전 준비 사항

Stripe App Marketplace에 앱을 게시하려면 다음 요구 사항을 충족해야 합니다.

• 활성화된 Stripe 계정: 테스트 모드로만 제한된 계정은 사용할 수 없습니다
• 계정당 앱 1개: 각 Stripe 계정은 마켓플레이스에 공개 앱을 하나만 게시할 수 있습니다
• 영어 전용: 모든 앱 콘텐츠, UI 텍스트, 리스팅 정보는 영어여야 합니다
• 완성된 앱: 앱이 완전히 동작하고 테스트를 마친 상태여야 합니다

게시 단계

1단계: 매니페스트 수정하기

stripe-app.json의 distribution_type을 public으로 설정합니다.

{
  "id": "com.tajo.brevo-integration",
  "version": "1.0.0",
  "name": "Tajo Brevo Integration",
  "icon": "./icon.png",
  "distribution_type": "public",
  "permissions": [
    {
      "permission": "customer_read",
      "purpose": "Sync customer data to Brevo contacts"
    },
    {
      "permission": "customer_write",
      "purpose": "Update customer metadata with Brevo sync status"
    },
    {
      "permission": "event_read",
      "purpose": "Track payment and subscription events for Brevo automation"
    }
  ]
}

2단계: 앱 준비하기

제출 전에 앱이 모든 심사 요구 사항을 충족하는지 확인합니다.

1. 라이브 모드와 샌드박스 모드 양쪽에서 충분히 테스트합니다
2. 모든 권한이 실제로 필요한지, 문서화되어 있는지 확인합니다
3. 오류 처리와 로딩 상태가 구현되어 있는지 확인합니다
4. 모든 UI 텍스트가 영어인지 점검합니다

3단계: 앱 업로드하기

Stripe CLI로 앱을 업로드합니다.

# Upload your app to Stripe
stripe apps upload

# Verify the upload
stripe apps versions list

4단계: 리스팅 작성하기

Stripe 대시보드로 이동해 앱 리스팅을 완성합니다. 마켓플레이스 제출에는 모든 리스팅 항목이 필수입니다.

5단계: 심사 요청하기

리스팅을 완성한 뒤 Stripe 대시보드에서 앱 심사를 요청합니다. Stripe 팀이 품질 요구 사항에 따라 앱을 평가합니다.

6단계: 게시하기

승인이 완료되면 앱을 게시해 마켓플레이스에 공개할 수 있습니다.

공개 배포를 위한 매니페스트 설정

매니페스트에는 distribution_type: "public"이 포함되어야 하며, 필요한 모든 권한을 명확한 목적 설명과 함께 선언해야 합니다.

{
  "id": "com.tajo.brevo-integration",
  "version": "1.2.0",
  "name": "Tajo for Brevo",
  "icon": "./assets/icon.png",
  "distribution_type": "public",
  "stripe_api_access_type": "oauth",
  "allowed_redirect_uris": [
    "https://tajo.io/stripe/callback"
  ],
  "permissions": [
    {
      "permission": "customer_read",
      "purpose": "Read customer profiles to sync with Brevo contacts"
    },
    {
      "permission": "customer_write",
      "purpose": "Write sync metadata to customer records"
    },
    {
      "permission": "charge_read",
      "purpose": "Access payment data for Brevo event tracking"
    },
    {
      "permission": "event_read",
      "purpose": "Subscribe to Stripe events for real-time Brevo sync"
    },
    {
      "permission": "product_read",
      "purpose": "Sync product catalog to Brevo for campaign personalization"
    },
    {
      "permission": "invoice_read",
      "purpose": "Track invoice events for Brevo transactional emails"
    }
  ],
  "ui_extension": {
    "views": [
      {
        "viewport": "stripe.dashboard.customer.detail",
        "component": "CustomerDetailView"
      },
      {
        "viewport": "stripe.dashboard.home.overview",
        "component": "OverviewView"
      }
    ]
  },
  "post_install_action": {
    "type": "onboarding"
  }
}

설정을 마친 앱은 다음 명령으로 업로드합니다.

stripe apps upload

리스팅 요구 사항

앱 리스팅에는 다음 항목이 모두 포함되어야 합니다.

이름 가이드라인

• 마켓플레이스에서 고유해야 합니다
• 앱의 목적이 분명히 드러나야 합니다
• 사용자를 혼란스럽게 하는 일반적인 표현은 피합니다
• 예시: “Tajo for Brevo” (15자)

아이콘 가이드라인

• 크기: 정확히 300x300 픽셀
• 형식: PNG 또는 SVG
• 둥근 모서리를 직접 넣지 마십시오. Stripe가 자동으로 적용합니다
• 알아보기 쉬운 로고나 심벌을 사용합니다
• 작은 크기에서도 판독 가능한지 확인합니다

About 섹션

다음 내용을 담아 설득력 있는 소개를 작성합니다.

• 앱이 해결하는 문제
• 핵심 연동 기능
• 앱이 대상으로 하는 사용자
• 사전 준비 사항이나 요구 조건

예시:

Tajo for Brevo connects your Stripe payment data with Brevo’s marketing automation platform. Automatically sync customers, track payment events, and trigger personalized email, SMS, and WhatsApp campaigns based on real-time purchase behavior. Built for ecommerce businesses that want to maximize customer lifetime value through data-driven retention marketing.

주요 기능

각 주요 기능 항목은 다음으로 구성됩니다.

• Title: 짧은 기능 이름
• Description: 기능을 설명하는 한두 문장
• Image: 스크린샷 또는 다이어그램 (권장 크기 1600x900 픽셀)

Tajo Brevo 연동에 권장되는 기능은 다음과 같습니다.

1. 실시간 고객 동기화, Stripe 고객 프로필을 구매 이력까지 포함해 Brevo 컨택트로 자동 동기화합니다
2. 이벤트 기반 자동화, 결제 성공, 구독 변경, 환불 같은 Stripe 이벤트로 Brevo 워크플로를 실행합니다
3. 상품 카탈로그 동기화, 개인화된 캠페인 콘텐츠를 위해 Brevo 상품 카탈로그를 Stripe와 동기화된 상태로 유지합니다
4. 멀티채널 캠페인, 동기화된 데이터를 활용해 타깃 이메일·SMS·WhatsApp 캠페인을 운영합니다
5. 대시보드 인사이트, Stripe 대시보드 고객 화면에서 Brevo 인게이지먼트 지표를 바로 확인합니다

요금 정보

요금제는 명확하게 전달합니다.

• 무료: 설치와 사용에 비용이 들지 않음
• 유료: 가격과 결제 주기를 명시
• 프리미엄: 무료로 제공되는 범위와 유료 범위를 설명
• 사용량 기반: 요금 구간이나 단위당 비용을 설명

앱 테스트하기

제출 전에 앱을 충분히 테스트합니다.

샌드박스 모드에서 테스트

# Start your app in test mode
stripe apps start --mode test

# Verify sandbox compatibility
stripe apps validate

테스트 계정 정보 형식

심사 팀에 테스트 계정 정보를 제공할 때는 다음 형식을 사용합니다.

Test Account Credentials
========================
Platform: Tajo
URL: https://app.tajo.io/test
Email: [email protected]
Password: [secure test password]

Brevo Test API Key: xkeysib-test-xxxxxxxxxxxx

Required Setup Steps:
1. Log in to the Tajo test account
2. Navigate to Settings > Integrations > Brevo
3. The Brevo API key is pre-configured
4. Install the Stripe App from the test link provided

Expected Behavior:
- Customer sync should begin within 60 seconds of installation
- Navigate to any Stripe customer to see Brevo contact data
- Create a test payment to verify event sync to Brevo

심사 전 체크리스트

제출하기 전에 다음을 확인합니다.

• 라이브 모드와 테스트 모드 양쪽에서 앱이 정상 동작함
• 모든 권한에 명확한 목적 설명이 있음
• 오류 상태를 매끄럽게 처리함
• 비동기 작업에 로딩 상태를 표시함
• 프로덕션 빌드에 하드코딩된 테스트 데이터가 없음
• 개인정보처리방침 URL에 접근 가능하고 내용이 정확함
• 지원 문의처 정보가 유효함
• 모든 리스팅 이미지가 크기 요구 사항을 충족함
• 앱 소개가 실제 기능을 정확히 반영함

제출 이후

Stripe 심사 팀은 보통 영업일 기준 5~10일 이내에 회신합니다. 결과는 다음 중 하나입니다.

• 게시 승인
• 구체적인 피드백과 함께 수정 요청
• 요구 사항을 충족하지 못한 경우 반려

수정 요청을 받으면 모든 피드백을 반영해 다시 제출합니다. 재제출할 때마다 전체 심사 절차를 다시 거칩니다.

게시된 앱 업데이트하기

이미 게시된 앱을 업데이트하려면 다음 절차를 따릅니다.

1. stripe-app.json의 버전을 올립니다
2. 새 버전을 업로드합니다: stripe apps upload
3. 업데이트 심사를 요청합니다
4. 승인되면 모든 사용자에게 자동으로 배포됩니다