웹샵

now.gg 기반 웹샵을 설정하거나 기존 웹샵을 앱에 연결하고 스토어 수수료를 절약하실 수 있습니다.

방법:

  • 샵 설치를 클릭합니다.
    상점 세부 정보 – 설정으로 이동하여 필요한 세부 정보를 입력하고 상점을 게시합니다.

상점 세부 정보

상점을 설정하고 초안 또는 이미 게시된 상점을 목록 형태로 확인하실 수 있습니다.

설정

웹샵을 구성하실 수 있습니다.

샵을 설정하기 위해 샵 설정을 선택합니다.

선택:



now.gg 기반 웹샵 생성

샵 설정에서 ‘웹샵 생성‘을 선택한 후 now.gg 기반 웹샵을 설정하실 수 있습니다.

1. 샵 상품

웹샵에서 판매하려는 상품을 선택하실 수 있습니다.

  • 아래와 같이 상품 선택 +를 클릭합니다.
  • 이미 추가된 상품 중에서 선택합니다.
  • 기존 상품이 없거나 새로운 상품을 추가하고 싶으시다면 인앱 상품에서 추가하실 수 있습니다.
  • 제품을 선택한 후 완료를 클릭합니다.
  • 이제 다음 단계에서 디자인 에셋을 추가하실 수 있습니다.

2. 디자인 에셋

웹샵의 디자인 에셋을 선택합니다.

중요

  • nowStudio에 앱을 추가하는 중 일반 게임 에셋(등록 탭 아래)을 업로드하면 웹샵을 구축하는 동안 자동으로 선택됩니다.
  • 이미지 변경를 클릭하여 해당 이미지를 변경하실 수 있습니다.

에셋 형식:

  • 게임 아이콘
    • 크기 – 512 x 512px
    • 포맷 – .JPG, .JPEG, .PNG
    • 용량 – 10 Mb
  • 게임 로고
    • 크기 – 550 x 300px
    • 포맷 – .PNG, .SVG
    • 용량 – 10 Mb
  • 배너 이미지
    • 크기 – 1920 x 1080px
    • 포맷 – .JPEG
    • 용량 – 10 Mb
  • 배너 영상
    • 가로 모드
      • 크기 – 1920 x 1080px
      • 포맷 – .MP4
      • 용량 – 50 Mb
    • 세로 모드
      • 크기 – 720 x 1280px
      • 포맷 – .MP4
      • 용량 – 50 Mb

3. 결제 설정

아래와 같이 웹샵의 결제 설정을 구성하실 수 있습니다.

설정:

  • 콜백 URL
    거래 후 요청 데이터를 보내는 데 사용할 콜백 URL을 설정합니다.
  • API Key
    거래 후 전송된 요청 데이터와 함께 전달되는 키로 API 호출의 신뢰성을 인증하기 위해 사용하실 수 있습니다.

중요

  • 콜백 URL은 여기에 제공된 API 스펙을 기반으로 PaymentsProcessingCallback API를 가리켜야 합니다.

4. 개인 정보 정책

개인 정보 정책을 설정하실 수 있습니다.

  • 아래와 같이 개인 정보 보호 정책 URL을 입력합니다.

5. 초안 미리보기, 게시 또는 저장

웹샵 설정을 마친 후 다음을 수행하실 수 있습니다.

  • 웹샵 초안 저장
    • 웹샵 미리보기
  • 웹샵 게시
웹샵 초안 저장

방법:

  • 오른쪽 하단에 있는 임시 저장을 클릭합니다.
  • 아래와 같이 초안으로 저장되고 샵 세부 정보에 추가됩니다.
  • 웹샵을 미리 보려면 웹샵 미리보기를 클릭합니다.
    • 웹샵을 미리 보고 게시하기 전에 필요한 사항을 변경하실 수 있습니다.
      (미리보기는 새 창에서 열립니다)
  • 계속해서 웹샵을 설정하려면 위와 같이 샵 설정을 클릭합니다.
웹샵 게시

방법:

  • 오른쪽 하단에 있는 게시를 클릭합니다.
  • 아래와 같이 웹샵이 게시되고 샵 세부 정보에 추가됩니다.
  • 게시된 URL을 복사하거나 웹샵 보기 버튼을 클릭하여 웹샵을 확인하실 수 있습니다.
  • 웹샵과 관련된 세부 정보를 수정하려면 다음을 수행하시기 바랍니다.
    • 샵 설정을 클릭합니다.
  • 설정 후 게시를 클릭합니다.
    • 확인 창에서 게시를 클릭합니다.

now.gg 웹샵 게시 취소 및 기존 웹샵으로 전환

게시 취소:

  • 샵 세부 정보에서:
    • 오른쪽 상단에 있는 샵 설정을 클릭합니다.
    • 오른쪽 하단에 있는 게시 취소를 클릭합니다.
    • 확인 창에서 게시 취소를 클릭합니다.
  • 웹샵이 게시 취소되고 초안 상태로 변경됩니다.
  • 초안 웹샵을 확인하려면 왼쪽 메뉴에서 샵 세부 정보를 클릭합니다.
기존 웹샵 전환

‘now.gg 기반 웹샵’에서 기존 웹샵(now.gg 제외)으로 전환하실 수 있습니다.

방법:

  • 아래와 같이 샵 설정을 클릭합니다.

    (설정 화면이 열립니다)
  • 설정 내 샵 옵션에서 다음을 수행합니다.
    • 기존 웹샵 사용을 클릭합니다.
    • 확인 창에서 계속을 클릭합니다.
    • now.gg 기반 웹숍이 비활성화됩니다.
    • 기존 샵의 URL을 입력합니다.
    • 게시를 클릭합니다.
      • 확인 창에서 게시를 클릭합니다.


