App Store Connect Group Purchases 샌드박스는 어떻게 검수하나요? 2026 가이드

구독 구매는 성공하지만 초대받은 구성원의 권한까지 맞는지 확인하기 어렵습니다.
먼저 StoreKit 2와 앱의 구매·좌석·권한 기준을 준비하고, 실제 Group Purchases 샌드박스 검수는 Apple이 테스트 기능을 연 뒤 진행하세요. 일반 구독 테스트 통과만으로 다중 좌석 흐름까지 승인된 것은 아닙니다.

iOS 구독 개발자: 기존 StoreKit 2 거래 처리에 여러 구성원의 좌석 권한을 연결해야 하는 경우에 적합합니다.
App Store Connect 관리자: 대상 구독의 설정과 샌드박스 계정 준비 상태를 점검할 수 있습니다.
CI 엔지니어: Xcode 빌드와 테스트 결과를 다시 확인할 수 있는 증거로 남기려는 경우에 참고하세요.

마지막 업데이트: 2026년 10월 31일. Apple은 Group Purchases를 2026년 11월부터 Sandbox Apple Account에서 구성하고 테스트할 수 있다고 안내했으며, App Store 정식 제공 시점은 그해 겨울로 밝혔습니다. 특정 날짜나 아직 공개되지 않은 테스트 세부사항은 단정하지 않습니다. Apple Developer 공지를 기준으로 확인하세요.

01 준비 단계: StoreKit 2와 기존 권한 동작을 기준으로 삼습니다

Apple이 소개한 Group Purchases는 StoreKit 2를 사용하는 자동 갱신 구독을 대상으로 합니다. 따라서 먼저 앱이 StoreKit 2 거래 흐름을 사용하고 있는지 확인하고, 현재 단일 사용자 구독의 구매·검증·권한 갱신이 어떻게 동작하는지 기록하세요. Apple의 Group Purchases 공식 세션에서 확인된 적용 범위를 넘겨 추정하면 안 됩니다.

Group Purchases 샌드박스는 언제부터 테스트할 수 있나요? Apple 공지에 따르면 2026년 11월부터 Sandbox Apple Account를 사용한 구성과 테스트가 가능해질 예정입니다. 다만 공지에는 구체적인 개방 날짜가 제시되지 않았으므로, 현재 이용할 수 있다고 가정하지 말고 Apple의 최신 안내와 실제 App Store Connect 화면을 확인한 뒤 테스트 일정을 확정하세요.

검수 영역 지금 기록할 기준 실제 샌드박스에서 다시 확인할 항목
구매자 구매 요청과 거래 검증의 현재 동작 다중 좌석 구매 후 앱에 전달되는 거래 정보
초대 구성원 계정 식별과 앱 내 권한 부여 기준 초대 수락 전후의 좌석 및 앱 권한
구독 상태 구독 갱신·취소에 따른 권한 변경 상태 변경 뒤 구매자와 구성원의 권한 일치 여부

단일 사용자 구독의 성공 사례를 기준선으로 보존하되, 이를 그룹 구매의 통과 증거로 재사용하지 마세요. StoreKit의 현재 권한 거래 문서는 앱이 확인할 수 있는 권한 거래를 설명하지만, 팀의 구성원 관리나 앱 내부 역할을 대신 정의하지는 않습니다.

02 설정 단계: App Store Connect에서 대상 구독을 확인합니다

App Store Connect에서 검수할 자동 갱신 구독을 찾고, 현재 구매 옵션과 그룹 구매 관련 설정을 기록하세요. 설정 항목의 이름과 이용 가능 범위는 공개된 문서 및 실제 계정 화면으로 확인해야 합니다. App Store Connect 구독 구매 옵션 안내를 기준으로 현재 설정을 대조하세요.

