iOS App Store Review Guidelines for IAP

앱 스토어 연결 설정 완료

구매 흐름을 검토하기 전에 앱 기록 자체가 완전한지 확인하세요.

앱 스토어 승인에 필요한 모든 것을 다루는 이 가이드는 첫 번째 제출에서 검토 통과를 위해 필요한 모든 것을 다룹니다.

앱 스토어 승인 전

• 소스 가이드 개인 정보 보호 정책 URL 앱 스토어 연결에서
• 추가 지원 URL 사용자에게 실제 연락처 정보를 제공하는 URL
• 설문 조사 완료 연령 등급 설문 조사 완료하여 앱을 출시할 수 있도록
• 추가 앱 리뷰 연락처 리뷰어에게 명확한 설명을 남기기
• 로그인이 필요할 경우 __CAPGO_KEEP_0__

주의

애플은 지원 사이트를 단순한 링크로만 보지 않습니다. 실제 연락처 정보를 포함해야 하며 사용자가 앱 문제, 피드백 및 기능 요청에 대해 연락할 수 있도록 해야 합니다.

실제 스크린샷을 준비하세요

• iPhone의 경우
• (6.7인치)가 가장 쉬운 기본 크기입니다 1290 x 2796 iPad에서 앱이 실행되는 경우 iPad 스크린샷도 업로드하세요
• 현재 허용되는 대형 iPad 크기는
• __CAPGO_KEEP_1__ 2064 x 2752 (13인치)와 2048 x 2732 (12.9인치)
• iPhone 스크린샷을 iPad 지원으로 위장하지 마세요.

실제 기기에서 Apple이 따르는 정확한 경로를 실행하세요:

구매 계정으로 로그인하세요.

• 숨겨진 동작이나 디버그 메뉴가 없는 상태에서 결제 벽을 도달하세요.
• 구매, 복원 및 구독 관리 흐름을 완료하세요.
• 권한이 거부된 경우 앱이 여전히 올바르게 작동하는지 확인하세요.
• In-App 구매 요구 사항
• TestFlight에서 Dry-Run 리뷰어의 여정을 실행하세요.

실제 기기에서 Apple이 따르는 정확한 경로를 실행하세요:

가격 투명성 (중요)

애플은 구매 전 crystal-clear 가격 공개가 필요합니다.

필수 요소:

• 구매 버튼 앞에 정확한 가격을 표시해야 합니다.
• 사용자가 돈을 지불하는 데 무엇을 얻는지 명확하게 밝혀야 합니다.
• 요금이 언제 발생하는지 나타내야 합니다.
• 일반적인 거부:

Common Rejection:

:::caution 가격 일관성 모든 가격은 다음과 일관해야 합니다:

모든 가격은 애플 스토어, 앱 내 구매, 개발자 센터, 앱 스토어에서 일관해야 합니다.

• 애플 스토어 메타데이터 목록
• 인앱 구매 화면
• 구독 관리 화면

스토어 목록 ($4.99)과 앱 ($5.99) 사이의 $1 미만의 차이도 자동으로 거절을 트리거합니다.

구독 플랜 제시

필수 공개 정보:

• 모든 구독 계층이 함께 표시됩니다.
• 각 계층의 기능 비교가 명확합니다.
• 프리미엄 계층에 대한 UI 트릭으로 자동으로 전환하지 않습니다.
• 취소 지침이 쉽게 찾을 수 있습니다.

준수하는 UI의 예시:

import { NativePurchases } from '@capgo/native-purchases';

function SubscriptionScreen() {
  return (
    <div>
      <h2>Choose Your Plan</h2>

      {/* Show all tiers equally */}
      <PlanCard
        title="Basic"
        price="$4.99/month"
        features={['Feature A', 'Feature B']}
      />
      <PlanCard
        title="Premium"
        price="$9.99/month"
        features={['All Basic', 'Feature C', 'Feature D']}
        highlighted={false} // Don't force premium
      />

      {/* Clear cancellation info */}
      <Text>
        Cancel anytime in Settings > Subscriptions.
        No refunds for partial periods.
      </Text>
    </div>
  );
}

