개발하기

SDK를 통해 연동해 주세요.

미니앱 유형에 따라 사용하는 함수가 달라요.

미니앱 유형	함수	설명
게임	getUserKeyForGame	게임 미니앱 전용 유저 식별키를 반환해요.
비게임	getAnonymousKey	비게임 미니앱 전용 유저 식별키를 반환해요.

두 함수 모두 서버 연동 없이 유저를 식별할 수 있는 고유 키 값(hash) 을 반환해요.
반환되는 유저 식별자는 미니앱별로 고유해요.

게임 미니앱

getUserKeyForGame 함수를 사용해 유저 식별키를 발급받을 수 있어요.

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

주의하세요

• 이 함수는 게임 카테고리 미니앱에서만 사용할 수 있어요.
  비게임 카테고리에서 호출하면 오류가 발생해요.
• SDK 1.4.0 이상 버전, 토스앱 5.232.0 이상 버전에서 지원돼요.
  그 이하 버전에서는 undefined를 반환해요.
• 유저 식별자는 내부 유저 식별용 키로만 사용되며, 해당 키로 토스 서버에 직접 요청할 수 없어요.
• 샌드박스에서는 mock 데이터가 내려가고 있어, QR 코드로 테스트를 부탁드려요.

비게임 미니앱

getAnonymousKey 함수를 사용해 유저 식별키를 발급받을 수 있어요.

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

주의하세요

• 이 함수는 비게임 카테고리 미니앱에서만 사용할 수 있어요.
• SDK 2.4.5 이상 버전에서 지원돼요. 그 이하 버전에서는 undefined를 반환해요.
• 유저 식별자는 내부 유저 식별용 키로만 사용되며, 해당 키로 토스 서버에 직접 요청할 수 없어요.
• 샌드박스에서는 mock 데이터가 내려가고 있어, QR 코드로 테스트를 부탁드려요.