상품ID 생성 규칙 가이드

개요

• 결제 스토어 또는 결제수단(구글, 애플, 스팀 등)에 상품ID를 등록할 때는 스토어 제약과 HYBE IM 내부 재무 처리 등을 목적으로 유니크해야하고, 게임 및 상품이 구분되어야 합니다.

• 기존에 라이브되어 서비스 중인 게임은 해당 가이드에서 제외됩니다.

상품ID 생성 규칙

• 스토어(결제수단)구분코드_게임구분자_게임에서정의한상품ID

  • 언더바로 필드 구분

  • 최대 64자(애플 기준으로 사용)

  • 숫자 및 소문자, 언더바만 사용하고 특수기호 사용 금지(구글 대문자 허용X)

  • 구글에 런칭한 경우에는 게임 구분자를 패키지명을 사용하는 것도 허용

• 스토어 구분 코드

  • 글자 수 제한 때문에 빌링 시스템의 payment 또는 app store 코드를 사용하지 않고 줄여서 사용

    스토어(또는 결제수단)	코드(prefix)	예
    구글	google	google_gamecode_ruby01 google_com.hybeim.testgame_ruby01
    애플	apple	apple_gamecode_ruby01 apple_com.hybeim.testgame_ruby01
    스팀	steam	steam_gamecode_ruby01 steam_com.hybeim.testgame_ruby01
    엑솔라	xsolla	xsolla_gamecode_ruby01 xsolla_com.hybeim.testgame_ruby01
    갤럭시 스토어	galaxy	galaxy_gamecode_ruby01 galaxy_com.hybeim.testgame_ruby01
    마이카드	mycard	mycard_gamecode_ruby01 mycard_com.hybeim.testgame_ruby01
    코다샵	coda	coda_gamecode_ruby01 coda_com.hybeim.testgame_ruby01
    유니핀	unipin	unipin_gamecode_ruby01 unipin_com.hybeim.testgame_ruby01
    PG	pg	pg_gamecode_ruby01
    Appcharge	appcharge	appcharge_gem_123
    Epic Games	epic	epic_gem_1
    ONE Store	onestore	onestore_gem_1

참고

주요 결제 스토어(결제 수단)의 최대 글자 수

• 스팀과 PG는 상품관리 기능을 제공하지 않아서 빌링 시스템에서 관련 기능을 구현하여 제공 중

스토어/결제수단	상품ID(제품ID)	상품명(이름)	상품 설명	비고
구글	152	55	200
애플	64	30	45
스팀	200 빌링 기준 최대 200	50 빌링 기준 최대 50	미 지원	상품ID 빌링에서 uint32로 맵핑해서 스팀과 통신 상품명 스팀쪽에서 최대 128까지 허용하지만 빌링에서 제한
엑솔라	255	50 빌링 기준 최대 50	50 엑솔라 가이드 없어서 보수적으로 50
PG	200	50	50	토스와 같은 PG를 이용한 결제에 사용 빌링 시스템에 상품 정보가 등록되어야 판매 가능
Appcharge	200	200	N/A	Appcharge 측에서 공식 정보가 없어서 내부 관리용 최대 길이로 제약
Epic Games	200 빌링 기준 최대 200	64 오퍼 이름 최대 64	N/A	Epic Games는 상품을 오퍼라는 개념으로 관리하고 있는데, 게임에서 연동 및 관리를 편하게 하도록 상품ID로 추상화해서 기능 제공
ONE Store	136	50	N/A	상품ID는 소문자(a-z), 숫자(0-9), 밑줄(_), 점(.)으로만 구성되어야 하며 소문자 또는 숫자로 시작