구매 복원

필수 Implementation:

모든 IAP 앱은 사용자가 이전 구매를 복원할 수 있는 방법을 제공해야 합니다.

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';

async function restorePurchases() {
  try {
    await NativePurchases.restorePurchases();

    const { purchases } = await NativePurchases.getPurchases({
      productType: PURCHASE_TYPE.SUBS,
    });

    const activeSub = purchases.find(
      (purchase) => purchase.isActive && purchase.expirationDate,
    );

    if (activeSub) {
      unlockPremiumFeatures();
      showMessage('Purchases restored successfully!');
      return;
    }

    const { purchases: iaps } = await NativePurchases.getPurchases({
      productType: PURCHASE_TYPE.INAPP,
    });
    const hasIap = iaps.some((purchase) => purchase.productIdentifier === 'premium_unlock');

    showMessage(
      hasIap ? 'Premium purchase restored!' : 'No previous purchases found.',
    );
  } catch (error) {
    showError('Failed to restore purchases. Please try again.');
  }
}

// Add a visible "Restore Purchases" button
<Button onClick={restorePurchases}>
  Restore Purchases
</Button>

일반적인 거절 이유

1. 앱이 충돌하거나 기능이 깨져 있습니다.

왜 실패하는가:

• 앱이 런칭 시 충돌합니다.
• 구매 흐름이 완료되지 않습니다.
• 스크린샷에 나온 기능이 작동하지 않습니다.

예방책:

• 실제 기기에서 테스트하세요 (시뮬레이터만 테스트하지 마세요).
• 모든 구독 흐름을 종단에서 종단으로 테스트하세요.
• 받은 금액 확인이 작동하는지 확인하세요.
• 네트워크 오류 처리를 확인하세요.

2. Metadata 불일치:

왜 실패하는가:

• 스크린샷은 현재 빌드에 없는 기능을 보여주고 있습니다.
• 설명에는 존재하지 않는 기능이 포함되어 있습니다.
• 메타데이터에 표시된 가격이 앱 내 가격과 다릅니다.

예방책:

// Document exactly what's in each tier
const SUBSCRIPTION_FEATURES = {
  basic: ['Ad-free', 'Cloud sync', 'Basic themes'],
  premium: ['Ad-free', 'Cloud sync', 'All themes', 'Priority support']
};

// Use these in both your app AND App Store description

3. 허용되지 않은 권한 설명이 부족합니다.

왜 실패하는지:

• 카메라/위치/건강 정보 요청을 설명하지 않고 요청하는 경우
• 권한 요청이 여러 화면 깊이에 묻혀 있는 경우
• 권한 설명이 모호하거나 일반적인 경우

예방대책:

업데이트하여 Info.plist 명확한 설명과 함께:

<key>NSCameraUsageDescription</key>
<string>Camera access is needed to scan product barcodes for quick subscription upgrades.</string>

<key>NSLocationWhenInUseUsageDescription</key>
<string>Location helps us show relevant local content in your Premium subscription.</string>

4. 유도적 마케팅

왜 실패하는가:

• "세계 1위 앱"이라고 주장하는 것과 증거가 없는 경우
• "무제한" 기능이 숨겨진 제한이 있는 경우
• "마감임박" 전략 ( "마감임박"이라고 말하는 것)

예방 조치:

• 설명이 사실적이고 구체적이어야 합니다.
• 증거가 없는 초월적인 표현을 피하세요.
• 사용자에게 가짜 부족감을 강요하지 마십시오.

5. 숨겨진 취소 절차

실패하는 이유:

• 취소 방법에 대한 언급이 없습니다.
• 취소 버튼이 숨겨져 있거나 가려져 있습니다.
• 애플의 네이티브 흐름이 아닌 여러 단계의 취소 절차

예방 조치:

