웹샵 소개
웹샵 서비스가 곧 오픈될 예정입니다.
오픈 전 주요 내용을 미리 확인하실 수 있도록 본 가이드를 먼저 공개합니다.
원웹샵이란
ONE webshop(원웹샵)은 원스토어 계정 기반의 웹 결제 플랫폼입니다.
PC·iOS·Android 등 다양한 환경에서 플랫폼 제약 없이 게임 아이템 결제를 제공하며, 개발사에는 매출 확장 기회를, 사용자에게는 편리한 결제 경험을 제공합니다.
원웹샵 플로우
사용자가 게임에서 웹샵으로 이동하면 게임ID·서버 정보를 전달하고, 원스토어 회원을 연동할 수 있어 매끄러운 결제 경험을 제공할 수 있습니다.
아이템을 구매하면 사용자가 입력한 게임ID·서버 정보가 유효한지 검증할 수 있으며,결제가 완료되면 아이템 지급을 위한 구매 결과를 개발사 서버로 전달합니다.
1. 원웹샵 진입
인게임에서 웹샵으로 이동할 때 사용자 정보 연동을 활용하면 원스토어 회원 연동이 가능할 경우, 게임 ID·서버 정보가 자동으로 전달되어 별도의 로그인 절차 없이 아이템을 구매할 수 있습니다.
2. 아이템 구매
아이템을 지급받을 게임 ID와 서버를 입력한 뒤 결제 화면에서 결제를 진행할 수 있으며, 기존 원스토어에 등록한 결제수단을 그대로 사용할 수 있습니다.
원웹샵 입점 프로세스
모바일 앱과 동일한 방식으로 원스토어 개발자센터에서 웹샵에 판매할 아이템을 등록하고 판매를 시작할 수 있습니다.
1. 타이틀 ∙ 아이템 등록
원스토어 개발자센터에서 타이틀과 아이템을 등록하세요. 게임 바이너리 없이 타이틀 정보만 입력해도 됩니다. 또한 대량의 아이템 등록을 위해 인앱 상품 가져오기와 일괄 등록 기능을 지원합니다.
상세 가이드는 신규로 타이틀 등록하기 / 아이템 등록 가이드 문서를 참고하세요.
2. 필수 API 연동
아이템을 구매한 사용자의 게임ID∙서버 정보가 유효한지 검증하고 웹샵의 구매 결과를 확인하기 위해서는 API 연동이 필수적으로 필요합니다.
상세 가이드는 웹샵 연동 가이드 문서를 참고하세요.
원웹샵 → 게임 서버
사용자가 결제를 완료하면, 결제 결과와 관련 결제 정보를 PNS 알림으로 게임 서버에 전달합니다.
PNS는 상용과 Sandbox 결제 환경을 모두 지원합니다.
게임 서버 → 원웹샵
아이템이 정상적으로 지급되었음을 확인하기 위해 구매확인 처리는 반드시 진행해야 합니다.
구매확인은 목적에 따라 consume 또는 acknowledge API 중 하나를 사용할 수 있습니다.
✅ 아이템 지급 후에는 반드시 구매확인을 처리해야 합니다.
사용자 정보 연동 (Optional)
게임 앱 → 원웹샵
게임 내에서 웹샵으로 이동하는 경로를 노출할 수 있습니다.
이동 URL에 사용자의 게임ID와 서버 정보를 포함하면, 웹샵 진입 시 원스토어 로그인 상태와 구매 입력 정보가 자동 적용되어 바로 구매를 진행할 수 있습니다. ✅ 편리한 결제 환경을 위해 사용자 정보 연동을 권장합니다.
3. 웹샵 테스트
웹샵은 정식 판매 전에 웹샵 화면과 결제 흐름을 사전에 검증할 수 있습니다.
상세 가이드는 웹샵 테스트 문서를 참고하세요.
웹샵 판매를 위해 최초 1회 Sandbox 결제 테스트를 반드시 진행해야 합니다.
4. 검증 요청 ∙ 5. 판매 시작
웹샵 테스트를 마치고 원스토어 개발자센터에서 검증 요청을 진행하면 검증 완료 후 원하는 날짜에 판매를 시작할 수 있습니다.
상세 가이드는 검증 요청하기 문서를 참고하세요.
Last updated