사용자 식별키 발급

사용자 식별키 발급은 별도의 서버 연동이나 사용자 동의 절차 없이도 미니앱 안에서 사용자를 안정적으로 식별할 수 있도록 돕는 기능이에요.

사용자가 미니앱에 들어오는 순간 해당 사용자의 미니앱 준회원이 생성돼요. 미니앱은 이 사용자를 기준으로 서비스 이용 데이터, 저장 데이터, 랭킹, 포인트 같은 정보를 관리할 수 있어요.

토스 로그인 마이그레이션

기존에 토스 로그인으로 사용자를 식별하고 있었다면, 사용자 식별키 발급 방식으로 전환할 수 있어요. 별도의 로그인 화면이나 서버 연동 없이 사용자 식별이 필요한 경우에 적합해요.

사용자 식별키란

사용자 식별키는 미니앱 안에서 한 사용자를 구분하기 위한 고유 키 값이에요. 사용자의 개인 정보를 직접 노출하지 않고, 미니앱 내부에서 동일 사용자를 안정적으로 알아볼 수 있도록 해요.

반환되는 사용자 식별자는 미니앱별로 고유해요. 같은 토스 사용자라도 서로 다른 미니앱에서는 다른 식별키가 사용돼요.

꼭 확인해 주세요

미니앱 유형에 따라 사용자 식별키를 발급받는 방식이 달라요.

미니앱 유형

용도

설명

게임

게임 사용자 식별

게임 데이터, 랭킹, 포인트, 세이브 데이터 등을 사용자 단위로 관리할 때 사용해요.

비게임

일반 미니앱 사용자 식별

서비스 이용 기록, 사용자별 설정, 저장 데이터 등을 사용자 단위로 관리할 때 사용해요.

게임 미니앱에서는 게임 안에서 사용자를 식별하기 위한 전용 방식으로 사용자 식별키를 발급받아요. 토스 로그인처럼 별도의 인증 화면을 띄우지 않아도, 게임 미니앱 내부에서 고유한 사용자 식별자를 사용할 수 있어요.

이 식별키는 해당 게임 미니앱 안에서만 유효해요. 게임 내 데이터 저장, 랭킹 관리, 포인트 관리, 세이브 데이터 관리처럼 사용자를 기준으로 이어져야 하는 데이터에 사용할 수 있어요.

주의하세요

비게임 미니앱에서는 일반 서비스 안에서 사용자를 식별하기 위한 방식으로 사용자 식별키를 발급받아요. 별도의 인증 화면이나 서버 연동 없이, 미니앱 내부에서 고유한 사용자 식별자를 사용할 수 있어요.

이 식별키는 해당 미니앱 안에서만 유효해요. 사용자별 설정, 이용 기록, 저장 데이터처럼 사용자를 기준으로 관리해야 하는 데이터에 사용할 수 있어요.

주의하세요

비게임 미니앱에서만 사용할 수 있어요.
지원 버전보다 낮은 환경에서는 사용자 식별키가 제공되지 않을 수 있어요.
반환되는 사용자 식별키(hash)는 x-anon-key 헤더로 프로모션, 스마트 발송, 토스페이 API에 보내 사용자를 식별할 수 있어요. 스마트 대량 발송은 요청 본문의 anonKey로 보내요.
서버에서 식별키가 유효한지는 식별키 검증 API로 확인할 수 있어요. 검증 API는 식별키가 이 미니앱에서 발급된 키인지만 확인하고, 요청을 보낸 쪽이 그 사용자임을 증명하지는 않아요. 사용자 로그인 처리에는 인증 코드 교환 API를 사용해 주세요.
샌드박스 환경에서는 mock 데이터가 내려와요. 실제 동작은 QR 코드로 토스앱에서 테스트해 주세요.

사용자 식별키는 미니앱 내부에서 사용자를 기준으로 데이터를 이어서 관리해야 할 때 사용할 수 있어요.

사용자 식별키는 사용자를 구분하기 위한 값이에요. 사용자의 실명, 전화번호, 계정 정보 같은 개인 정보를 대신 제공하는 기능은 아니에요.

비게임 미니앱에서 사용자 식별키를 발급받는 방법은 User.getAnonymousKey에서 확인해 주세요.

마지막 업데이트 1일 전

도움이 되었나요?