기존 웹샵 사용

기존 웹샵을 nowStudio와 연결하고 상품을 판매하실 수 있습니다.

방법:

  • 기존 웹샵의 URL을 입력합니다.
    • 게시를 클릭합니다.
    • 확인 창에서 게시를 클릭합니다.
  • 아래와 같이 웹샵이 게시되고 샵 세부 정보에 추가됩니다.
  • 제공된 링크를 웹샵에 복사하거나 웹숍 보기를 클릭하여 새 브라우저 창에서 웹샵을 여실 수 있습니다.
  • 웹샵을 편집하려면 오른쪽 상단에 있는 샵 설정을 클릭합니다.
  • 설정을 마친 후 게시를 클릭합니다.

now.gg 기반 웹숍으로 전환

기존 웹샵에서 now.gg 기반 웹샵으로 전환하실 수 있습니다.

방법:

  • 샵 세부 정보에서 아래와 같이 오른쪽 상단에 있는 샵 설정을 클릭합니다.

    (설정 화면이 열립니다)
  • 설정 내 샵 옵션에서 다음을 수행합니다.
    • 웹샵 생성을 클릭합니다.
    • 확인 창에서 계속을 클릭합니다.
  • 여기에 설명된 단계에 따라 웹샵을 설정합니다.


내부 테스터

내부 테스트를 통해 now.gg 기반 웹샵에서 구매 및 전달 프로세스를 쉽게 테스트하실 수 있습니다.

테스터 추가 방법:

  • 모든 앱에서:
  • 테스트하려는 앱의 세부 정보를 클릭합니다.
    • 왼쪽 사이드바에서 테스터를 클릭합니다.
    • 테스터 추가를 클릭합니다.
      • 테스트에 사용하려는 유저의 게임 내 유저 ID(IN_GAME_ID)를 입력합니다.
    • 추가를 클릭합니다.
      ‘테스터가 성공적으로 추가되었습니다’라는 확인 메시지가 화면에 표시됩니다.

테스터 삭제 방법:

  • 모든 앱에서:
  • 테스트하려는 앱의 세부 정보를 클릭합니다.
    • 왼쪽 사이드바에서 테스터를 클릭합니다.
    • 아래와 같이 테스터 목록이 표시됩니다.
    • 아래와 같이 확인 팝업이 열립니다.
    • 삭제를 클릭합니다.
      ‘테스터가 성공적으로 삭제되었습니다’라는 확인 메시지가 화면에 표시됩니다.

결제 처리 콜백 API

(개발자용)

웹샵 결제를 성공적으로 처리하기 위해 PaymentsProcessingCallback API 제공 시 필요한 API 스펙입니다.

중요

  • 개발자 제공 API로 웹샵에서 제품을 구매한 후 해당 API를 사용하여 요청 데이터를 보냅니다.

웹샵 결제를 성공적으로 처리하려면 PaymentsProcessingCallback API가 필요하며 다음은 해당 처리와 관련된 프로세스입니다.

  • nowStudio는 해당 API를 사용하여 요청 데이터를 게임 백엔드로 보냅니다.
  • 게임 백엔드는 저희가 제공하는 API 키(결제 설정 아래)를 사용하여 요청을 인증할 수 있습니다.
  • 구매한 상품을 유저에게 할당하여 구매 프로세스를 완료합니다.
  • success가 true인 상태 코드 200을 받은 후 구매 주문이 완료된 것으로 설정합니다.
요청 함수
 POST
요청 헤더
Authorization: "<API-Key Here>"
 Content-type: application/json

중요: 여기를 통해 API 키를 생성/재생성하실 수 있습니다.

요청 바디

바디에는 다음 변수가 포함됩니다.

이름 설명
notificationType string WEBSHOP_ITEM_PURCHASED 유저의 결제가 완료되면 전송됩니다.
data object
Data Object 변수

다음 변수는 데이터 개체와 연관됩니다.

이름 예시 값 설명
orderId string 1-202402110116343 주문과 연결된 주문 ID입니다.
packageName string gg.now.sample.app 앱의 패키지 이름입니다.
productId string SampleProduct 유저가 구매한 상품과 연결된 상품 ID입니다.
eventTime long 1707965194000 주문 에포크 타임스탬프입니다.
amount float 24.99 주문 금액입니다.
isTestOrder boolean true True/False
currency string USD 인앱 구매 통화입니다.
paymentId string 1234 앱의 고유 식별자입니다.
inGameId string abc123 유저의 게임 내 유저 ID입니다.
developerPayload string {UID: abc} 주문에 대한 추가 정보가 포함된 개발자가 지정한 문자열입니다.
예상 응답

다음은 PaymentsProcessingCallback API의 샘플 예상 응답입니다.

{
     "success": true, 
     "reason": "reason_for_failure". // 선택 사항으로 success가 false인 경우에만 필요합니다.
 }
환불 처리

웹샵에서는 환불을 위해 다음과 같은 프로세스가 구현됩니다.

  • 제공하시는 콜백 URL을 사용하여 요청 데이터를 보낸 후 API의 응답을 기다리게 됩니다.
    • success가 true인 상태 코드 200을 받은 후 구매 주문이 완료된 것으로 설정합니다.
    • 성공 응답을 받지 못하면 한동안 계속 재시도하고 응답이 추후 없을 시 주문 환불이 시작됩니다.

×

목차

웹샵

목차

문서 Rev. 1.0

클립보드에 복사된 텍스트
copyLinkText
질문이 있으신가요? 다음 주소로 문의하세요. dev-support@now.gg