ONEshop 소개

ONEshop(웹샵)은 게임사가 자체 결제 채널로 아이템을 판매할 수 있도록 제공하는 웹 기반 상점입니다. Console에서 아이템·테마·섹션을 구성하면, 사용자는 별도 앱 설치 없이 브라우저에서 웹샵에 접속해 아이템을 구매할 수 있습니다.

웹샵이란

• 게임 내부 결제(인앱결제)와는 별개의 결제 채널로, 게임사가 직접 아이템·가격·프로모션을 구성해 운영할 수 있습니다.

• 프로젝트(타이틀) 단위로 운영되며, 하나의 프로젝트는 하나의 웹샵을 가집니다.

• 사용자는 로그인 없이도 아이템을 둘러볼 수 있고, 구매 시점에 게임 계정 정보(UID) 확인이 필요합니다.

ONEshop 사용자 플로우

1

웹샵 진입

사용자가 게임 내 링크 또는 직접 URL로 웹샵에 접속합니다. 사용자 정보 연동을 활용하면 게임 ID·서버 정보가 자동으로 전달됩니다. 원스토어 앱이 설치되고 로그인까지 완료된 모바일 기기라면, 원스토어 회원 연동을 통해 별도 로그인 없이 바로 아이템을 구매할 수 있습니다.

2

아이템 탐색

섹션별로 노출된 아이템·번들을 확인합니다. 국가별로 노출 통화·가격이 다르게 표시될 수 있습니다.

3

아이템 구매

아이템을 선택하면 식별 정보(UID 등)를 입력한 뒤 결제를 진행합니다. 결제가 완료되면 등록된 유효성 검증 서버로 확인 요청이 전달됩니다. 확인 후 게임 서버에서 지급이 처리됩니다.

대한민국 사용자는 원스토어 로그인을 통해 기존에 등록한 결제수단을 그대로 사용할 수 있습니다.

4

구매내역 확인

사용자는 웹샵 내에서 자신의 구매내역을 조회할 수 있습니다.

ONEshop 게임사 입점 플로우

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

1

타이틀 등록

스토어 검색 또는 직접 입력으로 프로젝트(타이틀)를 신규 등록합니다. 상세 가이드는 [신규로 타이틀 등록하기] 문서를 참고하세요.

2

타이틀 관리

기본 정보, 아이콘·대표 이미지, 판매 국가 등을 설정합니다.

3

아이템 등록

판매할 아이템을 개별 또는 CSV로 등록합니다.

4

전시 관리

웹샵 빌더에서 섹션·테마·히어로 배너를 구성합니다.

5

연동 관리

라이선스 키, 결제 알림(PNS), 유효성 검증, 서버 리스트 등 게임 서버와의 연동 정보를 등록합니다.

6

웹샵 테스트

테스트 계정으로 실제 결제 흐름을 미리 확인합니다.

7

검증 요청 및 판매 시작

검증을 요청하고, 승인되면 즉시 또는 예약 발행으로 웹샵을 공개합니다.

참고

• 프로젝트를 새로 만들 때 AI 자동 세팅 기능을 사용하면, 위 3~4단계(아이템 등록, 전시 구성)가 게임 정보를 기반으로 미리 채워진 목업 상태로 만들어집니다. 웹샵 빌더에 들어가면 완성된 모습을 바로 확인할 수 있고, 이후 언제든 직접 수정할 수 있습니다.

• AI 자동 세팅 기능이 완료되면 안내 화면이 나타나, 웹샵 빌더 열기 · 아이템 관리 · 웹훅 설정 · 서비스 국가 설정 · 웹샵 발행으로 이어지는 온보딩 체크리스트를 순서대로 안내합니다.

ONEshop 결제 플로우

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

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

필수 API 연동

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

상세 가이드는 웹샵 연동 가이드 문서를 참고하세요.

API	데이터 흐름	필수 여부	설명
서버 리스트 연동	게임 서버 → ONEshop	필수	사용자가 웹샵 상세 화면에 진입 시, 실시간으로 게임 서버 목록을 조회하여 노출합니다.
유효성 검증	게임 서버 → ONEshop	필수	사용자가 입력한 '게임ID', '서버'의 유효성과 아이템 구매 가능 여부를 검증합니다.
PNS	ONEshop → 게임 서버	필수	사용자가 결제를 완료하면, 결제 결과와 관련 결제 정보를 PNS 알림으로 게임 서버에 전달합니다. PNS는 상용과 Sandbox 결제 환경을 모두 지원합니다.
구매 확인	게임 서버 → ONEshop	필수	아이템이 정상적으로 지급되었음을 확인하기 위해 구매확인 처리는 반드시 진행해야 합니다. 목적에 따라 consume 또는 acknowledge API 중 하나를 사용할 수 있습니다.
사용자 정보 연동	게임 앱 → ONEshop	선택	게임 내에서 웹샵으로 이동하는 경로를 노출할 수 있습니다. 이동 URL에 사용자의 게임ID·서버 정보를 포함하면, 웹샵 진입 시 원스토어 로그인 상태와 구매 입력 정보가 자동 적용되어 바로 구매를 진행할 수 있습니다. 편리한 결제 환경을 위해 연동을 권장합니다.

웹샵 테스트

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

상세 가이드는 웹샵 테스트 문서를 참고하세요.

판매국가에 '대한민국'이 포함된 경우, 웹샵 판매를 위해 등록된 테스트 ID로 결제 테스트를 최소 1회 진행해야 합니다.

검증 요청 ∙ 판매 시작

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