Configure iOS 샌드박스 테스트에서 계속

GitHub

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

iOS 샌드박스 테스트를 위해 App Store Connect 및 테스트 장치에 대한 올바른 구성이 필요합니다. 이 가이드는 샌드박스 테스트를 시작하기 위해 필요한 모든 것을 다룹니다.

사전 조건

애플 개발자 프로그램: 연간 갱신을 위한 활성 회원
동의서: 은행 및 세금 정보를 완료한 "유료 애플리케이션 동의서"에 서명
Xcode 프로젝트: 올바른 번들 식별자와 기능성으로 구성

설치 과정

애플 결제 계약서에 서명하세요

앱 스토어 연결에서 계약, 세금, 은행 및 완료:
- 애플 결제 계약서에 서명하세요
- 은행 정보를 추가하세요
- 세금 관련 양식을 완료하세요
애플이 정보를 승인하기까지 24-48시간이 걸릴 수 있습니다.
샌드박스 테스트 사용자를 생성하세요

앱 스토어 연결에서 사용자 및 액세스 > 샌드박스 테스트러.

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

중요Apple ID와 연관된 이메일 주소를 사용하지 마세요. 이메일 별칭을 사용할 수 있습니다.
- Gmail: youremail+test@gmail.com
- iCloud: youremail+test@icloud.com
설정

iOS 12부터는 iTunes 계정에서 로그아웃하지 않아도 구매 테스트가 가능합니다.

iOS 기기에서:
1. 열기 설정
2. 누르기 App Store
3. 하단으로 스크롤하세요
4. 클릭 샌드박스 계정
5. 샌드박스 테스트 계정으로 로그인하세요
이 방법은 iTunes 계정에서 로그아웃하는 것보다 훨씬 편리합니다!
Xcode 프로젝트 설정

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

Bundle Identifier
- Developer Center에 등록된 식별자와 일치해야 합니다
- App Store Connect의 식별자와 일치해야 합니다.
인앱 구매 기능
1. Xcode에서 프로젝트를 선택하세요.
2. Xcode에서 인증 및 기능
3. 클릭 + 기능
4. 추가 인앱 구매
인앱 구매 제품 만들기

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

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

테스트 기기에서 앱을 빌드하고 실행하세요. 구매 시도 시 다음과 같은 결과를 확인해야 합니다.

[환경: 샌드박스]

샌드박스 환경에서 이 확인 메시지는 실제 돈을 청구하지 않음을 의미합니다.

중요한 참고 사항

샌드박스 환경의 특징

실제 청구 없음: 샌드박스 모드에서 모든 구매가 무료입니다.
가속된 구독: 구독 기간이 더 짧아 빠른 테스트를 위해 제공됩니다.
- 1주간 구독 = 3분
- 1개월 구독 = 5분
- 2개월 구독 = 10분
- 3개월 구독 = 15분
- 6개월 구독 = 30분
- 1년 구독 = 1시간
자동 갱신 제한: 샌드박스에서 구독이 6회 자동 갱신됩니다.
즉시 취소: 취소된 구독은 즉시 만료됩니다.

샌드박스 계정 관리

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

사andbox 테스트를 사용하는 방법

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

인증

사andbox 배너

구매 중: '[환경: 사andbox]' 사andbox 배너
제품이 로드됩니다. 성공적으로 로드됩니다.
구매가 완료됩니다. 실제 요금이 청구되지 않습니다.
영수증이 올바르게 검증됩니다. 영수증이 올바르게 검증됩니다.
구독이 자동으로 갱신됩니다. 자동 갱신 속도가 가속됩니다.

문제 해결

제품이 로드되지 않습니다:

App Store Connect의 번들 식별자가 일치하는지 확인하세요.
구매 동의서가 서명되고 승인되었는지 확인하세요.
제품이 최소 '제출 준비' 상태인지 확인하세요.
제품을 생성한 후 2-3시간 기다려보세요.

“Cannot connect to iTunes Store”:

샌드박스 계정이 올바르게 구성되었는지 확인하세요.
장치가 인터넷에 연결되어 있는지 확인하세요.
샌드박스 계정에서 로그아웃하고 다시 로그인해 보세요.
앱을 다시 시작하세요.

구매가 조용히 실패하는 경우:

Xcode 콘솔에서 오류 메시지를 확인하세요.
In-App Purchase 기능이 활성화되어 있는지 확인하세요.
샌드박스 계정 이메일이 실제 Apple ID가 아닌지 확인하세요.
새 샌드박스 테스트 계정을 만들기 위해 시도해 보세요

수신증명 오류:

테스트 중에 샌드박스 수신증명 엔드포인트를 사용하세요
생산 엔드포인트: https://buy.itunes.apple.com/verifyReceipt
샌드박스 엔드포인트: https://sandbox.itunes.apple.com/verifyReceipt
네이티브-구매 플러그인은 이 작업을 자동으로 처리합니다

잘못된 구독 기간:

샌드박스에서 구독은 가속되므로 구독 기간을 기억하세요
샌드박스에서 구독은 최대 6회 자동 갱신됩니다
“이 애플 ID는 아직 iTunes Store에서 사용되지 않았습니다”:

새 샌드박스 계정의 경우 이게 정상입니다

__CAPGO_KEEP_0__
구매를 완료하여 계정을 활성화하세요.
처음 사용할 때만 발생합니다.

최선의 방법

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

제품 버전 vs. 샌드박스 버전

기능	샌드박스	제품 버전
실제 요금	아니오	__CAPGO_KEEP_0__
구독 기간	속도 향상	일반
자동 갱신 제한	6회	무제한
취소 효과	즉시	기간 종료
영수증 엔드포인트	샌드박스 URL	생산 URL
테스트 계정만	예	아니오

추가 리소스

자세한 내용은 공식 애플 스토어 키트 문서를 참조하십시오. 샌드박스 테스트에 대한

설정 iOS 샌드박스 테스트에서 계속

Capacitor를 사용하는 경우 iOS 샌드박스 테스트 설정 스토어 승인 및 배포를 계획하고, Using @capgo/native-purchases for the native capability in Using @capgo/native-purchases, @capgo/capacitor-in-app-review for the implementation detail in @capgo/capacitor-in-app-review, Using @capgo/capacitor-in-app-review for the native capability in Using @capgo/capacitor-in-app-review, @capgo/capacitor-native-market for the implementation detail in @capgo/capacitor-native-market, and Using @capgo/capacitor-native-market for the native capability in Using @capgo/capacitor-native-market.