iOS App Store Review Guidelines for IAP

Section titled “Before You Submit”

Finish App Store Connect Setup

Before Apple reviews your purchase flow, make sure the app record itself is complete:

Add a

• 추가 개인 정보 보호 정책 URL 앱 스토어 연결에서
• 추가 지원 URL 사용자에게 실제 연락처 정보를 제공하는 URL
• 사용자 정보를 제공하기 위해 설문조사를 완료하세요. 연령 등급 페이지/영역: 솔루션 페이지 앱 예시 섹션. 역할: 짧은 UI 레이블 또는 네비게이션 아이템. 위치: 컴포넌트 솔루션/솔루션 앱 예시.astro. 메시지 키 `solution_app_examples_rating` (솔루션 앱 예시 등급).
• 설문조사를 완료하여 앱을 출시할 수 있도록 하세요. 추가 앱 리뷰 연락처 정보
• 리뷰어에게 명확한 설명을 제공하세요. __CAPGO_KEEP_0__

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__

• __CAPGO_KEEP_0__
• (6.7인치)가 가장 쉬운 기본 크기입니다. 1290 x 2796 아이패드에서 앱이 작동하는 경우 아이패드 스크린샷도 업로드하십시오.
• 현재 허용되는 큰 아이패드 크기는 다음과 같습니다.
• protectedTokens 2064 x 2752 13인치)와 2048 x 2732 12.9인치)
• 아이폰 스크린샷을 iPad 지원을 위장하기 위해 늘리지 마세요

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

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

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

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

판매 가격 투명성 (중요)

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

필수 요소:

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

Common Rejection:

가격 일관성에 주의하세요 모든 가격은 다음과 일치해야 합니다:

__CAPGO_KEEP_0__

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

스토어 목록 ($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. 메타데이터 불일치

왜 실패하는가:

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

예방책:

// 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 장)

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

인

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

1. 필수 공개 사항
2. 모든 권한에 대해:
3. 왜 필요한가 (특정 사용 사례)
4. 사용할 때 언제든지 사용할 수 있습니다.

예시: 올바른 권한 흐름

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

App Store의 privace labels가 정확하게 반영되도록 하세요.

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

2025년 1월, 정확하지 않은 privace labels는 App Store의 거절 사유 중 하나입니다. 데이터 수집을 신중히 검토하세요.

Pre-Submission Checklist

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

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

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

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

3. 모든 복사본을 검토합니다.

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

4. 권한을 테스트합니다.

   • 필요한 권한만 요청합니다.
   • 권한 요청 전에 명확한 설명을 제공합니다.
   • “거부” 흐름을 테스트합니다 (앱은 여전히 작동해야 함)
   • iOS App Store 리뷰에 대한 Native Purchases

5. Info.plist 설명이 명확한지 확인하세요

   • 테스트 계정 준비
   • 리뷰 계정이 리뷰 기간 동안 유효한지 확인하세요
   • App Review 정보에 로그인 자격 증명 문서화
   • 리뷰어에게 결제 화면을 완료할 수 있는지 확인하세요

6. Notes 필드에 필요할 경우 추가 계정이나 앱 전용 Switch 포함

   • 메타데이터 확인
   • 현재 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시간 이내

appeal 프로세스

애플 스토어 설명서

1. rõ ràng한 증거를 제공하기
2. 준수에 대한 스크린샷
   • If you believe the rejection is incorrect:
   • iOS App Store Review 가이드
   • 요구 사항을 충족하는 방법에 대한 설명
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 스토어 승인 및 배포를 계획하고, Using @capgo/native-purchases Using @capgo/native-purchases의 @capgo/capacitor-in-app-review @capgo/capacitor-in-app-review @capgo/capacitor-in-app-review의 구현 세부 사항 Using @capgo/capacitor-in-app-review Using @capgo/capacitor-in-app-review의 for the implementation detail in @capgo/capacitor-native-market, and @capgo/capacitor-native-market @capgo/capacitor-native-market의 구현 세부 사항