// Always inform users about cancellation
function SubscriptionInfo() {
  return (
    <div>
      <h3>How to Cancel</h3>
      <ol>
        <li>Open iPhone Settings</li>
        <li>Tap your name at the top</li>
        <li>Tap Subscriptions</li>
        <li>Select this app and tap Cancel</li>
      </ol>

      <p>Or manage directly in the App Store app.</p>

      <Button onClick={openSubscriptionManagement}>
        Manage Subscription in Settings
      </Button>
    </div>
  );
}

async function openSubscriptionManagement() {
  // Direct link to iOS subscription management
  await NativePurchases.showManageSubscriptions();
}

개인 정보 및 데이터 사용(5.1.1 섹션)

애플은 2025년에 개인 정보 보호 요구 사항을 엄격하게 강화했습니다.

필수적인 공개

왜 필요한가 (특정 사용 사례)

1. 사용될 때
2. 데이터가 저장/공유되는 방식
3. 선택 사항인지 또는 필수인지 여부
4. __CAPGO_KEEP_0__

예시: 올바른 권한 흐름

async function requestCameraPermission() {
  // Show explanation BEFORE requesting
  await showDialog({
    title: 'Camera Access',
    message: 'We need camera access to let you scan barcodes for quick product lookup. Your photos are never uploaded or stored.',
    buttons: ['Not Now', 'Allow']
  });

  // Then request permission
  const result = await Camera.requestPermissions();
  return result.camera === 'granted';
}

Privace Nutrition Labels

앱 스토어 Privace Labels가 정확하게 반영되도록 하세요.

• 구매 내역 수집
• 이메일 주소(영수증)
• 기기 ID(위조 방지)
• 사용 데이터(분석)

2025년 정확하지 않은 Privace Labels는 일반적인 거절 사유입니다. 데이터 수집을 신중히 검토하세요.

제출 전 체크리스트

1. 모든 구매 흐름을 테스트하세요

   • 각 구독 등급을 구매하세요
   • 무료 시범 기간을 테스트하세요
   • 소개 요약이 올바르게 적용되는지 확인하세요
   • 구매를 복원하세요
   • 가족 공유 기능이 활성화된 경우 가족 공유를 테스트하세요
   • 다양한 기기에서 테스트하세요

2. 가격 일관성을 확인하세요

   • 앱 스토어 메타데이터가 인앱 가격과 일치하는지 확인하세요
   • 모든 통화가 정확한지 확인하세요
   • 자유 시범 기간의 설명과 일치하는지 확인하세요.
   • 소개 요약이 정확한지 확인하세요.

3. 모든 복사본을 검토하세요.

   • 장치 텍스트를 제거하세요.
   • 검증 가능한 주장을 확인하세요.
   • 문법과 철자가 정확한지 확인하세요.
   • 현재 빌드와 일치하는 설명을 확인하세요.
   • 경쟁사 언급을 제거하세요.

4. 권한을 테스트하세요.

   • 필요한 권한만 요청하세요.
   • 권한 요청하기 전에 명확한 설명을 제공하세요.
   • ‘거부’ 흐름을 테스트하세요 (앱은 여전히 작동해야 합니다).
   • 인증 정보.plist 설명이 명확한지 확인하세요.

5. 테스트 계정 준비

   • 리뷰 계정이 리뷰 기간 동안 유효한지 확인하세요.
   • 앱 리뷰 정보에서 로그인 자격 증명을 문서화하세요.
   • 리뷰어에게 결제 화면을 완료할 수 있는지 확인하세요.
   • 필요한 경우 Notes 필드에 추가 계정이나 앱 전용 Switch를 포함하세요.

