원스토어 인앱결제 버전 소개
원스토어 인앱결제 버전 종류
원스토어 인앱결제 버전은 'API 버전'을 의미합니다.
원스토어 인앱결제에서 사용하는 다른 종류의 버전으로 'SDK 버전'이 있으며, 각각의 버전에 대한 상세한 설명은 아래와 같습니다.
API 버전 : 원스토어에서 인앱결제를 위해 사용하는 API 버전을 의미하며, 인앱결제 시스템의 큰 변경이 있을 경우 버전이 업그레이드됩니다. 본 문서는 API 버전 V5를 기준으로 작성되었으며, 'API V5'라고 부릅니다.
SDK 버전 : 원스토어 인앱 SDK의 버전을 의미하며, 개선되는 내용의 영향도에 따라 버전을 변경합니다. 본 문서는 인앱 SDK V17.01.00을 기준으로 작성되었으며, 'SDK V17'로 칭합니다.
원스토어 인앱결제 API V5(SDK V17)의 특징
API 버전은 개발사 애플리케이션의 'AndroidManifest.xml' 파일에 아래와 같이 명시되어야 합니다.
자세한 내용은 인앱결제 적용을 위한 사전준비 페이지의 'Android Manifest 파일 설정' 부분을 참고하시기 바랍니다.
API V5 (SDK V17)에서 개선된 사항은 다음과 같습니다.
API V4에서 제공하는 3가지 타입의 인앱상품은 API V5에서 두가지(관리형, 월정액)로 간소화됩니다.
API V4의 월정액 상품은 API V5의 월정액 상품과 동일하며, 나머지 상품들은 API V5에서 관리형 상품으로 구현이 가능합니다.
인앱상품 종류에 대한 상세한 내용은 인앱상품 종류 및 결제 프로세스 페이지를 참고하시기 바랍니다.
원스토어와 구글의 인앱결제 기능 비교
인앱버전 간 호환 불가 안내 (인앱결제 API V4 > API V5로 업그레이드 미지원)
원스토어 인앱결제 API V5(SDK V17)는 이전 버전과 전혀 다른 구조로 설계되었기 때문에 하위 호환성이 없습니다. 따라서, 인앱결제 API V5(SDK V17)는 신규 상품을 등록할 경우에만 적용 가능합니다.
현재 판매하고 있는 상품이 API V4(SDK V16)를 적용한 경우, 해당 인앱버전으로 계속 상품을 업데이트하고 서비스하시면 됩니다.
원스토어는 인앱결제 API V4(SDK V16)에 대한 결제 서비스도 지속적으로 제공합니다.
개발사의 인프라가 API V4(SDK V16)에 최적화되어 있어 당장 새로운 환경으로 변경하기 힘들 경우, 유예기간 내에는 API V4(SDK V16)를 적용한 신규 상품을 등록하셔도 됩니다. 다만, 최신 인앱결제가 제공하는 다양하고 강력한 기능을 이용하기 위해 최신버전 인앱결제 API V5(SDK V17)를 적용하시는 것을 권장합니다.
Last updated