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

카카오 로그인

콜백

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

시작하기 전에

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

연결 끊기 알림

기본 정보
메서드 URL 인증 방식
GET/POST [내 애플리케이션] > [카카오 로그인] > [연결 끊기]에서 콜백 URL 등록
(예: https://example.com/unlink/callback)
서비스 앱 어드민 키
권한 사전 설정 카카오 로그인 사용자 동의
- 카카오 로그인 활성화
연결 끊기
- -

연결 끊기 알림은 사용자가 서비스 외부에서 각 서비스 애플리케이션(이하 앱)과의 연결을 해제할 경우, 카카오 서버가 사용자의 연결 끊기 요청을 서비스 서버로 전달하는 기능입니다. 다음과 같은 경우에 연결 끊기 알림이 전달됩니다.

연결 끊기 API

연결 끊기 API를 호출해 서비스가 사용자와의 연결을 끊은 경우에는 연결 끊기 알림이 발송되지 않습니다.

사용자가 연결 끊기를 요청하면 카카오에서는 더 이상 해당 서비스를 사용할 수 없다는 점을 안내합니다. 해당 서비스에서도 서비스 데이터베이스(DB)에서 연결을 끊은 사용자 정보를 처리해야 합니다. 연결 끊기 알림을 설정하면 서비스에게도 특정 사용자가 앱 연결을 끊은 사실을 알리므로, 서비스 자체 정책에 따라 탈퇴 처리할 수 있습니다.

이 기능을 사용하려면 먼저 연결 끊기에서 콜백 URL 및 요청 방법(Method)을 지정해야 합니다. 콜백은 리다이렉트를 지원하지 않습니다.

요청 헤더는 앱 어드민 키를, 본문은 앱 ID(app_id)와 회원번호(user_id), 연결 끊기 요청 경로(referrer_type)를 각각 포함합니다. 앱 어드민 키와 앱 ID로 요청의 유효성을 검증해야 합니다. 아래의 요청 전문 예제를 참고합니다.

연결 끊기 알림은 카카오 서버가 사용자에 대한 연결 끊기 처리를 완료한 후 발송됩니다. 연결 끊기 알림을 받았다면 사용자가 앱과의 연결을 이미 끊은 것이므로, 서비스 서버에서도 해당 사용자 정보를 삭제하는 등 개인정보 처리방침에 따른 조치를 취한 뒤 카카오 서버에 응답해야 합니다. 일반적으로 다음과 같이 처리합니다.

  • 카카오 서버가 요청 시 전달한 어드민 키가 올바른 값인지 확인합니다. 어드민 키가 올바르다면, 서비스 서버에서 해당 사용자의 정보를 삭제하고, 함께 필요한 작업이 있다면 수행합니다.
  • 사용자 정보 삭제 및 관련 작업 완료 후, 카카오 서버의 요청에 대해 HTTP 상태 코드 200 OK로 응답해야 합니다.
    • 카카오 서버로의 응답은 3초 이내로 이뤄져야 합니다.
    • 카카오 서버는 HTTP 상태 코드로 요청 성공 여부를 판단하므로 응답 본문(Body)은 필요하지 않습니다.
    • 사용자 탈퇴 처리 및 정보 삭제에 실패했거나, 사용자를 찾을 수 없는 경우에도 200 OK로 응답해야 합니다. 이후 서비스 내부적으로 사용자 정보 삭제 및 관련 작업을 다시 처리합니다.

요청

헤더
이름 설명 필수
Authorization Authorization: KakaoAK ${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

예제: 연결 끊기 알림

curl -v -G GET "${YOUR_UNLINK_CALLBACK_URL}?app_id=123456&user_id=1234567890&referrer_type=UNLINK_FROM_APPS" \
    -H "Authorization: KakaoAK ${SERVICE_APP_ADMIN_KEY}"
curl -v -X POST "${YOUR_UNLINK_CALLBACK_URL}" \
    -H "Authorization: KakaoAK ${SERVICE_APP_ADMIN_KEY}" \
    --data-urlencode "app_id=123456" \
    --data-urlencode "user_id=1234567890" \
    --data-urlencode "referrer_type=UNLINK_FROM_APPS"
연결 끊기 알림이 잘 설정되었는지 테스트하려면?

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

카카오 로그인> 콜백