확인 대상 확인 방법 기록할 결과
구독 상품 검수할 구독이 올바른 앱과 연결됐는지 확인 상품 식별자와 현재 상태
구매 옵션 화면에 표시되는 그룹 구매 관련 옵션 확인 표시 여부와 변경 가능 여부
구매 방식의 구분 앱 내 그룹 구매와 조직용 대량 구매를 분리 검수 대상 및 제외 대상

앱 내 Group Purchases는 조직이 Apple Business 또는 Apple School Manager를 통해 앱을 대량으로 확보하는 절차와 같은 기능이라고 가정하지 마세요. 구매 경로와 앱 내 좌석·권한 처리를 별도로 기록해야 테스트 결과가 섞이지 않습니다.

Sandbox Apple Account는 어떤 기준으로 준비하나요? 구매자와 초대받는 구성원의 동작을 나눠 관찰할 수 있도록 역할별 테스트 계정을 준비하고, 각 계정이 수행할 작업과 기대 결과를 적어 두세요. 계정 수나 초대 흐름의 구체적인 제한은 여기서 추정하지 마세요. Apple이 실제 테스트 기능을 열면 샌드박스 인앱 구매 안내와 계정 화면에서 최신 조건을 확인하세요.

03 실제 테스트 전: 검수 항목을 실행 가능한 기준으로 바꿉니다

아래 항목은 테스트가 열리기 전에 준비할 수 있습니다. 상태 이름이나 API 동작을 미리 만들어 내기보다, 실제 화면과 공식 문서가 공개된 뒤 기대 결과를 확정하세요.

  • [ ] 프로젝트가 StoreKit 2 거래 흐름을 사용하는지 코드와 빌드 설정에서 확인합니다.
  • [ ] 단일 사용자 구독의 구매 요청, 거래 검증, 권한 부여 결과를 기록합니다.
  • [ ] 구매자와 초대 구성원의 앱 계정 및 권한 차이를 정의합니다.
  • [ ] 좌석 수와 구성원 변경을 앱에서 어떻게 반영할지 업무 규칙으로 정리합니다.
  • [ ] Sandbox Apple Account별 역할과 테스트할 동작을 기록합니다.
  • [ ] App Store Connect 설정 화면과 확인 날짜를 보관합니다.
  • [ ] 실제 Group Purchases 테스트가 열렸는지 Apple 공지와 계정 화면에서 확인합니다.

StoreKit 2에서 초대와 좌석 배정은 어떻게 검증하나요? 테스트 기능이 열린 뒤 공식적으로 제공되는 기본 좌석 관리 경로를 따라 구매, 초대, 수락, 좌석 배정의 각 결과를 확인하세요. 각 단계에서 화면이나 거래에 나타나는 사실과 앱이 부여한 권한을 따로 기록합니다. 아직 공개되지 않은 화면 구성이나 요청 API를 예상해 테스트 코드에 고정하지 마세요. Apple의 WWDC Group Purchases 설명을 재확인해 실제 지원 경계에 맞추세요.

04 샌드박스 시범 실행: 구매자와 구성원의 상태를 따로 대조합니다

테스트가 가능해지면 구매자 작업과 구성원 작업을 분리해 실행하세요. 초대 전후에 앱이 표시하는 좌석 상태, 거래 검증 결과, 앱 내부 권한을 각각 보관합니다. 구성원 변경이나 구독 취소처럼 제품에서 지원할 상태 변화도 같은 방식으로 추적합니다. 어떤 상태가 언제 전달되는지에 관한 세부 동작은 공개된 공식 안내와 실제 결과로 확인해야 합니다.

실행 흐름 비교할 관찰값 실패 증거로 남길 내용
구매 거래 검증과 구매자 권한 오류 메시지, 로그, 계정 역할
초대 및 수락 좌석 배정과 구성원 권한 수락 전후 화면과 시간 순서
구성원 변경 또는 취소 변경 전후 권한과 서비스 상태 서버 알림, 앱 처리 결과, 불일치 지점

