# 원스토어 인앱결제 API V6 (SDK V19) 안내 및 다운로드

원스토어의 최신 인앱결제 API V6(SDK V19)가 출시되었습니다.\
보다 강력하고 다양한 기능을 지원하는 최신 버전을 적용해보세요.

{% hint style="danger" %}
이 페이지는 인앱결제 API V6(SDK V19)에 대한 안내 페이지로, API V5를 사용중인 개발사는 API V6로 마이그레이션이 가능합니다.\
API V4(SDK V16) 이하 버전과는 호환되지 않습니다. 인앱결제 API V4(SDK V16)에 대한 안내 및 다운로드는 [여기](https://onestore-dev.gitbook.io/dev/tools/billing/old-version/v16)를 클릭해주세요.

If you are comfortable with English, please change the language to English from the upper right side in this page.
{% endhint %}

### [ **원스토어 인앱결제 개요** ](https://onestore-dev.gitbook.io/dev/tools/billing/old-version/v19/undefined) <a href="#id-apiv6-sdkv19" id="id-apiv6-sdkv19"></a>

* 원스토어 인앱결제란?
* 인앱상품의 유형
* 결제 프로세스
  * 원스토어 회원 로그인
  * 인앱상품 구매
  * 구매 확인&#x20;
  * 월정액 상품 관리(상태변경)
* 권장 개발 환경

### [**원스토어 인앱결제 적용을 위한 사전준비**](https://onestore-dev.gitbook.io/dev/tools/billing/old-version/v19/undefined-1)[ ](https://dev.onestore.co.kr/wiki/ko/x/e4J_/) <a href="#id-apiv6-sdkv19" id="id-apiv6-sdkv19"></a>

* 상품 등록하기&#x20;
* 정산 정보 등록하기&#x20;
* 인앱상품 등록하기&#x20;
* 라이선스 키(Public Key) 및 OAuth 인증 정보 확인하기&#x20;
* 샘플 앱 다운로드하기&#x20;
* 인앱결제 라이브러리 추가하기&#x20;
* 원스토어 앱 설치하기&#x20;

<br>

### [**원스토어 인앱결제 적용하기**](https://onestore-dev.gitbook.io/dev/tools/billing/old-version/v19/undefined-2) <a href="#id-apiv6-sdkv19" id="id-apiv6-sdkv19"></a>

* 원스토어 인앱결제 SDK 라이브러리 추가하기
* 원스토어 결제 화면 설정
* 원스토어 인앱결제 초기화 및 연결하기
* 상품 상세정보 조회하기
* 구매 요청하기
* 구매 확인하기
* 관리형 상품 소비하기
* 구매내역 조회하기
* 월정액 상품 상태 변경하기
* 원스토어 로그인 요청하기
* 원스토어 서비스 설치하기
* 마켓 구분 코드 얻기
* 에러코드 정의

### [**인앱결제 테스트 및 보안**](https://onestore-dev.gitbook.io/dev/tools/billing/old-version/v19/undefined-4) <a href="#id-apiv6-sdkv19" id="id-apiv6-sdkv19"></a>

* 개요
* 인앱결제 테스트 프로세스
* 인앱결제 테스트 화면
* 테스트 ID 등록/관리
* Sandbox 환경에서의 결제 테스트 (필수)&#x20;
* 상용테스트 환경에서의 결제 테스트 (선택)&#x20;
* 인앱결제 테스트 결과 확인 및 결제취소
* 인앱상품 구매내역 확인 및 구매취소 요청&#x20;
* 보안 및 인증

<br>

### [**원스토어 인앱결제 서버 API (API V6)**](https://onestore-dev.gitbook.io/dev/tools/billing/old-version/v17/api) <a href="#id-apiv6-sdkv19-api-apiv6" id="id-apiv6-sdkv19-api-apiv6"></a>

* 개요&#x20;
* 원스토어 OAuth&#x20;
* 서버 API 상세&#x20;
  * getPurchaseDetails (구매상품 상세조회)
  * getRecurringPurchaseDetails (월정액 상품 구매 상세조회)&#x20;
  * acknowledgePurchase (구매상품 확인)&#x20;
  * consumePurchase (구매상품 소비)
  * cancelRecurringPurchase (자동결제 해지요청)&#x20;
  * reactiveRecurringPurchase (자동결제 해지 취소요청)&#x20;
  * getVoidedPurchases (구매취소내역 조회)&#x20;
* 표준응답규격
* 공통 코드&#x20;

<br>

### [**PNS(Payment Notification Service) 이용하기** ](https://onestore-dev.gitbook.io/dev/tools/billing/old-version/v17/pns-payment-notification-service) <a href="#id-apiv6-sdkv19-pns-paymentnotificationservice" id="id-apiv6-sdkv19-pns-paymentnotificationservice"></a>

* 개요&#x20;
* PNS 수신 서버 URL 설정
* PNS 상세&#x20;
  * PNS 메시지 발송 규격 (원스토어 → 개발사 서버)&#x20;
  * paymentMethod(원스토어 결제수단) 정의
  * Signature 검증 방법
  * Notification 전송 정책

### [**Unity에서 원스토어 인앱결제 사용하기** ](https://onestore-dev.gitbook.io/dev/tools/billing/old-version/v19/unity) <a href="#id-apiv6-sdkv19-unity" id="id-apiv6-sdkv19-unity"></a>

* 개요
* 원스토어 Unity 플러그인 설정&#x20;
* Unity Plugin 구성
  * Assets > Plugins > Android
  * Assets > Scripts > Purchase
  * Assets > StreamingAssets
* 게임에 원스토어 인앱결제 라이브러리 적용하기
  * 원스토어 인앱결제 초기화 및 연결하기
  * 상품정보 조회하기
  * 구매 요청하기&#x20;
  * 구매 확인하기&#x20;
  * 관리형 상품 소비하기&#x20;
  * 구매내역 조회하기&#x20;
  * 월정액 상품 상태 변경하기&#x20;
  * 원스토어 로그인 요청하기&#x20;
  * 원스토어 서비스 설치하기&#x20;
  * 마켓 구분 코드 얻기&#x20;

### [**Unreal에서 원스토어 인앱결제 사용하기** ](https://onestore-dev.gitbook.io/dev/tools/billing/old-version/v19/unreal) <a href="#id-apiv6-sdkv19-unreal" id="id-apiv6-sdkv19-unreal"></a>

* 개요
* Unreal Plugin 구성&#x20;
* 응답 규격
  * Product
  * Purchase
* Unreal Blueprint for OneStore IAP
  * One Store Disconnect
  * One Store Iap Get Product Details
  * One Store Iap Purchase Info
  * One Store Iap Request Purchase
  * One Store Iap Consume Purchase
  * One Store Iap Acknowledge Purchase
  * One Store Iap Manage Recurring
  * One Store Iap Get Store Code
  * One Store Iap Request Login
  * One Store Iap Request Update
  * One Store Purchase Verify
* Sample Case
  * 관리형 상품 결제 및 소비 case
  * 월정액 상품 결제 및 구매 확인 case
  * 관리형 상품 구매이력 조회 및 소비 case
  * 관리형 상품 구매이력 조회 및 구매 확인 case
  * 구매이력 조회 및 월정액 상품 상태 변경 case
  * 마켓 구분 코드 case
  * 로그인 및 업데이트 처리 case

### &#x20; <a href="#id-apiv6-sdkv19" id="id-apiv6-sdkv19"></a>

### [**Download** ](https://onestore-dev.gitbook.io/dev/tools/billing/old-version/v19/download) <a href="#id-apiv6-sdkv19-downloaddownload" id="id-apiv6-sdkv19-downloaddownload"></a>

* 원스토어 인앱결제 SDK V19 다운로드

<br>