6. 메타데이터 확인

   • 현재 UI와 일치하는 스크린샷이 있는지 확인하세요.
   • 지원 URL에 실제 연락처 정보가 포함되어 있는지 확인하세요.
   • 개인 정보 보호 정책 URL이 입력되어 있는지 확인하세요.
   • 빌드 내의 콘텐츠와 일치하는 앱 등급이 있는지 확인하세요.
   • 앱 프리뷰 비디오(있을 경우)가 현재 버전을 보여주는지 확인하세요.
   • 기능 설명이 정확히 기능을 설명합니다.
   • 개인 정보 보호 정책은 앱 내에서 및 스토어 목록에서 접근할 수 있습니다.

7. 상세 리뷰 노트를 작성하세요.

   Contact:
   Name: Jane Developer
   Email: review@yourapp.com
   Phone: +1 555-0100
   
   Test Account:
   Email: reviewer@test.com
   Password: TestPass123!
   This account does not expire during review.
   
   Testing Instructions:
   1. Log in with test account above
   2. Tap "Upgrade to Premium" button
   3. Select "Monthly Premium" subscription
   4. Complete purchase (no charge in sandbox)
   5. Verify premium features unlock
   
   Note: Subscription pricing is clearly shown before purchase.
   Cancellation instructions are in Settings > Account.

리뷰 타임라인

표준 리뷰: 24-48시간 피크 기간: 3-5일 (앱 스토어 휴일 출시) 주말: No reviews processed 급리뷰: 중요한 버그 수정에만 사용할 수 있습니다 (App Store Connect에서 요청)

App Store Connect에서 보는 일반적인 상태:

• Waiting for Review
• In Review
• Pending Developer Release
• Rejected

주의

주중에 제출하면 주말 지연을 피할 수 있습니다. 일반적으로 월요일에 제출된 리뷰는 수요일에 검토됩니다.

2026년 제출 초점

현재 초점 영역

1. 구독 명확성

• iOS 앱 스토어 리뷰
• 사이드 바이 사이드 계획 비교가 필요합니다.
• 더 저렴한 옵션을 숨기지 않는 '다크 패턴'이 없습니다.

다운그레이드/업그레이드 경로가 명확합니다.

• 2. 메타데이터 정확성
• 리뷰 중인 빌드와 일치하는 스크린샷이 있어야 합니다.
• 아이패드 스크린샷은 아이패드 지원이 활성화된 경우 필수입니다.

제출 전 지원 URL 및 개인 정보 보호 정책이 이미 활성화되어야 합니다.

• 3. 개인 정보 보호 및 리뷰 세부 정보 품질
• SDK가 실제로 수집하는 것과 일치하는 개인 정보 보호 공개가 있어야 합니다.
• 앱 리뷰 연락처 및 메모는 첫 번째 제출 시 완전해야 합니다.

데모 자격 증명은 리뷰 기간 동안 유효해야 합니다.

• 애플은 최소 SDK 요구 사항을 정기적으로 업데이트하므로 현재 마감일을 확인하기 전에 릴리스 빌드를 업로드하기 전에
• TestFlight은 제출하기 전에 정확한 리뷰어 경로를 확인하기에 가장 안전한 곳입니다

네이티브 구매 플러그인에 대한最佳 관행

적절한 오류 처리를 구현하세요

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';

async function handlePurchase(productId: string) {
  try {
    const transaction = await NativePurchases.purchaseProduct({
      productIdentifier: productId,
      productType: PURCHASE_TYPE.SUBS,
    });

    // Success
    await validateReceiptOnServer(transaction.receipt);
    showSuccess('Subscription activated!');
    unlockFeatures();

  } catch (error: any) {
    // Handle specific error cases
    if (error.code === 'USER_CANCELLED') {
      // User cancelled - don't show error
      console.log('Purchase cancelled by user');
    } else if (error.code === 'PAYMENT_PENDING') {
      showInfo('Payment is pending. Please check back later.');
    } else if (error.code === 'PRODUCT_ALREADY_PURCHASED') {
      // Restore instead
      await NativePurchases.restorePurchases();
    } else {
      // Show user-friendly error
      showError('Unable to complete purchase. Please try again.');
    }
  }
}

로딩 상태를 표시하세요

