콜백

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

시작하기 전에

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

연결 끊기 알림

기본 정보

메서드	URL	인증 방식
GET/POST	[내 애플리케이션] > [카카오 로그인] > [연결 끊기]에서 콜백 URL 등록 (예: https://example.com/unlink/callback)	서비스 앱 어드민 키

권한	사전 설정	카카오 로그인	동의항목
-	카카오 로그인 활성화 연결 끊기	-	-

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

• 가입 미완료 사용자 연결 끊기 처리된 경우
• 사용자가 카카오계정 관리 페이지나 카카오톡의 연결된 서비스 관리 메뉴에서 앱과의 연결을 끊은 경우
• 카카오계정 탈퇴
• CS로 인한 연결 끊기 처리

사용자가 연결 끊기를 요청하면 카카오에서는 더 이상 해당 서비스를 사용할 수 없다는 점을 안내합니다. 해당 서비스에서도 서비스 데이터베이스(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"