Tajo 사전 이용 신청

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

앱 심사 품질 요건

Stripe는 마켓플레이스에 제출된 모든 앱을 포괄적인 품질 요건에 따라 심사합니다. 개발에 착수하기 전에 이 기준을 이해해 두면 시간을 아끼고 심사 반복 횟수를 줄일 수 있습니다.

개요

Stripe 앱 심사는 다음 여섯 가지 핵심 영역에서 앱을 평가합니다.

투명한 요금제, 비용에 대한 명확한 안내
앱 기능, 안정성과 완성도
개발자 표준, 코드 품질과 API 사용 방식
UX 품질, 사용자 인터페이스와 경험 기준
보안, 데이터 보호와 안전한 관행
법적 준수, 개인정보 보호 및 규제 요건

투명한 요금제

앱은 모든 비용을 사용자에게 명확하게 알려야 합니다.

요금 고지: 모든 가격은 마켓플레이스 등록 정보에 미리 명시되어야 합니다
숨은 비용 금지: 사용자가 설치 후 예상치 못한 청구를 겪어서는 안 됩니다
체험 조건: 체험을 제공한다면 기간과 종료 후 처리 방식을 분명히 밝혀야 합니다
업그레이드 흐름: 업셀이나 업그레이드 안내는 방해가 되지 않아야 하며 선택 사항임이 분명해야 합니다
통화: 가능한 경우 사용자의 현지 통화로 가격을 표시합니다

Caution

가격을 모호하게 표시하거나 명확한 동의 없이 사용자에게 청구하는 앱은 즉시 거절됩니다.

날짜와 시간 표기

앱에 표시되는 모든 날짜와 시간은 Stripe 대시보드 관례를 따라야 합니다.

사용 가능한 경우 사용자의 로케일에 맞춰 날짜를 표기합니다
시간은 사용자의 현지 시간대로 표시합니다
최근 이벤트에는 상대 시간을 사용합니다 (예: “2 hours ago”)
오래된 이벤트에는 전체 날짜와 시간을 담은 절대 시간을 사용합니다
API에 노출되는 날짜 필드는 ISO 8601을 따릅니다

// Good: Use Stripe's date formatting utilities
import { formatDate, formatRelativeTime } from '@stripe/ui-extension-sdk/utils';

const formattedDate = formatDate(timestamp); // Locale-aware
const relativeTime = formatRelativeTime(timestamp); // "2 hours ago"

앱 설정

앱에 구성이 필요한 경우 다음을 지켜야 합니다.

앱 뷰포트에서 접근할 수 있는 전용 설정 화면을 제공합니다
가능한 경우 합리적인 기본값을 미리 채워 둡니다
모든 사용자 입력을 검증하고 명확한 오류 메시지를 보여 줍니다
앱을 다시 설치하지 않고도 설정을 변경할 수 있게 합니다
Stripe Secret Store API로 설정을 세션 간에 유지합니다

샌드박스 지원

앱은 Stripe 샌드박스(테스트) 모드에서도 정상 동작해야 합니다.

테스트 모드 호환성: 모든 기능이 테스트 모드에서 작동해야 합니다
테스트 데이터: 앱 기능을 잘 보여 주는 현실적인 테스트 데이터를 사용합니다
샌드박스에 라이브 데이터 금지: 테스트 모드에서 운영 데이터를 절대 노출하지 않습니다
정중한 처리: 샌드박스에서 사용할 수 없는 기능이라면 그 이유를 설명하는 명확한 메시지를 표시합니다
매니페스트에 sandbox_install_compatible: true를 설정합니다

{
  "sandbox_install_compatible": true
}

앱 기능

안정성

앱은 일반적인 사용 중에 충돌하거나 멈추지 않아야 합니다
광고한 모든 기능이 설명대로 작동해야 합니다
네트워크 오류는 재시도 옵션과 함께 매끄럽게 처리해야 합니다
백그라운드 작업 중에도 앱은 계속 반응해야 합니다

완성도

자리표시자 콘텐츠, “coming soon” 기능, 깨진 링크가 없어야 합니다
모든 UI 요소가 동작해야 하며, 눌리지 않는 버튼이나 비활성 컨트롤이 없어야 합니다
도움말 텍스트와 문서 링크는 유효한 페이지로 연결되어야 합니다
앱을 제거하면 모든 앱 데이터와 웹훅이 깔끔하게 정리되어야 합니다

