웹샵 연동 가이드

웹샵 서비스가 곧 오픈될 예정입니다.

오픈 전 주요 내용을 미리 확인하실 수 있도록 본 가이드를 먼저 공개합니다.

게임 내에서 원웹샵으로 이동하는 경로를 노출할 수 있습니다.

이동 URL에 사용자의 게임ID와 서버 정보를 포함하면, 원웹샵 진입 시 원스토어 로그인 상태와 구매 입력 정보가 자동 적용되어 바로 구매를 진행할 수 있습니다.

적용 예시

게임의 개인정보처리방침에 따라 게임ID가 개인정보에 해당할 경우, 개인정보 3자 제공 동의 과정 등을 추가해야할 수 있습니다.

사용자가 원웹샵 상세 화면에 진입 시, 실시간으로 게임 서버 목록을 조회하여 노출합니다.

아이템을 특정 서버로 지급해야 하는 경우, 개발사는 서버 목록 조회 API를 제공해야 합니다. API는 원웹샵 상세 화면에서 실시간으로 호출되며, 사용자가 서버를 선택해 구매하면 서버 정보가 PNS로 함께 전달됩니다.

단, 서버 목록은 타이틀 등록 시 개발자센터 > 웹샵 > 기본정보 > 구매입력정보 를 구매식별자 + 서버로 설정한 경우에만 사용자에게 표시됩니다.

적용 예시

사용자가 입력한 게임ID와 서버 정보의 유효성을 확인하고,해당 아이템의 구매 가능 여부를 검증합니다.

사용자가 결제를 완료하면, 결제 결과와 관련 결제 정보를 PNS 알림으로 게임 서버에 전달합니다.

PNS는 상용과 Sandbox 결제 환경을 모두 지원합니다.

아이템이 정상적으로 지급되었음을 확인하기 위해 구매확인 처리는 반드시 진행해야 합니다.

구매확인은 목적에 따라 두 가지 API 중 하나를 사용할 수 있습니다.

API

상세

consumePurchase

acknowledgePurchase

주의사항

Last updated 1 day ago