Configure iOS 샌드박스 테스트

__CAPGO_KEEP_4__

__CAPGO_KEEP_5__

• __CAPGO_KEEP_7____CAPGO_KEEP_8__
• __CAPGO_KEEP_9____CAPGO_KEEP_10__
• __CAPGO_KEEP_11____CAPGO_KEEP_0__

__CAPGO_KEEP_2__

__CAPGO_KEEP_3__

__CAPGO_KEEP_4__

1. __CAPGO_KEEP_6__

   __CAPGO_KEEP_7__ __CAPGO_KEEP_8__ __CAPGO_KEEP_9__

   • __CAPGO_KEEP_10__
   • __CAPGO_KEEP_11__
   • __CAPGO_KEEP_0__

   Apple에서 정보를 승인하기까지 24-48시간이 걸릴 수 있습니다.

2. __CAPGO_KEEP_0__

   애플 스토어 연결에서 사용자 및 액세스 > 샌드박스 테스터.

   __CAPGO_KEEP_0__ + 새 샌드박스 테스터를 만들기 위해 버튼을 클릭하세요.

   중요Apple ID와 이미 연관된 이메일 주소를 사용하지 마세요. 이메일 별칭을 사용할 수 있습니다:

   • Gmail: youremail+test@gmail.com
   • iCloud: youremail+test@icloud.com

   

3. 테스트 장치 설정 (iOS 12+)

   iOS 12부터는 iTunes 계정에서 로그아웃하지 않아도 테스트 구매를 할 수 있습니다.

   iOS 장치에서:

   1. 열기 설정
   2. 클릭 애플 스토어
   3. 하단으로 스크롤
   4. 클릭 샌드박스 계정
   5. 샌드박스 테스트 계정으로 로그인

   Tip

   이 방법은 iTunes 계정에서 로그아웃하는 옛 방법보다 훨씬 편리합니다!

4. Xcode 프로젝트 설정

   Xcode 프로젝트가 다음을 포함해야 합니다.

   Bundle Identifier

   • Developer Center에 등록된 식별자와 일치해야 합니다.
   • App Store Connect에 등록된 식별자와 일치해야 합니다.

   In-App Purchase Capability

   1. Xcode에서 프로젝트를 선택하세요.
   2. 프로젝트를 선택한 후 Signing & Capabilities
   3. 클릭하세요. + 기능
   4. 추가 앱 내 구매

5. 앱 내 구매 제품 만들기

   앱 스토어 연결에서 앱을 선택하고 앱 내 구매 제품을 만들 수 있습니다. (구독, 소비 가능한 제품 등).

   제품은 최소 '제출 준비' 상태여야 하며 샌드박스 테스트를 위해.

6. 구현 테스트

   테스트 장치에서 앱을 빌드하고 실행하세요. 구매 시도 시, 다음과 같은 메시지를 보아야 합니다.

   [환경: 샌드박스]

   이 확인은 샌드박스 환경에서 실제 돈을 지불하지 않음을 의미합니다.

중요한 참고 사항

__CAPGO_KEEP_0__

• __CAPGO_KEEP_2____CAPGO_KEEP_3__
• __CAPGO_KEEP_4____CAPGO_KEEP_5__
  • __CAPGO_KEEP_6__
  • __CAPGO_KEEP_7__
  • __CAPGO_KEEP_8__
  • __CAPGO_KEEP_9__
  • __CAPGO_KEEP_10__
  • __CAPGO_KEEP_11__
• 자동 갱신 제한: 샌드박스에서 구독이 자동 갱신됩니다. 갱신 횟수는 6회까지 가능합니다.
• 즉시 취소: 취소된 구독은 즉시 만료됩니다.

샌드박스 계정 관리

• 다양한 시나리오를 위한 여러 테스트 계정을 생성하세요.
• 테스트 계정은 테스트 기기에서만 사용하세요.
• 샌드박스 테스트를 위해 개인 Apple ID를 사용하지 마세요.
• 테스트 계정은 지역 제한 없이 제품을 구매할 수 있습니다.

샌드박스 테스트 사용

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

const { isBillingSupported } = await NativePurchases.isBillingSupported();
if (!isBillingSupported) {
  throw new Error('StoreKit not supported on this device');
}

// Fetch products (automatically uses sandbox when available)
const { products } = await NativePurchases.getProducts({
  productIdentifiers: ['premium_monthly'],
  productType: PURCHASE_TYPE.SUBS,
});