성능

UI는 일반적인 연결 환경에서 3초 이내에 렌더링되어야 합니다
백그라운드 동기화 작업이 UI를 막아서는 안 됩니다
대용량 데이터는 페이지네이션이나 지연 로딩을 사용해야 합니다
속도 제한에 걸리지 않도록 API 호출을 최소화합니다

개발자 표준

API 사용

Stripe API의 최신 안정 버전을 사용합니다
페이지네이션, 오류 처리, 멱등성에 대해 Stripe API 모범 사례를 따릅니다
속도 제한을 초과하지 말고, 재시도에는 지수 백오프를 구현합니다
폴링 대신 웹훅으로 이벤트 기반 업데이트를 처리합니다

코드 품질

프로덕션 빌드에 콘솔 오류나 경고가 없어야 합니다
제출 전에 모든 디버그 로깅을 제거합니다
모든 예외 상황(빈 상태, 누락된 데이터, 네트워크 장애)을 처리합니다
일관된 UI를 위해 Stripe 컴포넌트 라이브러리 패턴을 따릅니다

버전 관리

시맨틱 버저닝(MAJOR.MINOR.PATCH)을 사용합니다
버전 업데이트에서 하위 호환성을 깨는 변경을 문서화합니다
가능한 경우 하위 호환성을 유지합니다

UX 품질

광고 금지: 앱은 어떤 종류의 광고도 표시해서는 안 됩니다
교차 홍보 금지: 앱 UI 안에서 다른 제품이나 서비스를 홍보하지 않습니다
브랜드 콘텐츠: Brevo 같은 연동 파트너를 제외하고, 서드파티 브랜드가 아닌 자사 브랜드 아이덴티티만 표시합니다

언어와 콘텐츠

일관된 표현: 앱 전반에서 일관된 용어를 사용합니다
전문적인 톤: Stripe 대시보드의 전문적이고 간결한 커뮤니케이션 방식에 맞춥니다
전문 용어 지양: 판매자가 이해하기 어려운 기술 용어를 피합니다
맞춤법 검사: 모든 텍스트에 철자 및 문법 오류가 없도록 합니다
영어 전용: 마켓플레이스 앱의 모든 사용자 노출 텍스트는 영어여야 합니다

확인 대화상자

파괴적이거나 중대한 작업에는 사용자 확인을 요구해야 합니다.

// Good: Confirm before destructive actions
const handleDisconnect = async () => {
  const confirmed = await showConfirmation({
    title: 'Disconnect Brevo Integration',
    message: 'This will stop syncing customer data to Brevo. You can reconnect at any time.',
    confirmLabel: 'Disconnect',
    cancelLabel: 'Cancel',
    destructive: true,
  });

  if (confirmed) {
    await disconnectIntegration();
  }
};

확인이 필요한 작업입니다.

연동 해제
동기화된 데이터 삭제
데이터 흐름에 영향을 주는 설정 변경
구성을 기본값으로 초기화

로딩 상태

비동기 작업에는 항상 로딩 표시를 보여 주어야 합니다.

// Good: Show loading state during data fetch
const CustomerSyncStatus = () => {
  const { data, isLoading, error } = useSyncStatus();

  if (isLoading) {
    return <Spinner label="Loading sync status..." />;
  }

  if (error) {
    return <Banner type="critical" title="Failed to load sync status">
      {error.message}
    </Banner>;
  }

  return <SyncStatusDisplay data={data} />;
};

요구 사항은 다음과 같습니다.

데이터를 불러오는 동안 스피너나 스켈레톤 화면을 표시합니다
폼 제출 중에는 버튼을 비활성화합니다
오래 걸리는 작업에는 진행 표시기를 보여 줍니다
로딩 중에 빈 화면을 보여 주어서는 안 됩니다

오류 메시지

명확하고 실행 가능한 오류 메시지를 제공합니다.

// Bad: Generic error
"Something went wrong"

// Good: Specific and actionable
"Unable to sync customer data to Brevo. Please verify your Brevo API key
in Settings and try again."

오류 메시지 가이드라인입니다.

