# 원스토어 인앱결제 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)에 대한 안내 및 다운로드는 [여기](/dev/tools/billing/old-version/v16.md)를 클릭해주세요.

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

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

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

### [**원스토어 인앱결제 적용을 위한 사전준비**](/dev/tools/billing/old-version/v19/undefined-1.md)[ ](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>

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

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

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

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

<br>

### [**원스토어 인앱결제 서버 API (API V6)**](/dev/tools/billing/old-version/v17/api.md) <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) 이용하기** ](/dev/tools/billing/old-version/v17/pns-payment-notification-service.md) <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에서 원스토어 인앱결제 사용하기** ](/dev/tools/billing/old-version/v19/unity.md) <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에서 원스토어 인앱결제 사용하기** ](/dev/tools/billing/old-version/v19/unreal.md) <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** ](/dev/tools/billing/old-version/v19/download.md) <a href="#id-apiv6-sdkv19-downloaddownload" id="id-apiv6-sdkv19-downloaddownload"></a>

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

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://onestore-dev.gitbook.io/dev/tools/billing/old-version/v19.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.