원스토어 인앱결제 API V5 (SDK V17) 안내 및 다운로드
개요
원스토어의 최신 인앱결제 API V5(SDK V17)가 출시되었습니다. 보다 강력하고 다양한 기능을 지원하는 최신 버전을 적용해보세요.
이 페이지는 인앱결제 API V5(SDK v17)에 대한 안내 페이지로, API V4(SDK V16) 이하 버전과 호환되지 않습니다. 인앱결제 API V4(SDK V16)에 대한 안내 및 다운로드는 여기를 클릭해주세요. If you are comfortable with English, please change the language to English from the upper right side in this page.
소개
원스토어 인앱결제란?
권장 개발 환경
용어(terminology)
버전
원스토어 인앱결제 버전 종류
원스토어 인앱결제 API V5(SDK V17)의 특징
원스토어와 구글의 인앱결제 기능 비교
인앱버전 간 호환 불가 안내 (인앱결제 API V4 > API V5로 업그레이드 미지원)
상품종류 및 결제
인앱상품의 종류
인앱결제 프로세스
원스토어 회원 로그인
원스토어 앱을 실행하여 로그인 유도
getLoginIntent 사용하여 로그인 프로세스 호출
인앱상품 구매
인앱상품 소비(consume)
월정액 상품 관리(상태변경)
사전준비
애플리케이션 ID (AID) 발급하기
정산 정보 등록
인앱상품 등록
인앱 상품 개별 등록하기
인앱 상품 일괄 등록하기
라이선스 키 및 OAuth 인증 정보 확인
샘플 앱 다운로드
인앱결제 라이브러리 추가
Android Manifest 파일 설정
원스토어 앱 설치
구현
인앱결제 서비스 인터페이스 직접 구현하기
AIDL 바인딩하기
AIDL 바인딩 해제하기
지원여부 조회하기 - isBillingSupported()
상품정보 조회하기 - getProductDetails()
구매 요청하기 - getPurchaseIntent()
구매내역 조회하기 - getPurchases()
상품 소비하기 - consumePurchase()
월정액상품 상태변경 요청하기 - manageRecurringProduct()
원스토어 로그인 요청하기 - getLoginIntent()
인앱결제 SDK를 사용해 구현하기
SDK 내 주요 클래스 정보
인앱결제 초기화 및 연결하기
지원여부 조회하기
상품정보 조회하기
구매 요청하기
구매내역 조회하기
상품 소비하기
월정액상품 상태변경 요청하기
원스토어 로그인 요청하기
소모성 형태의 상품 구현 시 주의할 점
테스트 및 보안
인앱결제 테스트 프로세스
인앱결제 테스트 화면
테스트 ID 등록/관리
테스트 ID 등록하기
테스트 ID의 결제환경 변경하기
테스트 ID 삭제하기 (개별 삭제, 일괄 삭제)
테스트 ID 설정 복사
Sandbox 환경에서의 결제 테스트 (필수)
상용테스트 환경에서의 결제 테스트 (선택)
인앱결제 테스트 결과 확인 및 결제취소
Sandbox 환경
상용테스트 환경
인앱상품 구매내역 확인 및 구매취소 요청
구매내역 확인하기
구매취소 요청 경로
구매취소 처리 프로세스 : 고객이 개발사 고객센터로 구매취소를 요청한 경우
구매취소 처리 프로세스 : 고객이 원스토어 내 '판매자에게 문의하기' 기능을 통해 구매취소를 요청한 경우
보안 및 인증
인앱 결제의 보안
원스토어 인앱결제 인증 방법
사례별 적용
관리형 상품(managed product)
월정액 상품(subscription)
영구성 상품과 기간제 상품
결제를 완료하였으나 상품(서비스)이 미지급된 경우
레퍼런스
서버 응답코드
isBillingSupported() - 지원여부 조회
getProductDetails() - 상품정보 조회
getPurchaseIntent() - 구매 요청
getPurchaseIntentExtraParam() - 구매 요청
getLoginIntent() - 로그인 요청
getPurchases() - 구매내역 조회
consumePurchase() - 상품소비 요청
manageRecurringProduct() - 월정액 상품 상태변경 요청
서버 API
원스토어 OAuth v2
OAuth v2 개요OAuth API 상세
AccessToken 발급
AccessToken 발급 예시
서버 API 상세
getPurchaseDetails (구매상품 상세조회)
getPurchaseDetailsByProductId (구매상품 상세조회)
getRecurringPurchaseDetails (월정액 구매상품 상세조회)
getLastRecurringPurchaseDetails (마지막 월정액 구매상품 상세조회)
manageRecurringPaymentStatus (자동결제해지/해지취소)
getVoidedPurchases (구매취소 내역조회)
consumePurchase (구매상품 소비)
Error Response
PNS
PNS(Payment Notification Service) 소개
PNS 수신 서버 URL 설정
PNS message format (원스토어 > 개발사 서버)
PNS message 예시
paymentMethod(원스토어 결제수단) 정의
Signature 검증 방법
UNITY 3D
원스토어 Unity Plugin 소개
원스토어 Unity Plugin
원스토어 Unity Plugin 폴더 구성
원스토어 Unity Plugin Sample 파일 구성
ONE store Unity Plugin 적용
ONE store Unity Plugin 레퍼런스
기본 동작 및 주의 사항
Unity에서 Android 로 기본 Flow
Android 에서 Unity로 기본 Flow
원스토어 Unity Plugin 메서드 및 동작 소개
Service Connect 버튼 클릭: 결제 초기화 (생성, 바인딩, 연결) 동작
isBillingSupported 버튼 클릭 : 인앱결제 API V5(SDK V17) 지원여부 확인에 대한 응답
getPurchase 버튼 클릭 : 인앱결제 API V5(SDK V17) 구매 내역 조회를 위한 메서드
getProductDetail 버튼 클릭 : 인앱결제 API V5(SDK V17) 상품 정보 조회를 위한 메서드
buyItem(Inapp) 버튼 클릭 : 인앱결제 API V5(SDK V17) 인앱 상품 구매
consume 버튼 클릭 : 인앱결제 API V5(SDK V17) 상품소비 호출 메서드
cancel/reactivate auto 버튼 클릭 : 월정액 상품(auto)의 상태변경(해지예약 / 해지예약 취소)을 호출하는 메서드
login 버튼 클릭 : 인앱결제 API V5(SDK V17) 로그인 요청을 위한 메서드
Destroy Service 버튼 클릭 : 인앱결제 API V5(SDK V17) 서비스 unbind
ONE store Unity Plugin 패키지 / Plugin 다운로드
다운로드
원스토어 인앱결제 SDK V17 다운로드
Last updated