function PurchaseButton({ productId }: { productId: string }) {
  const [loading, setLoading] = useState(false);

  const handlePurchase = async () => {
    setLoading(true);
    try {
      await NativePurchases.purchaseProduct({ productIdentifier: productId });
    } finally {
      setLoading(false);
    }
  };

  return (
    <button onClick={handlePurchase} disabled={loading}>
      {loading ? 'Processing...' : 'Subscribe Now'}
    </button>
  );
}

약관을 명확하게 표시하세요

function SubscriptionTerms() {
  return (
    <div className="terms">
      <p>
        Subscription automatically renews unless cancelled at least 24 hours
        before the end of the current period.
      </p>
      <p>
        Your account will be charged for renewal within 24 hours prior to
        the end of the current period.
      </p>
      <p>
        Subscriptions may be managed by the user and auto-renewal may be
        turned off in Account Settings after purchase.
      </p>
      <p>
        <a href="/terms">Terms of Service</a> |
        <a href="/privacy/">Privacy Policy</a>
      </p>
    </div>
  );
}

앱이 거부되면

해결 방법

1. 거부 사유를 읽어보세요

   • 특정 지침을 확인하세요 (예: 3.1.1, 5.1.1)
   • 애플이 무엇을 문제로 지적했는지 정확히 이해하세요

2. 문제를 완전히 고치세요

   • 단순히 패치하지 말고 근본적인 원인을 고치세요
   • 고친 내용을 철저히 테스트하세요
   • 변경한 내용을 문서화하세요

3. 응답 센터에서 해결

   Thank you for your feedback. I have addressed the issue:
   
   Issue: Subscription pricing not clear upfront
   
   Fix: Added explicit pricing display on subscription selection
   screen showing "$9.99/month" before purchase button. Also added
   cancellation instructions on the same screen.
   
   The changes are in this submission and can be tested using the
   provided test account.

4. 급히 다시 제출

   • 재제출은 일반적으로 빠른 검토
   • 보통 24시간 이내

항의 절차

만약 여러분이 거부가 잘못되었다고 믿다면:

1. 애플 스토어 연결에서 "항의" 클릭
2. 명확한 증거를 제공:
   • 준수 여부를 보여주는 스크린샷
   • 관련 지침
   • 요구 사항을 충족하는 방법에 대한 설명
3. 전문적이고 사실적인
4. 기능이 찾기 어려울 때 테스트 계정 포함

추가 자료

• 애플 앱 스토어 리뷰 지침
• 인앱 구매 지침
• 구독 최적화
• 앱 스토어 연결 도움말
• 스크린샷 사양
• 플랫폼 버전 정보

지원

문제가 해결되지 않는 경우:

• 리뷰를 네이티브 구매 문서
• 확인 일반적인 문제 해결
• 애플 개발자 지원으로 지침 설명을 문의하세요

전문가의 도움이 필요하세요?

Struggling with app review or need personalized assistance? Capgo의 팀과 상담 전화 예약 다음과 같은 전용 지원을 위해:

• IAP 구현 검토 및 최적화
• 앱 스토어 리뷰 준비 및 전략
• 제출 목록 검토
• 반려 해결 및 항소
• 완전한 테스트 및 검증

Capgo의 전문가들은 이미 수백 개의 앱이 리뷰를 통과하는 데 성공했습니다!

iOS App Store Review Guidelines for IAP에서 계속 진행하세요

iOS App Store Review Guidelines for IAP을 사용하고 있다면 iOS App Store Review Guidelines for IAP 스토어 승인 및 배포를 계획하고, Using @capgo/native-purchases Using @capgo/native-purchases Using @capgo/capacitor-in-app-review Using @capgo/capacitor-in-app-review Using @capgo/capacitor-in-app-review Using @capgo/capacitor-in-app-review Using @capgo/capacitor-native-market Using @capgo/capacitor-native-market Using @capgo/capacitor-native-market Using @capgo/capacitor-native-market