ONE store IAP Release Notes.

Release ONE store In-app purchase SDK V21.01

ONE store In-app purchase SDK V21.01 has been released.

The major changes are as follows:

  • Issues of conflict with security solutions that check app integrity have been resolved.

  • Loading issues that occurred during the download and installation of the global ONE store app when the domestic ONE store app is already installed have been fixed.

  • Settings to change development environment during the development stage are provided. The following two settings offer an environment for development with either domestic or global ONE store:

Release ONE store IAP Library API V7(SDK V21)

ONE store IAP library API V7(SDK V21.00) has been released. The main changes are as follows.

You must apply ONE store IAP library API V7(SDK V21) to the new in-app. You can migrate the in-app applied with anything over ONE store IAP library API V5(SDK V17) to API V7(SDK V21). Since ONE store IAP API V4(SDK V16) has been designed to a structure that is different from the later versions, it cannot be migrated to ONE store IAP API V4(SDK V19).

Subscription Products

Subscription products are provided instead of the monthly auto-renewal products used in SDK V19 and below. Subscription products offer various functions that allow users to directly manage subscription products within the ONE store app, as well as various functions for developers, such as promotions to attract new users and notifications of changes in subscription status.

Release ONE store IAP Library API V6(SDK V19)

ONE store IAP library API V6(SDK V19.00) has been released. The main changes are as follows. You must apply ONE store IAP library API V6(SDK V19) to the new in-app. You can migrate the in-app applied with ONE store IAP library API V6(SDK V17) to API V6(SDK V19). Since ONE store IAP API V4(SDK V16) has been designed to a structure that is different from the later versions, it cannot be migrated to ONE store IAP API V4(SDK V19).

Remove ONE store IAP API version

You no longer need to add the in-app API version in the app's manifest. API Version meta-data will be added to IAP SDK V19.

Confirming a Purchase

For apps using ONE store IAP library API V6(SDK V19) and above, a purchase must be acknowledged within 3 days. Unless the purchase is acknowledged within 3 days, it will be judged that the item has not been normally provided, and the purchase will be canceled. You can acknowledge the purchase by using one of the following methods:

  • If the in-app is consumable, use PurchaseClient.consumeAsync().

  • If the in-app is not consumable, use PurchaseClient.acknowledgeAsync().

For Monthly auto-renewal products, you must acknowledge the purchase only for the first billing. If ONE store IAP API V6(SDK V19) has been applied, the purchase MUST be acknowledged within 3 days. Note that if the purchase is not acknowledged within 3 days, it will be canceled.

Obtain market identification code

For IAP library V6 and above, the market identification code is necessary to use Server to Server API. You can obtain the market identification code through getStoreInfoAsync().

Change PurchaseClient API

V5 (SDK V17)

V6(SDK V19)

Connect to billing module

connect

startConnection

Disconnect with billing module

terminate

endConnection

Check support status

isBillingSupportedAsync

X

Purchase in-app

launchPurchaseFlowAsync

launchPurchaseFlow

Consume in-app

consumeAsync

consumeAsync

Acknowledge in-app purchase

X

acknowledgeAsync

Purchase history of unconsumed in-app (including monthly automatic payment)

queryPurchasesAsync

queryPurchasesAsync

In-app product details

queryProductsAsync

queryProductDetailsAsync

Change monthly automatic payment status

manageRecurringProductAsync

manageRecurringProductAsync

Update or install billing module

launchUpdateOrInstallFlow

launchUpdateOrInstallFlow

Call ONE store login

launchLoginFlowAsync

launchLoginFlowAsync

Check market identification code

X

getStoreInfoAsync

Change Server API

Items

API List

API URI

변경사항

V5 (SDK V17)

V6 (SDK V19)

Change

Issue OAuth token

/v2/oauth/token

/v6/oauth/token

응답규격 중 status 필드 삭제 Http response code로 정상(200) 여부 확인

Remove

Check purchased in-app product details

/v2/purchase/details/{purchaseId}/{packageName}

N/A

보안 강화를 위하여 구매상품 상세조회 API는 삭제 구매상품 상세조회 By 인앱상품ID로 통합

Change

Check purchased in-app product details by in-app ID

/v2/purchase/details-by-productid/{purchaseId}/{packageName}/{productId}

/v6/apps/{packageName}/purchases/inapp/products/{productId}/{purchaseToken}

응답 규격에 purchaseId, acknowledgeState 필드 추가

Change

