웹샵 적용 가이드

1. 원웹샵이란?

원웹샵(ONE webshop)은 개발사가 웹 환경에서 게임 아이템을 판매할 수 있도록 원스토어가 제공하는 공식 웹샵 서비스입니다.

• 원웹샵은 인앱결제를 대체하는 수단이 아니라, 개발사가 자체 채널에서 새로운 커머스 경험을 확장할 수 있도록 지원하는 보완적 판매 채널입니다.

• 원웹샵 상품 URL은 개발사의 자체 마케팅 채널은 물론, 원스토어 유통앱 내에서도 링크 연동이 가능하여 다양한 접점에서 유저 전환을 지원합니다

주요 특징

• 개발사의 자체 마케팅 채널은 물론, 원스토어 유통앱 내에서도 링크 연동 가능

• 낮은 수수료로 PG 수수료 포함 결제 제공

• PC, Android, iOS 등 모든 브라우저 환경에서 구매 가능

• 인앱결제와 동일한 서버 규격으로 빠른 연동

• 개발자센터에서 등록/검증/정산/CS를 원스톱 관리

웹샵 상세 페이지 URL

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

개발사는 위 URL을 자체 마케팅 채널(인게임, 공식 사이트, 커뮤니티 등)에서 활용할 수 있습니다.

2. 인앱결제 상점과 웹샵의 올바른 배치

웹샵 진입 경로는 게임앱 내에서 직접 제공할 수 있습니다. 단, 다음 원칙을 반드시 지켜야 합니다.

핵심 원칙

• 인앱결제가 연동된 상점 페이지에서 웹샵 이동 경로 및 상품을 직접 노출하는 것은 허용되지 않습니다.

• 웹샵 이동 경로는 인앱결제 상점과 기능적으로 분리된 별도의 진입 경로로 구성해야 합니다.

3. 웹샵 상점 눌렀을때 올바른 동선

게임 내 웹샵 버튼 클릭 시, 원스토어 웹샵의 ‘타이틀 상세 페이지’를 호출하는 방식으로 구현해야 합니다.

핵심 원칙

• 웹샵 내 특정 아이템을 직접 게임앱 내에 노출/전시 불가

허용되는 유도 방식

인앱결제 상점 외부 영역이라면, 다음과 같은 형태로 자유롭게 구현할 수 있습니다:

• 버튼 (예: "웹샵 바로가기")

• 텍스트 링크

• 팝업 / 다이얼로그

• 메뉴 항목

• 배너 이미지 등

4. 사용자 경험 최적화 팁

• 웹샵 진입 전('웹샵 버튼 클릭'과 '웹샵 상세 페이지' 사이), 간단한 안내 팝업을 제공하는 것을 권장합니다.

• 원웹샵은 게임 내에서 웹샵으로 이동 시, 게임 ID를 자동으로 연동하여 별도의 게임 ID 입력 없이 바로 구매할 수 있는 기능을 제공합니다. 상세 연동 방법은 사용자 정보 연동 가이드를 참고하세요.

개인정보 관련 안내

게임의 개인정보처리방침에 따라 게임 ID가 개인정보에 해당할 경우, 개인정보 제3자 제공 동의 메시지를 추가해야 할 수 있습니다. 개발사의 개인정보처리방침과 관련 법령을 확인하세요.

5. 웹샵 상세 페이지 활용하기

원웹샵 상세 페이지에서 개발사가 활용할 수 있는 기능을 안내합니다.

5-1. 상단 배너 영역

게임의 대표 이미지 또는 프로모션 이미지를 등록할 수 있습니다. 다음과 같은 용도로 활용하세요:

• 웹샵 추천 상품 안내

• 프로모션 / 시즌 이벤트 배너

• 한정 판매 안내

5-2. 아이템별 뱃지 및 할인 가격 노출

• 아이템별로 짧은 설명 문구를 추가하여 상품의 가치를 효과적으로 전달할 수 있습니다.

• 개발사가 강조하고 싶은 상품에 뱃지를 노출할 수 있습니다.

뱃지 유형	용도
New	신규 등록 아이템 강조
Best	인기 / 추천 아이템 강조

• 정가와 판매가를 각각 설정하면, 정가에 취소선이 적용되고 할인가가 강조 표시됩니다.

예시:
정가: 12,000원  →  판매가: 9,600원 (20% 할인)

6. 구매 횟수 제한 처리

웹샵에서는 게임 내 구매 가능 여부를 직접 확인할 수 없습니다. 대신, 개발사가 API 응답을 통해 구매 불가 상태를 처리할 수 있습니다.

6-1. 처리 흐름

1. 유저가 웹샵에서 게임 ID / 서버를 입력하고 구매를 시도합니다.

2. 원웹샵이 개발사 서버로 구매 요청을 전송합니다.

3. 개발사 서버에서 구매 불가로 판단한 경우, 상태코드 1001과 함께 노출 희망 문구를 반환합니다.

4. 원웹샵이 해당 메시지를 유저에게 노출합니다.

6-2. API 응답 예시

{
  "result.code": "1001",
  "result.message": "해당 계정에서 구매 가능한 횟수를 초과하였습니다."
}

6-3. 권장 메시지 예시

상황	권장 메시지
구매 횟수 초과	"해당 계정에서 구매 가능한 횟수를 초과하였습니다."
이미 구매한 일회성 상품	"이미 구매한 상품입니다."
이벤트 종료	"이벤트 기간이 종료된 상품입니다."

6-4. 아이템 설명에 사전 안내 (권장)

구매 전 혼선을 줄이기 위해, 아이템 설명 영역에 구매 횟수 제한을 미리 명시하는 것을 권장합니다.

예시

• "계정당 1회 구매 가능"

• "일일 3회 구매 제한"

• "서버당 월 5회 구매 가능"