페이지 이동경로
  • 문서>
  • 카카오 로그인>
  • 콜백

카카오 로그인

콜백

이 문서는 카카오 로그인 관련 콜백 정보를 안내합니다.

시작하기 전에

이용 정책에서 콜백 사용 시 주의 사항을 확인해야 합니다.

연결 끊기 콜백

기본 정보
메서드 URL 필수 응답 규격 인증 방식
GET/POST [내 애플리케이션] > [카카오 로그인] > [연결 끊기]에 등록한 콜백 URL HTTP 상태 코드 200 OK (3초 내) 서비스 앱 어드민 키
권한 사전 설정 카카오 로그인 동의항목
- 카카오 로그인 활성화
연결 끊기 설정		 - -

연결 끊기 콜백은 사용자가 서비스 외부에서 앱과 연결을 끊은 경우, 카카오가 해당 사실을 서비스로 전달하는 기능입니다. 콜백을 수신한 서비스는 내부 정책에 따라 사용자 정보를 처리한 뒤, HTTP 상태 코드 200 OK로 3초 내에 응답해야 합니다.

서비스 외부에서 연결 끊기를 요청한 사용자에게는 더 이상 해당 서비스를 사용할 수 없다는 문구가 표시됩니다. 연결 끊기 콜백은 사용자에 대한 연결 끊기 처리를 완료한 후 발송합니다.

콜백은 헤더에 서비스 앱 어드민 키를, 본문에 앱 ID(app_id), 회원번호(user_id), 연결 끊기 요청 경로(referrer_type)를 각각 포함합니다.

사전 설정

연결 끊기 콜백은 콜백 URL과 메서드를 지정해야 사용할 수 있으며, 리다이렉트는 지원하지 않습니다. 설정 방법은 연결 끊기를 참고합니다.

연결 끊기 콜백 발송 조건

아래 상황이 발생한 경우 연결 끊기 콜백을 발송합니다. 서비스가 연결 끊기 API를 호출해 앱과 사용자의 연결을 끊은 경우에는 연결 끊기 콜백을 발송하지 않습니다.

콜백 수신 시 조치 방법

서비스는 콜백 수신 시 필요한 작업 수행 후 정해진 규격으로 응답해야 합니다. 아래 과정을 참고합니다.

  1. 수신한 콜백의 유효성을 포함된 서비스 앱 어드민 키와 app_id로 검증합니다.
  2. 수신한 콜백이 유효한 경우, user_id에 해당하는 사용자 정보를 개인정보 처리방침과 서비스 정책에 따라 탈퇴 처리, 삭제 또는 기타 방법으로 데이터베이스(DB)에 반영합니다.
  3. 콜백 수신 시점으로부터 3초 내에 HTTP 상태 코드 200 OK로 응답합니다.
    • HTTP 상태 코드로 응답 성공 여부를 판단하므로 본문(Body)은 필요하지 않습니다.
    • 사용자 정보 처리에 실패했거나, 사용자를 찾을 수 없는 경우에도 HTTP 상태 코드 200 OK로 응답해야 합니다. 이후 서비스 내부에서 필요한 작업을 수행합니다.
연결 끊기 콜백 테스트

연결 끊기 콜백을 받으려면 사용자가 연결을 끊는 상황을 만들어야 합니다. 카카오계정 페이지 또는 카카오톡의 [더보기] > [설정] > [카카오계정] 메뉴에서 연결 끊기 기능을 제공합니다. 이 기능을 사용해 서비스 서버가 연결 끊기 콜백을 정상적으로 처리하는지 확인할 수 있습니다.

요청

헤더
이름 설명 필수
Authorization Authorization: KakaoAK ${SERVICE_APP_ADMIN_KEY}
인증 방식, 서비스 앱 어드민 키로 인증 요청		 O
본문
이름 타입 설명 필수
app_id String 사용자가 연결 끊기를 요청한 서비스 앱 ID O
user_id String 연결 끊기를 요청한 사용자의 회원번호 O
referrer_type String 연결 끊기 요청 경로
ACCOUNT_DELETE: 카카오계정 탈퇴
FORCED_ACCOUNT_DELETE: 장기 휴면 또는 고객센터를 통한 카카오계정 강제 탈퇴
UNLINK_FROM_ADMIN: 카카오 관리자로 인한 탈퇴 처리
UNLINK_FROM_APPS: 카카오계정 페이지를 통한 서비스 연결 끊기
INCOMPLETE_SIGN_UP: 가입 미완료 사용자 연결 끊기 처리(공지사항 참고)		 O

응답

  • HTTP 상태 코드 200 OK (3초 내)

예제

요청: GET 메서드
curl -v -G GET "${UNLINK_CALLBACK_URL}?app_id=${APP_ID}&user_id=${USER_ID}&referrer_type=UNLINK_FROM_APPS" \
    -H "Authorization: KakaoAK ${SERVICE_APP_ADMIN_KEY}"
요청: POST 메서드
curl -v -X POST "${UNLINK_CALLBACK_URL}" \
    -H "Authorization: KakaoAK ${SERVICE_APP_ADMIN_KEY}" \
    --data-urlencode "app_id=${APP_ID}" \
    --data-urlencode "user_id=${USER_ID}" \
    --data-urlencode "referrer_type=UNLINK_FROM_APPS"
응답
HTTP/1.1 200 OK
카카오 로그인> 콜백