WWDC 2025 - 앱 스토어 서버 API 업데이트: 인앱 구매 관리
카테고리
프로그래밍/소프트웨어 개발
서브카테고리
앱 개발
대상자
앱 개발자, 특히 인앱 구매 시스템을 구축하거나 관리하는 중급 이상 개발자
핵심 요약
appTransactionId
: 애플 계정당 앱별로 전역적으로 고유한 식별자로, 재다운로드, 환불, 가족 공유 등 모든 시나리오에서 일관된 식별 가능- JWS 통합 서명 : 모든 사용 사례에 걸쳐 JSON Web Signature (JWS) 형식을 통일하여 서명 복잡성 감소
- V2 환불 엔드포인트 : 입력 필드 5개로 간소화, 모든 제품 유형(구독, 소비형 등) 지원,
GRANT_PRORATED
옵션 추가
섹션별 세부 요약
1. 앱 트랜잭션 식별자 (`appTransactionId`)
- 애플 계정당 앱별로 생성되며, 재다운로드, 환불, 가족 공유 등 모든 시나리오에서 일관된 식별자 제공
- 가족 공유 시 각 가족 구성원에게 고유 ID 할당
- 앱 내외부 구매(예: 오퍼 코드 사용) 시
Set App Account Token
엔드포인트로 토큰 설정 가능
2. 서명 프로세스 간소화
- JWS 통합 서명 도입: 모든 StoreKit 기능 및 고급 상거래 API에서 일관된 서명 형식 적용
- 프로모션 오퍼 서명 : 필수 입력값 감소, 사용자 정의 자격 조건을 위한 새로운 JWS 서명 제공
3. 환불 처리 개선 (V2 엔드포인트)
- 필수 입력값 5개로 감소 (V1 대비 12개에서 5개로)
- 모든 제품 유형 (구독, 소비형 등) 지원, 부분 환불 (
GRANT_PRORATED
) 옵션 추가 - 환불 비율 (
refundPercentage
) 및 취소 유형 (revocationType
) 포함된 통지 데이터 제공
4. 새로운 기능 활용 권장사항
appTransactionId
를 주요 트랜잭션 식별자로 사용하여 계정 연계 간소화- V2 엔드포인트로 마이그레이션하여 환불 처리 복잡성 감소
- 부분 환불 기능을 활용해 고객 만족도 향상
- JWS 서명 표준화로 서명 구현 복잡성 줄이기
결론
appTransactionId
와 JWS 서명, V2 환불 엔드포인트를 적극 활용해 인앱 구매 시스템의 유연성과 안정성 확보- 부분 환불 (
GRANT_PRORATED
) 기능을 통해 고객 요구에 맞춘 정확한 환불 처리 가능 - 모든 제품 유형 지원을 통해 구독, 소비형 등 다양한 상품 유형의 환불 처리를 간소화할 수 있음