한국어

인앱결제 적용을 위한 사전준비

애플리케이션 ID (AID) 발급하기

  • 원스토어 개발자센터 > APPS 페이지에 접속하여 상품 등록 버튼을 클릭하고 상품을 등록합니다.

  • 상품을 등록하면 애플리케이션 ID(AID)가 발급됩니다.

정산 정보 등록

  • 유료 상품(인앱상품)을 등록하여 판매하기 위해서는, 우선 정산 정보를 등록해야 합니다.

  • 회원 유형 별로 입력하는 정보나 제출해야 하는 서류가 다를 수 있습니다. 개발자 회원 관련 자세한 내용은 개발자 가이드 문서 내 회원 파트를 참고하시기 바랍니다.

    • 정산 정보 : 개발자센터 > 회원정보 관리 > 회원정보의 정산정보 탭 클릭

    • 사업자 회원은 정산정보를 등록하신 후 운영자의 승인을 받아야 합니다.

인앱상품 등록

  • 개발자센터 > APPS > In-App정보 페이지에서 인앱상품을 등록할 수 있습니다.

  • 인앱상품은 '상품등록' 버튼을 클릭하여 하나씩 등록하거나, 파일을 업로드하여 일괄 등록할 수 있습니다.

    • 인앱 상품 개별 등록하기

      • In-App정보 화면에서 '상품등록' 버튼을 클릭하여 인앱상품을 등록합니다.

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

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

      • In-App 상품종류 : 인앱상품의 타입(관리상품/월정액)을 선택합니다. 인앱상품 종류에 대한 상세한 내용은 인앱상품 종류 및 결제 프로세스 페이지를 참고하시기 바랍니다.

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

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

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

인앱 상품 일괄 등록하기

  • step 1> '일괄등록 양식 다운로드' 버튼을 클릭하여 양식 파일을 다운로드 합니다.

  • step 2> 다운로드한 양식에 인앱상품 정보를 입력합니다.

  • step 3> '상품 일괄등록' 버튼을 클릭하여 인앱상품 정보가 등록된 파일을 업로드합니다.

  • step 4> 인앱상품이 모두 정상적으로 등록되었는지 확인합니다.

    다운로드한 인앱상품 일괄 등록 양식에 최대 50개의 인앱상품만 등록 가능합니다. 50개 이상 등록이 필요한 경우에는 50개씩 나누어 등록하시기 바랍니다.

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

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

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

샘플 앱 다운로드

인앱결제 라이브러리 추가

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

    • 인앱결제 SDK 추가

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

      • Github에서 원스토어 인앱결제 SDK 라이브러리 다운로드

Android Manifest 파일 설정

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

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

      Example

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

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

    Example

<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+ 스토어)을 실행하시어 원스토어 클라이언트 및 원스토어 서비스를 업데이트 하시면 됩니다. (주의 : 오래된 단말의 경우 자동 업데이트가 지원되지 않을 수 있습니다)

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

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

Last updated