Webshop Implementation Guide

1. What is ONE Webshop?

ONE Webshop is an official web-based storefront service provided by ONE store that enables developers to sell game items through a web environment.

• ONE Webshop is not a replacement for in-app purchases. It is a complementary sales channel that allows developers to extend their commerce experience through their own channels.

• The ONE Webshop product URL can be linked not only through the developer's own marketing channels but also within the ONE store distribution app, supporting user conversion across various touchpoints.

Key Features

• Link integration available through developer marketing channels and the ONE store distribution app

• Low commission with PG fees included

• Accessible from any browser on PC, Android, and iOS

• Quick integration using the same server API specification as in-app purchases

• One-stop management of registration, review, settlement, and CS through Developer Center

Webshop Detail Page URL

https://webshop.onestore.net/title/{PID}

Developers can use this URL across their own marketing channels (in-game, official website, community, etc.).

2. Correct Placement of IAP Store and Webshop

The webshop entry point can be provided directly within the game app. However, the following principle must be strictly observed.

Key Principle

• Displaying webshop navigation paths or products within the in-app purchase store page is not allowed.

• The webshop entry point must be configured as a separate path, functionally independent from the in-app purchase store.

3. Correct Navigation When Entering the Webshop

When clicking the webshop button in-game, it must be implemented by calling the ONE Webshop title detail page.

Key Principle

• Directly displaying or listing specific webshop items within the game app is not allowed.

Allowed Navigation Methods

Outside of the IAP store, the following formats may be freely used:

• Button (e.g., Go to Webshop)

• Text link

• Popup / Dialog

• Menu item

• Banner image, etc.

4. UX Optimization Tips

• We recommend providing a brief transition popup before navigating to the webshop (between the Webshop button click and the Webshop detail page).

• ONE Webshop supports automatic game ID linking when navigating from the game to the webshop, allowing users to purchase without manually entering their game ID. For detailed integration instructions, refer to User Information Integration guide.

Privacy Notice

If the game ID constitutes personal information under your privacy policy, you may need to add a third-party data sharing consent message. Please review your privacy policy and applicable regulations.

5. Utilizing the Webshop Detail Page

This section describes the features available on the ONE Webshop detail page that developers can leverage.

5-1. Top Banner Area

You can register a representative game image or promotional image. Use this area for:

• Featured webshop item announcements

• Promotion / seasonal event banners

• Limited-time sale notices

5-2. Item Badges and Discount Pricing

• Add short descriptions to each item to effectively communicate its value to users.

• Highlight featured products with badges.

Badge Type	Purpose
New	Highlight newly registered items
Best	Highlight popular / recommended items

• Set both a regular price and a sale price. The regular price will be displayed with a strikethrough, and the discounted price will be highlighted.

Example:
Regular price: 12,000 KRW  ->  Sale price: 9,600 KRW (20% off)

6. Handling Purchase Limits

The webshop cannot directly verify in-game purchase eligibility. Instead, developers can handle purchase restrictions through API responses, refer to User Validation guide.

6-1. Flow

1. User enters their game ID / server and attempts a purchase on the webshop.

2. ONE Webshop sends a purchase request to the developer server.

3. If the developer server determines the purchase is not allowed, it returns status code 1001 with a display message.

4. ONE Webshop displays the message to the user.

6-2. API Response Example

{
  "result.code": "1001",
  "result.message": "해당 계정에서 구매 가능한 횟수를 초과하였습니다." //You have exceeded the maximum number of purchases for this account.
}

6-3. Recommended Messages

Scenario	Recommended Message
Purchase limit exceeded	You have exceeded the maximum number of purchases for this account. ("해당 계정에서 구매 가능한 횟수를 초과하였습니다.")
One-time item already purchased	This item has already been purchased. ("이미 구매한 상품입니다.")
Event expired	This promotional item is no longer available.("이벤트 기간이 종료된 상품입니다.")

6-4. Pre-Purchase Notice in Item Description (Recommended)

To reduce confusion before purchase, we recommend stating purchase limits in the item description field.

Examples

• Limit 1 per account

• Daily purchase limit: 3

• 5 purchases per server per month