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을 받은 후 구매 주문이 완료된 것으로 설정합니다.
요청 함수
요청 헤더
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을 받은 후 구매 주문이 완료된 것으로 설정합니다.
- 성공 응답을 받지 못하면 한동안 계속 재시도하고 응답이 추후 없을 시 주문 환불이 시작됩니다.