기본 좌석 관리와 자체 구성원 관리 기능은 같은 것으로 취급하지 마세요. 자체 흐름을 구현한다면 공개된 지원 범위를 확인한 뒤 연결해야 합니다. 예를 들어 App Store Server API의 그룹 구성원 조회 문서는 해당 기능이 공개된 뒤 요청 및 응답 의미를 검토할 자료입니다. 앱 서버가 받은 이벤트는 App Store Server Notifications 안내와 대조하고, 문서에 없는 상태 전이나 호출 순서는 가정하지 마세요.

05 CI 검증 단계: 시뮬레이션과 Apple 샌드박스 결과를 분리합니다

Xcode CI에서 거래와 사용자 권한을 어떻게 다시 확인하나요? 빌드 커밋, Xcode 환경, 테스트 방식, 테스트 계정 유형, 실행 결과를 한 묶음으로 보관하세요. StoreKit 구성 파일 등을 이용한 개발 단계 검증과 Sandbox Apple Account를 통한 Apple 샌드박스 검증은 목적과 증거가 다릅니다. 전자의 통과 기록을 실제 다중 구성원 구매 검수로 표시하지 마세요. Apple의 Xcode 및 샌드박스 단계별 테스트 문서에 따라 어떤 환경에서 무엇을 검증했는지 구분하세요.

CI 기록에는 로그만 남기지 말고 테스트 계정 역할, 실행한 경로, 기대 결과, 실제 결과, 실패 시 재현 방법을 함께 적으세요. 비밀 정보와 계정 인증 정보는 로그나 산출물에 포함되지 않도록 마스킹해야 합니다. 이 문서는 특정 CALMVPS 장비나 원격 Mac에서 수행한 실측 결과를 제공하지 않으므로, 해당 환경의 성능이나 실행 성공을 주장하지 않습니다.

06 출시 판단 단계: 증거가 모일 때까지 범위를 제한합니다

구매 성공 하나만으로 기능을 출시하지 마세요. 거래 검증, 구매자와 구성원의 권한 일치, 좌석 생애주기, 실패 후 복구를 각각 확인해야 합니다. 다음 판단표에서 미확인 항목이 남으면 전체 기능 출시 대신 제한된 시험이나 출시 보류를 선택하세요.

판단 결과 적용 조건 다음 조치
시험 진행 샌드박스 기능이 열렸고 계정과 시나리오가 준비됨 역할별 흐름을 실행하고 증거 보관
제한적 출시 검토 핵심 거래와 권한은 확인됐으나 일부 복구 경로가 미검증 미검증 범위를 제한하고 추가 검증
보류 기능 접근, 거래 검증, 구성원 권한 중 핵심 증거가 없음 공식 문서와 테스트 가능 상태를 재확인

Apple의 정식 App Store 제공 시점은 공지상 2026년 겨울입니다. 실제 배포 시점과 샌드박스 세부사항은 이후 공개되는 자료로 다시 확인해야 합니다. CALMVPS 요금 안내를 살펴볼 수는 있지만, 비용뿐 아니라 테스트 기간과 상시 운영 필요성도 함께 따져야 합니다.

로컬 Mac만으로 검수하면 개발자의 장비에 테스트 환경이 묶이고, 성능이 부족한 장비에서는 반복 빌드가 부담이 될 수 있으며, CI를 계속 유지하려면 유휴 시간과 운영 관리도 고려해야 합니다. 반면 원격 Mac 임대는 짧은 검증 기간에 별도 Mac 환경이 필요한 팀에 선택지가 될 수 있지만, 장기 상시 부하나 물리 기기 연결이 필수라면 구매 또는 자체 운영이 더 적합할 수 있습니다. Xcode를 실행할 Mac 환경이 부족하고 일시적인 빌드·테스트 노드가 필요하다면 CALMVPS Mac 환경 신청 안내를 확인한 뒤, 실제 Group Purchases 샌드박스 접근 여부와 팀의 보안·운영 요건을 먼저 대조하세요.