개발하기

SDK를 통해 연동해 주세요.

getUserKeyForGame 함수는 게임 미니앱에서 유저를 식별할 수 있는 고유 키 값을 반환합니다.
이 함수를 사용하면 서버 연동 없이도 토스 로그인과 동일한 수준의 유저 식별이 가능해요.

반환되는 유저 식별자(hash)는 미니앱별로 고유하며, 프로모션(토스 포인트) 기능에서도 함께 사용할 수 있어요.

자세한 내용은 getUserKeyForGame 페이지를 확인해주세요.

주의하세요

• 이 함수는 게임 카테고리 미니앱에서만 사용할 수 있어요.
  비게임 카테고리에서 호출하면 오류가 발생해요.
• SDK 1.4.0 이상 버전, 토스앱 5.232.0 이상 버전에서 지원돼요.
  그 이하 버전에서는 undefined를 반환해요.
• 모든 유저의 식별자를 안정적으로 확보하기 위해, 토스앱 최소 지원 버전이 5.232.0 버전으로 상향되었어요.
  하위 버전에서는 업데이트 안내 화면이 표시돼요.
• 게임 유저 식별자는 게임사 내부 유저 식별용 키로만 사용되며, 해당 키로 토스 서버에 직접 요청할 수 없어요.