사용자 정보 불러오기

사용자가 직접 입력하지 않아도, 필요한 정보를 토스에서 안전하게 불러올 수 있어요.
예를 들어 택배를 보낼 때 이름, 휴대전화번호, 주소 등을 사용자가 일일이 입력하지 않아도 토스에 저장된 정보를 동의 후 바로 불러올 수 있어요.

꼭 확인해 주세요

사용자 정보 불러오기는 토스 로그인과 별개의 기능이에요. 토스 로그인 없이도 사용할 수 있어요.
사용자에게 개인정보 제3자 제공 동의를 받은 후에만 정보가 전달돼요.
노출 시점은 최대 5개까지 등록할 수 있어요.
별도 서버 없이 사용할 수 있으며, SDK v2.7.0 이상에서 사용할 수 있어요.

1. 사용자 정보 불러오기 접속하기

콘솔에서 사용자 정보 불러오기 메뉴로 접속해 주세요.

접속 방법: 앱인토스 콘솔 → 워크스페이스 선택 → 미니앱 선택 → 좌측 메뉴 '유저정보 불러오기'

처음 접속하면 아직 등록된 정보가 없는 빈 화면이 노출돼요. 등록하기 버튼을 눌러 설정을 시작해 주세요.

2. 동의문 노출 시점 설정하기

사용자에게 정보 제공 동의를 요청할 시점을 설정해요. 서비스 내에서 사용자 정보가 필요한 상황에 맞춰 제목을 작성해 주세요.

동의 화면 제목

동의 화면에 노출되는 제목이에요. 입력한 텍스트 뒤에 "때 필요한 정보를 불러올까요?" 가 자동으로 붙어요.
예를 들어 택배 보낼을 입력하면, 사용자에게는 "택배 보낼 때 필요한 정보를 불러올까요?" 로 노출돼요.

불러올 사용자 정보

해당 시점에 불러올 사용자 정보를 선택해 주세요. 선택할 수 있는 항목은 다음과 같아요.
사용자 정보는 토스앱 → 설정 → 내 정보 · 주소 관리 에 있는 정보를 불러와요.

항목	설명	비고
이름	사용자 이름
성별	사용자 성별
내국인/외국인	내국인/외국인 여부
생년월일	사용자 생년월일
휴대전화번호	사용자 휴대전화번호
주소	사용자 집 주소	토스 가입 시 필수가 아니어서 값이 없을 수 있고, 이 경우 null로 전달돼요.
이메일 주소	사용자 이메일 주소	토스 가입 시 필수가 아니어서 값이 없을 수 있고, 이 경우 null로 전달돼요.

노출 시점 추가하기

서비스 내에서 사용자 정보가 필요한 시점이 여러 개라면, 노출 시점 추가하기 버튼으로 시점을 추가할 수 있어요. 최대 5개까지 등록할 수 있어요.
시점마다 불러올 사용자 정보를 다르게 설정할 수 있어요. 예를 들어 택배 발송 시에는 이름·휴대전화번호·주소를, 본인 인증 시에는 이름·생년월일만 요청할 수 있어요.

3. 동의문 내용 확인하기

사용자에게 노출되는 동의문은 개인정보 제3자 제공 동의 형식으로 자동 생성돼요. 선택한 사용자 정보 항목에 맞춰 동의문 내용이 자동으로 구성돼요.
보기 버튼을 눌러 동의문 전체 내용을 미리 확인할 수 있어요.

4. 콜백 설정하기 (선택)

사용자가 미니앱에서 회원 탈퇴하면, 등록된 콜백 URL로 탈퇴 이벤트가 전달돼요. 이벤트를 받은 뒤에는 해당 사용자의 정보를 파기해 주세요.

TIP

콜백은 선택 사항이에요. 콜백을 사용하려면 토글을 ON으로 설정해 주세요.

콜백 URL

탈퇴 이벤트를 수신할 URL을 입력해 주세요.

HTTP 메서드

콜백 호출 시 사용할 HTTP 메서드를 GET 또는 POST 중 선택해 주세요.

Basic Auth 헤더

콜백 요청 시 HTTP 헤더에 포함되는 인증 정보예요. Authorization: Basic {입력한 값} 형태로 전달돼요.

콜백 테스트

설정을 저장하기 전에 테스트하기 버튼으로 콜백이 정상적으로 동작하는지 확인해 주세요.
테스트에 성공해야 저장할 수 있어요.

5. 등록 완료 및 코드 복사하기

등록이 완료되면 각 노출 시점마다 cud_로 시작하는 고유 코드(consentedUserDataKey)가 생성돼요.
이 코드는 SDK에서 사용자 정보를 불러올 때 사용해요. 복사 아이콘을 눌러 코드를 복사해 주세요.

등록 후에는 동의문 정보 화면에서 노출 시점, 불러올 사용자 정보, 코드를 한눈에 확인할 수 있어요.
수정하기 버튼으로 설정을 변경할 수 있어요.

6. 철회하기

동의한 동의문은 아래 경로에서 철회할 수 있어요. 개별 철회가 가능해요.

철회 방법: 토스 앱 → 설정 → 약관 및 개인정보 처리 동의 → 미니앱 이름