무슨 일이 일어났는지 쉬운 말로 설명합니다
사용자가 문제를 해결하기 위해 취할 수 있는 구체적인 조치를 제안합니다
실패한 작업을 다시 시도할 방법을 제공합니다
디버깅용 상세 오류 정보를 기록합니다 (사용자에게는 보여 주지 않습니다)
해당하는 경우 지원 문의에 쓸 오류 코드를 포함합니다

보안

Secret Store API

민감한 데이터 저장에는 모두 Stripe Secret Store API를 사용합니다.

import { createHttpClient, STRIPE_API_KEY } from '@stripe/ui-extension-sdk/http_client';

// Good: Store secrets using the Secret Store API
const storeBrevoApiKey = async (apiKey: string) => {
  const stripe = createHttpClient(STRIPE_API_KEY);
  await stripe.apps.secrets.create({
    name: 'brevo_api_key',
    payload: apiKey,
    scope: { type: 'account' },
  });
};

// Good: Retrieve secrets from the Secret Store
const getBrevoApiKey = async () => {
  const stripe = createHttpClient(STRIPE_API_KEY);
  const secret = await stripe.apps.secrets.find({
    name: 'brevo_api_key',
    scope: { type: 'account' },
  });
  return secret.payload;
};

다음 위치에는 민감한 데이터를 절대 저장하지 마세요.

로컬 스토리지 또는 세션 스토리지
쿠키
URL 파라미터
소스 코드에 하드코딩된 값
평문 구성 파일

암호화

자체 암호화 금지: 직접 만든 암호화 알고리즘을 구현하지 않습니다
Stripe의 내장 보안 요소(Secret Store, 서명 시크릿)를 사용합니다
모든 외부 API 호출에 HTTPS를 사용합니다
처리 전에 모든 웹훅 서명을 검증합니다

데이터 취급

앱에 실제로 필요한 권한만 요청합니다
기능에 필요한 범위를 넘어서는 Stripe 데이터를 저장하지 않습니다
개인정보처리방침에 맞춘 데이터 보관 정책을 시행합니다
사용자가 데이터 삭제를 요청할 수 있는 수단을 제공합니다

법적 준수

개인정보처리방침

앱에는 다음 내용을 담은, 공개적으로 접근 가능한 개인정보처리방침이 있어야 합니다.

앱이 Stripe에서 수집하는 데이터
데이터를 저장, 처리, 공유하는 방식
데이터 보관 및 삭제 정책
데이터에 관한 사용자의 권리
개인정보 문의를 위한 연락처
관련 규정 준수 여부 (GDPR, CCPA 등)

서비스 약관

앱에 대한 명확한 서비스 약관을 제공합니다
Stripe 서비스 약관과 충돌하는 조항을 포함하지 않습니다
사용상의 제한이나 제약을 분명히 밝힙니다

규제 준수

적용되는 모든 데이터 보호 규정을 준수합니다
적절한 데이터 처리 계약을 체결합니다
데이터 이동권과 삭제 요청을 지원합니다
데이터 접근 및 처리에 대한 감사 로그를 유지합니다

심사 진행 기간

단계	소요 기간
최초 제출	영업일 기준 5~10일
수정본 심사	영업일 기준 3~7일
최종 승인	영업일 기준 1~2일
게시	승인 직후

Tip

심사 주기를 여러 번 거치지 않으려면 모든 심사 피드백을 한 번의 수정본에서 처리하세요. Stripe 팀은 발견된 각 문제에 대해 구체적이고 실행 가능한 피드백을 제공합니다.

자주 발생하는 거절 사유

오류 처리 누락, 네트워크 오류나 예상치 못한 데이터에서 앱이 충돌
부족한 로딩 상태, 데이터를 불러오는 동안 빈 화면 노출
불명확한 요금제, 등록 정보에 가격이 충분히 공개되지 않음
과도한 권한, 앱에 필요하지 않은 권한을 요청
샌드박스 모드 미작동, 테스트 모드에서 앱이 동작하지 않음
보안 문제, Secret Store API 밖에 시크릿을 저장
개인정보처리방침 누락, 접근 가능한 개인정보처리방침 URL이 없음
미완성 기능, “coming soon” 기능이나 자리표시자 콘텐츠