iOS 샌드박스 테스트 설정

이 플러그인에 대한 설치 단계와 전체 마크다운 가이드가 포함된 설정 프롬프트를 복사하세요.

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

사전 조건

애플 개발자 프로그램: 연간 갱신이 필요한 활성 회원
합의: 은행 및 세금 정보가 완료된 “유료 애플리케이션 계약”에 서명
Xcode 프로젝트: 적절한 번들 식별자와 기능성으로 구성되었습니다.

설치 과정

애플리케이션 수수료 계약에 서명하세요.

애플리케이션 수수료 계약에 서명하기 위해 App Store Connect에서 Agreements, Tax, and Banking 을 방문하고 완료하세요:
- Paid Applications Agreement에 서명하세요.
- __CAPGO_KEEP_0__ 정보를 추가하세요.
- __CAPGO_KEEP_1__ 세금 계산서를 완료하세요.
__CAPGO_KEEP_2__ Apple이 정보를 승인하기까지 24-48시간이 걸립니다.
__CAPGO_KEEP_3__ 샌드박스 테스트 사용자 만들기

App Store Connect에서 __CAPGO_KEEP_4__ > 샌드박스 테스트 사용자.

__CAPGO_KEEP_5__ 버튼을 클릭하여 새로운 샌드박스 테스트 사용자를 만들세요. + __CAPGO_KEEP_6__

: 샌드박스 테스트 사용자 이메일 주소를 Apple ID와 연관된 이메일 주소가 아닌 것으로 선택하세요. 이메일 별칭을 사용할 수 있습니다.__CAPGO_KEEP_7__:
- __CAPGO_KEEP_8__: youremail+test@gmail.com
- __CAPGO_KEEP_9__: youremail+test@icloud.com
__CAPGO_KEEP_1__

__CAPGO_KEEP_2__

__CAPGO_KEEP_3__
1. iOS 12 이상의 기기에서 테스트를 하려면 iTunes 계정에서 로그아웃할 필요가 없습니다. iOS 기기에서:
2. 설정 설정
3. 앱 스토어
4. 하단으로 스크롤하고 샌드박스 계정
5. 샌드박스 테스트 계정으로 로그인
이것은 iTunes 계정에서 로그아웃하는 옛 방법보다 훨씬 편리합니다!
Xcode 프로젝트 설정

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

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

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

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

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

[환경: 샌드박스]

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

중요한 참고 사항

사andbox 환경 특징

실제 요금이 없습니다모든 구매는 사andbox 모드에서 무료입니다
가속된 구독구독 기간이 단축되어 빠른 테스트를 위해 제공됩니다
- 1주 구독 = 3분
- 1개월 구독 = 5분
- 2개월 구독 = 10분
- 3개월 구독 = 15분
- 6개월 구독 = 30분
- 1년 구독 = 1시간
자동 갱신 제한: 샌드박스에서 구독이 자동 갱신됩니다. 갱신 횟수는 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);

인증

정확히 설정된 경우, 다음을 관찰해야 합니다:

샌드박스 배너 구매 시: “[환경: 샌드박스]’
상품이 로드됩니다 성공적으로
구매가 실제 요금으로 이루어지지 않습니다 영수증이 유효합니다
받은 영수증 정확하게
자동으로 갱신됩니다. 자동 갱신 속도가 가속됩니다.

문제 해결

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

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

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

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

silent 구매 실패:

Xcode 콘솔에서 오류 메시지를 확인하세요.
In-App 구매 기능이 활성화되어 있는지 확인하세요.
애플 ID가 아닌 샌드박스 계정 이메일을 사용하세요.
새 샌드박스 테스트 계정을 생성하세요.

받은금액 검증 오류:

테스트 시 샌드박스 받은금액 검증 엔드포인트를 사용하세요.
생산 엔드포인트: https://buy.itunes.apple.com/verifyReceipt
샌드박스 엔드포인트: https://sandbox.itunes.apple.com/verifyReceipt
native-purchases 플러그인은 자동으로 처리합니다.

잘못된 구독 기간:

메모: 구독은 샌드박스에서 가속됩니다.
위의 변환 차트를 참조하여 예상되는 기간을 확인하세요.
샌드박스에서 구독은 최대 6번 자동으로 갱신됩니다.

“This Apple ID has not yet been used in the iTunes Store”:

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

최선의 방법

다중 테스트 계정 생성 다양한 테스트 시나리오
모든 구독 기간을 테스트하세요 동작을 확인하기 위해
취소와 갱신 흐름을 테스트하세요 흐름
수취증명 확인이 정상적으로 작동하는지 확인하세요 정상적으로 작동하는지 확인하세요
구매 복원 테스트 기능
구독 업그레이드/다운그레이드 확인 동작
네트워크가 좋지 않은 환경에서 테스트하세요

실제 운영 vs. 테스트 환경

기능	테스트 환경	실제 운영
실제 요금	아니요	예
구독 기간	가속	일반
자동 갱신 제한	6 번	무제한
취소 효과	즉시	기간 종료
수령지 엔드포인트	샌드박스 URL	생산 URL
테스트 계정만	예	아니오

추가 리소스

자세한 내용은 공식 Apple StoreKit 문서를 참조하십시오 샌드박스 테스트에 대한