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 서명 표준화로 서명 구현 복잡성 줄이기

결론

  • appTransactionIdJWS 서명, V2 환불 엔드포인트를 적극 활용해 인앱 구매 시스템의 유연성과 안정성 확보
  • 부분 환불 (GRANT_PRORATED) 기능을 통해 고객 요구에 맞춘 정확한 환불 처리 가능
  • 모든 제품 유형 지원을 통해 구독, 소비형 등 다양한 상품 유형의 환불 처리를 간소화할 수 있음