> For the complete documentation index, see [llms.txt](https://onestore-dev.gitbook.io/dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://onestore-dev.gitbook.io/dev/webshop/overview.md).

# ONEshop 소개

## ONEshop이란 <a href="#id" id="id"></a>

ONEshop은 원스토어 계정 기반의 웹 결제 플랫폼입니다.

PC·iOS·Android 등 다양한 환경에서 플랫폼 제약 없이 게임 아이템 결제를 제공하며,\
개발사에는 매출 확장 기회를, 사용자에게는 편리한 결제 경험을 제공합니다.

***

## ONEshop 플로우 <a href="#id" id="id"></a>

사용자가 게임에서 웹샵으로 이동하면 게임ID·서버 정보를 전달하고, 원스토어 회원을 연동할 수 있어 매끄러운 결제 경험을 제공할 수 있습니다.

아이템을 구매하면 사용자가 입력한 게임ID·서버 정보가 유효한지 검증할 수 있으며,결제가 완료되면 아이템 지급을 위한 구매 결과를 개발사 서버로 전달합니다.

<figure><img src="/files/fTKMZtAHFgv89CCQrNOZ" alt=""><figcaption></figcaption></figure>

### 1. ONEshop 진입

인게임에서 웹샵으로 이동할 때 [사용자 정보 연동](/dev/tools/webshop/app-links.md)을 활용하면\
원스토어 회원 연동이 가능할 경우, 게임 ID·서버 정보가 자동으로 전달되어 별도의 로그인 절차 없이 아이템을 구매할 수 있습니다.

<figure><img src="/files/ZznPozLnL3V9KcyBm13y" alt=""><figcaption></figcaption></figure>

### 2. 아이템 구매

아이템을 지급받을 게임 ID와 서버를 입력한 뒤 결제 화면에서 결제를 진행할 수 있으며,\
기존 원스토어에 등록한 결제수단을 그대로 사용할 수 있습니다.

<figure><img src="/files/wuZXLTExbznbG65LGLlw" alt=""><figcaption></figcaption></figure>

***

## ONEshop 입점 프로세스

모바일 앱과 동일한 방식으로 [원스토어 개발자센터](https://dev.onestore.net/)에서 웹샵에 판매할 아이템을 등록하고 판매를 시작할 수 있습니다.

<figure><img src="/files/WJGXSlMZlFqofqEDpZHY" alt=""><figcaption></figcaption></figure>

### 1. 타이틀 ∙ 아이템 등록

원스토어 개발자센터에서 타이틀과 아이템을 등록하세요. 게임 바이너리 없이 타이틀 정보만 입력해도 됩니다.\
또한 대량의 아이템 등록을 위해 인앱 상품 가져오기와 일괄 등록 기능을 지원합니다.

상세 가이드는 [신규로 타이틀 등록하기](/dev/webshop/register-title.md) / [아이템 등록](/dev/webshop/register-item.md) 가이드 문서를 참고하세요.

<figure><img src="/files/zv1l4ktjCXwO1xzxNFWI" alt=""><figcaption></figcaption></figure>

### 2. 필수 API 연동

아이템을 구매한 사용자의 게임ID∙서버 정보가 유효한지 검증하고 웹샵의 구매 결과를 확인하기 위해서는 API 연동이 필수적으로 필요합니다.

상세 가이드는 [웹샵 연동 가이드](/dev/tools/webshop.md) 문서를 참고하세요.

<table><thead><tr><th width="148.7525634765625">API</th><th width="176.912353515625">Data flow</th><th>Description</th></tr></thead><tbody><tr><td><a href="/pages/ot9ZonGLBYTAoyFKGT7B">서버 리스트 연동</a></td><td>게임 서버 → ONEshop</td><td>사용자가 웹샵 상세 화면에 진입 시, 실시간으로 게임 서버 목록을 조회하여 노출합니다.</td></tr><tr><td><a href="/pages/Ldqaq9SSkPQrBCZvsK1j">유효성 검증</a></td><td>게임 서버 → ONEshop</td><td>사용자가 입력한 ‘게임ID’,’서버'의 유효성과 아이템 구매 가능 여부를 검증합니다.</td></tr><tr><td><a href="/pages/oRU887QZeredzPY8ym9m#pns">PNS</a></td><td>ONEshop → 게임 서버</td><td><p>사용자가 결제를 완료하면, 결제 결과와 관련 결제 정보를 PNS 알림으로 게임 서버에 전달합니다.</p><p>PNS는 상용과 Sandbox 결제 환경을 모두 지원합니다.</p></td></tr><tr><td><a href="/pages/oRU887QZeredzPY8ym9m#purchase">구매 확인</a></td><td>게임 서버 → ONEshop</td><td><p>아이템이 정상적으로 지급되었음을 확인하기 위해 구매확인 처리는 반드시 진행해야 합니다.</p><p>구매확인은 목적에 따라 consume 또는 acknowledge API 중 하나를 사용할 수 있습니다.</p><p><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span> 아이템 지급 후에는 반드시 구매확인을 처리해야 합니다.</p></td></tr><tr><td><a href="/pages/cTEDZ2HycCC1VsqTvTJk">사용자 정보 연동</a><br>(Optional)</td><td>게임 앱 → ONEshop</td><td><p>게임 내에서 웹샵으로 이동하는 경로를 노출할 수 있습니다.</p><p>이동 URL에 사용자의 게임ID와 서버 정보를 포함하면, 웹샵 진입 시 원스토어 로그인 상태와 구매 입력 정보가 자동 적용되어 바로 구매를 진행할 수 있습니다.<br><br><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span> 편리한 결제 환경을 위해 사용자 정보 연동을 권장합니다.</p></td></tr></tbody></table>

### 3. 웹샵 테스트

웹샵은 정식 판매 전에 웹샵 화면과 결제 흐름을 사전에 검증할 수 있습니다.

상세 가이드는 [웹샵 테스트](/dev/webshop/test.md) 문서를 참고하세요.

{% hint style="warning" %}
웹샵 판매를 위해 최초 1회 Sandbox 결제 테스트를 반드시 진행해야 합니다.
{% endhint %}

<figure><img src="/files/1c4HCRT6IxB4mMdWKCfb" alt=""><figcaption></figcaption></figure>

### 4. 검증 요청 ∙ 5. 판매 시작

웹샵 테스트를 마치고 원스토어 개발자센터에서 검증 요청을 진행하면 검증 완료 후 원하는 날짜에 판매를 시작할 수 있습니다.

상세 가이드는 [검증 요청하기](/dev/webshop/request-for-review.md) 문서를 참고하세요.

<figure><img src="/files/VbSEfck3GRo6hTqB74aZ" alt=""><figcaption></figcaption></figure>