// Make test purchase
const transaction = await NativePurchases.purchaseProduct({
  productIdentifier: 'premium_monthly',
  productType: PURCHASE_TYPE.SUBS,
});

console.log('Test purchase successful!', transaction.transactionId);

인증

정확하게 설정된 경우, 다음을 관찰해야합니다.

1. 테스트 환경 배너 구매 시: '[환경: 테스트 환경]'
2. 상품이 로드 성공적으로
3. 구매가 완료 실제 요금이 청구되지 않습니다.
4. 영수증이 올바르게 검증 됩니다.
5. 구독이 자동으로 갱신됩니다. 자동 갱신 속도가 가속됩니다.

문제 해결

상품이 로드되지 않습니다.:

• App Store Connect의 Bundle Identifier가 일치하는지 확인하세요.
• 계약서가 서명되고 승인되었는지 확인하세요.
• 상품이 '제출 준비' 상태 이상인지 확인하세요.
• 상품을 생성한 후 2-3시간 기다려보세요.

iTunes Store에 연결할 수 없습니다.:

• 샌드박스 계정이 올바르게 구성되었는지 확인하세요.
• 디바이스가 인터넷에 연결되어 있는지 확인하세요.
• Try signing out and back into sandbox 계정에 로그인하세요
• 앱을 다시 시작하세요

구매가 실패하는 경우:

• Xcode 콘솔에서 오류 메시지를 확인하세요
• In-App 구매 기능이 활성화되어 있는지 확인하세요
• Apple ID가 아닌 sandbox 계정 이메일을 사용하세요
• 새로운 sandbox 테스트 계정을 생성해 보세요

수신증명 오류:

• 테스트 시 sandbox 수신증명 엔드포인트를 사용하세요
• 생산 엔드포인트: https://buy.itunes.apple.com/verifyReceipt
• 테스트 엔드포인트: https://sandbox.itunes.apple.com/verifyReceipt
• native-purchases 플러그인은 이 작업을 자동으로 처리합니다

잘못된 구독 기간:

• 테스트 환경에서 구독은 가속되므로 기억해 두세요.
• 위의 변환 차트를 참조하여 예상 기간을 확인하세요.
• 테스트 환경에서 구독은 최대 6번 자동 갱신됩니다.

“이 애플 ID는 아직 iTunes Store에서 사용되지 않았습니다.”:

• 새로운 테스트 환경 계정의 경우 정상입니다.
• 계정을 활성화하기 위해 구매를 계속하세요.
• 첫 번째 사용 시에만 발생합니다.

Best Practices

1. 다양한 테스트 시나리오를 위해 여러 개의 테스트 계정을 생성하세요. __CAPGO_KEEP_0__
2. 모든 구독 기간을 테스트하여 동작을 확인합니다. 구독 동작을 확인하기 위해
3. 취소 및 갱신 흐름을 테스트합니다. 구독 취소 및 갱신 흐름을 테스트합니다.
4. 구독 수령 확인이 올바르게 작동하는지 확인합니다. 구독 수령 확인이 올바르게 작동합니다.
5. 구매 복원 기능을 테스트합니다. 구매 복원 기능을 테스트합니다.
6. 구독 업그레이드/다운그레이드 동작을 확인합니다. 구독 업그레이드/다운그레이드 동작을 확인합니다.
7. 네트워크 조건이 좋지 않은 경우 테스트합니다.

Production 환경과 Sandbox 환경을 비교합니다.

기능	샌드박스	제작
실제 요금	아니요	예
구독 기간	가속	일반
자동 갱신 제한	6회	무제한
취소 효과	즉시	기간 종료
수령지 엔드포인트	샌드박스 URL	프로덕션 URL
테스트 계정만	예	아니오

추가 리소스

For more details, refer to the official Apple StoreKit 문서 on sandbox testing.

Keep going from Configure iOS Sandbox Testing

If you are using Configure iOS Sandbox Testing 을 사용하여 스토어 승인 및 배포를 계획하고 있다면 Using @capgo/native-purchases native 기능을 위한 @capgo/native-purchases의 구현 @capgo/capacitor-in-app-review native 기능 구현에 대한 @capgo/capacitor-in-app-review의 구체적인 내용 Using @capgo/capacitor-앱 내 리뷰 for the native capability in Using @capgo/capacitor-앱 내 리뷰, @capgo/capacitor-네이티브 마켓 for the implementation detail in @capgo/capacitor-네이티브 마켓, and Using @capgo/capacitor-네이티브 마켓 for the native capability in Using @capgo/capacitor-네이티브 마켓.