Check purchased monthly auto-renewal product details

/v2/purchase/recurring-details/{purchaseId}/{packageName}

/v6/apps/{packageName}/purchases/auto/products/{productId}/{purchaseToken}

응답규격에 acknowledgeState, lastPurchaseId, lastPurchaseState 추가 응답규격에 price, developerPayload, purchaseState 삭제

Remove

Check last purchased monthly auto-renewal product details

/v2/purchase/last-recurring-details/{purchaseId}/{packageName}

N/A

월정액 상품 구매 상세조회 API 로 통합

Change

Cancel automatic payment

/v2/purchase/manage-payment-status/{purchaseId}/{packageName}/cancel

/v6/apps/{packageName}/purchases/auto/products/{productId}/{purchaseToken}/cancel

성공처리 응답규격변경

Change

Cancel automatic payment cancellation

/v2/purchase/manage-payment-status/{purchaseId}/{packageName}/reactivate

/v6/apps/{packageName}/purchases/auto/products/{productId}/{purchaseToken}/reactivate

성공처리 응답규격변경

Change

Issue OAuth token

/v2/purchase/voided-purchases/{packageName}

/v6/apps/{packageName}/voided-purchases

API 사용성 향상을 위하여 구매취소내역 조회기준(startTime, endTime)을 구매일시에서 구매취소일시로 변경 응답규격에 purchaseToken, marketCode 추가

Remove

Check purchased in-app product details

/v2/purchase/consume/{purchaseId}/{packageName}

/v6/apps/{packageName}/purchases/all/products/{productId}/{purchaseToken}/consume

성공처리 응답규격변경

Change

Check purchased in-app product details by in-app ID

N/A

/v6/apps/{packageName}/purchases/all/products/{productId}/{purchaseToken}/acknowledge

구매 확인 API 신규 추가

Change PNS message specifications

  • To support currencies other than the Korean won, the data type of billing amount (price) has changed from Number to String.

  • To support currencies other than the Korean won, the currency code (priceCurrencyCode) of the billing amount has been added.

  • To support currencies other than the Korean won, the data type of the amount per payment method (amount) has changed from Number to String.

  • The purchaseToken, environment, marketCode fields have been added to the response specifications.

For the specification details, please refer to PNS Message Detailed Change History.

ONE store IAP Library API V5(SDK V17)

  • The API version must be specified in the 'AndroidManifest.xml' file in the developer's application as seen below.

  • For details, refer to the 'Set up Android Manifest file' part of the 'Pre-preparations for Application of ONE store In-App Purchase (IAP)' page.

  • The improvements made in API V5 (SDK V17) are as follows.

Items

Improvement Details

Description

API

Introduce the 'Consume' concept

The logic is provided to restore in the app when the item is not provided.

Support Custom PID

The developer can directly enter in-app ID (PID), and therefore he/she can generate and operate intuitive PIDs.

Provide universal IAP interface

The app that has been developed targeting other markets, can be launched on ONE store without big development efforts in coding.

Test Environment

Provide the development/commercial test environments separately

Provide the same level of ONE store test environment as the developer's review environment. In the developer's development environment, development/test can be performed by interworking with ONE store Sandbox. In the developer's commercial environment, it is available to make payment in ONE store commercial environment. If the payment is made after having logged in with the ID, which has been registered as test ID on ONE store Developer Center, the developer can freely make the purchase cancellation.

Items

Developer

Development environment

Commercial environment

ONE store test environment

Sandbox

O

-

Commercial environment (payment)

-

O

Billing Window UI

Available to select the full/pop-up billing screens

It is available to select the full or pop-up billing screens. For setting up the billing screen, refer to the 'Set up Android Manifest file' part of the 'Pre-preparations for Application of ONE store In-App Purchase (IAP)' page.

Interworking Method

Available to select IAP SDK, AIDL

It is available to directly interwork with OSS (ONE store service) by using AIDL as well as the existing SDK method.However, in the terminal in which OSS has not been installed, IAP fails to work normally.For OSS installation, refer to the 'Install ONE store app' part of the 'Pre-preparations for Application of ONE store In-App Purchase (IAP)' page.

Developer Center

Improve the function of crawling other markets' app product information.

The app that has already been registered on other markets can be easily registered on ONE store.

Provide the function of importing other markets' in-app product information.

Authentication Center

Issue/Authenticate/Manage OAuth

Data security has been strengthened when the developer's service is interworking with ONE store IAP server

Last updated