Native Purchases __CAPGO_KEEP_0__ 저장소

GitHub

이 플러그인의 설치 단계와 전체 마크다운 가이드를 포함한 설정 지시를 복사하세요.

앱 스토어 연결 설정 완료하기

앱 스토어에서 구매 흐름을 검토하기 전에, 앱 기록 자체가 완전해야 합니다:

구매 흐름을 검토하기 전에 앱 기록을 완성하세요.

앱 스토어에서 구매 흐름을 검토하기 전에, 앱 기록 자체가 완전해야 합니다:

앱 스토어에서 구매 흐름을 검토하기 전에 앱 기록을 완성하세요.

앱 스토어에서 구매 흐름을 검토하기 전에 앱 기록을 완성하세요. 개인 정보 보호 정책 URL 앱 스토어 연결에서
추가 지원 URL 사용자에게 실제 연락처 정보가 있는 URL
설문 조사를 완료하여 앱을 출시할 수 있도록 추가 앱 리뷰 연락처
리뷰어의 명확한 설명 로그인이 필요할 경우 __CAPGO_KEEP_0__
__CAPGO_KEEP_1__ __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이 따르는 정확한 경로를 따라 Dry-Run 하세요: TestFlight

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

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

In-App Purchase Requirements

가격 투명성 (중요)

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

필수 요소:

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

Common Rejection:

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

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

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

스토어 목록 ($4.99)과 앱 ($5.99) 사이에 $1 미만의 차이만 존재해도 자동으로 거절됩니다.

구독 계획 제시

필수 공개 정보:

모든 구독 계층이 함께 표시됩니다.
각 계층의 기능 비교가 명확합니다.
프리미엄 계층에 대한 자동 기본 설정은 UI 트릭을 통해 이루어지지 않습니다.
취소 지침이 쉽게 찾을 수 있습니다.

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>
  );
}

구매 복원

필수 구현:

모든 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. 숨겨진 취소 절차

Why It Fails:

취소 방법에 대한 언급이 없음
취소 버튼이 숨겨져 있거나 가려져 있음
Apple의 네이티브 흐름이 없는 다단계 취소 절차

예방 조치:

// 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년에 개인 정보 보호 요구 사항을 엄격하게 강화했습니다.

필수적인 공개 정보

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

사용할 때
데이터가 저장/공유되는 방식
선택 사항인지 또는 필수 사항인지 여부
Whether it’s optional or required

예시: 올바른 권한 흐름

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';
}

Privacité Nutrition Labels

앱 스토어의 privacité labels가 정확하게 반영되도록 하세요.

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

2025년 privacité labels가 정확하지 않아 앱 스토어에서 거절되는 경우가 많습니다. 데이터 수집을 신중히 검토하세요.

제출 전 체크리스트

모든 구매 흐름을 테스트하세요
- 각 구독 등급을 구매하여 테스트하세요
- 무료 시범 기간을 테스트하세요
- 소개 요약이 올바르게 적용되는지 확인하세요
- 구매를 복원하세요
- 가족 공유 기능이 활성화된 경우 가족 공유를 테스트하세요
- 다양한 기기에서 테스트하세요
가격 일관성을 확인하세요
- 앱 스토어 메타데이터가 인앱 가격과 일치하는지 확인하세요
- 모든 통화가 올바른지 확인하세요
- 자유 시범 기간의 설명과 일치하는지 확인하세요.
- 소개ductory 제안 조건이 정확한지 확인하세요.
모든 복사본을 검토하세요.
- 장치 텍스트를 제거하세요.
- 증명이 테스트 가능한지 확인하세요.
- 문법과 철자가 정확한지 확인하세요.
- 설명이 현재 빌드와 일치하는지 확인하세요.
- 경쟁사 언급을 제거하세요.
권한을 테스트하세요.
- 필요한 권한만 요청하세요.
- 권한을 요청하기 전에 명확한 설명을 제공하세요.
- “거부” 흐름을 테스트하세요 (앱은 여전히 작동해야 합니다).
- 인증 정보.plist 설명이 명확한지 확인하세요.
테스트 계정 준비
- 리뷰 계정이 리뷰 기간 동안 유효한지 확인하세요.
- 앱 리뷰 정보에서 로그인 자격 증명을 문서화하세요.
- 리뷰어에게 결제 화면을 완료할 수 있는지 확인하세요.
- 필요한 경우 Notes 필드에 추가 계정이나 앱 전용 Switch를 포함하세요.
메타데이터 확인
- 현재 UI와 일치하는 스크린샷
- 지원 URL에 실제 연락처 정보가 포함되어 있는지 확인하세요.
- 개인 정보 보호 정책 URL이 입력되어 있는지 확인하세요.
- 빌드 내의 콘텐츠와 일치하는 앱 나이 등급이 있는지 확인하세요.
- 앱 프리뷰 비디오(있을 경우)가 현재 버전을 보여주는지 확인하세요.
- 기능을 정확하게 설명합니다.
- 앱 내 및 스토어 목록에서 개인 정보 보호 정책이 접근 가능합니다.

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

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>
  );
}

앱이 거부되면

해결 방법

거부 사유를 읽어보세요
- 특정 지침을 확인하세요 (예: 3.1.1, 5.1.1)
- 애플이 무엇을 문제로 지적했는지 정확히 이해하세요
문제를 완전히 고치세요
- 단순히 패치하지 말고 근본적인 원인을 고치세요
- 고친 내용을 테스트하세요
- 고친 내용을 문서화하세요

응답 센터에서 해결

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.

급히 다시 제출
- 재제출은 일반적으로 빠르게 검토됩니다
- 보통 24시간 이내

appeal Process

제출이 잘못된 것으로 생각하시면:

App Store 설명 과정

App Store Connect에서 'appeal' 클릭
명확한 증거를 제공:
- 준수하는 화면샷
- iOS 애플리케이션 스토어 리뷰 가이드라인
- 요구 사항을 충족하는 방법에 대한 설명
전문적이고 사실적인 태도를 유지하세요
기능이 찾기 어려울 때 테스트 계정 포함

문서 요청 예시

추가 리소스

지원

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

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

전문가 도움 필요하세요?

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 iOS 앱 스토어 리뷰를 위해 Native Purchases 플러그인을 사용하는 방법을 계획하고 승인 및 배포를 위해 연결하는 방법을 알아보세요. @capgo/native-purchases를 사용하는 방법 @capgo/__CAPGO_KEEP_1__-in-app-review를 사용하는 방법 @capgo/capacitor-in-app-review의 구현 방법 @capgo/capacitor-in-app-review를 사용하는 방법 @capgo/capacitor-in-app-review의 구현 방법 @capgo/capacitor-in-app-review를 사용하는 방법 @capgo/capacitor-native-market @capgo/capacitor-native-market의 구현 방법 @capgo/capacitor-native-market를 사용하는 방법 @capgo/capacitor-native-market의 구현 방법