원스토어 SDK적용하기

원스토어 인앱결제를 적용을 하기 위하여 사전준비를 해야하는 부분이 있습니다. 

 - 애플리케이션 ID 발급받기

 - 정산 정보 등록

 - 인앱상품 등록

 - 라이선스 키 및 OAuth인증 정보 확인

 - 샘플 앱 다운로드

 - 인앱결제 라이브러리 추가

 - Android Manifest파일 설정

 - 원스토어 앱 설치

위와 같이 8개의 사전준비가 마무리 되어야 원스토어 인앱결제를 적용할 수 있습니다. 

아래 8개의 사전준비에 관련하여 설명을 드리고자 합니다. 

[애플리케이션 ID 발급받기]

애플리케이션 ID는 원스토어에서 앱을 생성을 하게 되면 바로 발급됩니다. 

앱을 생성후 애플리케이션 ID를 아래와 같은곳에서 확인이 가능합니다. 

방금 앱을 등록하였을때는 이부분에서는 애플리케이션 ID만 확인이 가능하며 APK를 업로드하게

되면 이부분에서 패키지명도 함께 확인이 가능합니다.

[정산정보 입력]

정산정보는 원스토어 개발자 센터 계정을 생성 후 회원정보 -> 정산정보에서 입력과 수정이

가능합니다.

[인앱상품 등록]

In-App정보 화면에서 "상품등록"버튼을 클릭하여 인앱상품을 등록할 수 있습니다.

• In-App ID : 해당 상품의 In-App ID를 입력하고 중복 체크를 합니다. In-App ID는 앱 내에서 유일한 값이어야 합니다.

• In-App 상품제목 : 상품의 제목을 입력합니다. 제목은 결제화면 및 구매내역에 노출됩니다.

• In-App 상품종류 : 인앱상품의 타입(관리상품/월정액)을 선택합니다. 

• In-App 상품경로 : 앱 내에서 해당 인앱상품을 확인할 수 있는 경로로, 필수 값은 아닙니다. 해당 정보는 원스토어 검증팀이 검증 시 활용합니다.

• In-App 상품가격 : 인앱상품의 판매 가격을 입력합니다. 부가세를 포함한 금액을 입력하시면 됩니다.

• 모든 입력이 완료되었으면 오른쪽 상단의 '저장' 버튼을 클릭합니다.

[라이선스 키 및 OAuth인증 정보 확인]

인앱상품 개발을 진행하면서 개발사에게 전달하여 원스토어 SDK개발시 필요한 키값입니다. 

확인 경로: 원스토어 개발자센터 -> 상품관리 -> In-App정보 -> '인증 및 라이선스' 버튼으로

확인할 수 있습니다.

• 라이선스 키 : 원스토어가 전달한 인앱결제 내역의 위변조 여부를 확인하는 용도로 사용.

• OAuth 인증 정보 : 원스토어 서버 API를 사용하기 위한 인증 용도로 사용합니다.

[샘플 앱 다운로드]

인앱결제 샘플 앱은 Github에서 다운로드 받을 수 있습니다.
Github에서 원스토어 인앱결제 API V5 (SDK V17) 샘플 앱 다운로드

[인앱결제 라이브러리 추가]

인앱결제 라이브러리는 AIDL(Android Interface Definition Language) 파일을 추가하는 방법과 원스토어 인앱결제 SDK를 추가하는 방법이 있습니다.

• AIDL 파일 추가
  • 'IInAppPurchaseService.aidl'을 개발사 앱 프로젝트 내 '/src/main/aidl/com/onestoe/extern/iap' 위치에 복사해 넣습니다.
  • Github에서 원스토어 인앱결제 AIDL 파일 다운로드

• 인앱결제 SDK 추가
  • 인앱결제 API V5 (SDK V17)를 사용할 경우, 이미 'IInAppPurchaseService.aidl' 파일이 SDK 내에 포함되어 있으므로 위 '인앱결제 서비스용 AIDL 추가' 과정이 필요하지 않습니다.
    인앱결제 SDK 라이브러리 파일을 다운로드한 후 해당 파일을 개발사 앱 프로젝트 내 'libs' 디렉터리 안에 복사합니다.
  • Github에서 원스토어 인앱결제 SDK 라이브러리 다운로드

[Android Manifest 파일 설정]

API V5 이용을 위해 필요한 AndroidManifest.xml 파일 설정은 다음과 같습니다.

• 필수
  API 버전 추가 : API V5를 명시적으로 선언해야 합니다.

?

1 2 3 4

<application ...... >   <meta-data           android:name="iap:api_version"           android:value="5" >

• 선택
  API V5에서는 인앱상품 결제 시 팝업 형태의 결제화면도 지원합니다(이전 버전까지는 전면 결제화면만 제공).
  팝업 형태의 결제화면을 원하실 경우 meta-data를 추가하여 "iap:view_option"에 "popup" 값을 설정하시면 됩니다.
  아무런 값을 세팅하지 않을 경우 디폴트로 전체 창(android:value="full")과 같은 효과가 됩니다. 

?

1 2 3

<meta-data     android:name="iap:view_option"     android:value="popup | full" >

[원스토어 앱 설치]

개발자나 사용자가 원스토어 인앱결제를 이용하기 위해서는 원스토어 서비스(ONE store Service, OSS) 앱이 필요합니다.
원스토어 서비스는 국내 통신사(SKT, KT, U+)를 통해 출시되는 안드로이드 스마트폰에는 기본적으로 탑재되어 있지만, 해외출시 단말(Pixel 등)이나 태블릿의 경우 원스토어 앱이 설치되어 있지 않습니다.
원스토어 인앱결제 모듈을 개발하는 단말의 상황에 따라 다음의 가이드를 이용하여 원스토어 서비스를 다운로드 받아 최신 상태로 만들어 주어야 합니다.

• 국내 통신사에서 출시된 스마트폰
  통신사를 통해 출시된 안드로이드 스마트폰의 경우 원스토어 앱들이 기본 탑재되어 있습니다.
  개발자는 기본 탑재되어 있는 원스토어(ONE store client, OSC) 앱을 이용해 원스토어 앱들을 최신 버전으로 업데이트 할 수 있습니다.
  스마트폰에 설치 된 원스토어(or T Store or 올레 마켓 or U+ 스토어)을 실행하시어 원스토어 클라이언트 및 원스토어 서비스를 업데이트 하시면 됩니다. (주의 : 오래된 단말의 경우 자동 업데이트가 지원되지 않을 수 있습니다)

• 해외향 스마트폰/태블릿 및 제조사 유통 단말
  해외향 스마트폰이나 태블릿, 제조사 유통 단말의 경우 원스토어 앱들이 기본 탑재가 되어 있지 않기 때문에, 원스토어 클라이언트 및 원스토어 서비스를 다운 받아 설치를 해주셔야 합니다.
  다음 링크를 클릭하여 인앱결제 개발에 필요한 원스토어 앱들을 설치해 주시기 바랍니다. (모바일에서만 열립니다.)
  원스토어 클라이언트 및 서비스 다운로드 하러 가기 : http://m.onestore.co.kr/mobilepoc/etc/downloadGuide.omp?PrePageNm=/main

(주의 사항 : 원스토어 인앱결제 API V5 (SDK V17)는 Android OS버전이 4.0 이상인 안드로이드 디바이스에서 동작합니다. 인앱결제 모듈 연동 전 단말의 OS 버전을 확인해주세요.)

#위 내용중 일부 내용은 원스토어 인앱결제 메뉴얼의 내용을 응용한것입니다.