---
url: /api-sdk/data/terms-withdrawal.md
description: 카카오 로그인 계정 상태 변경 웹훅으로 사용자의 동의 철회·연결 해제 이벤트를 수신해 데이터 파기를 처리하는 가이드
---

# 계정 상태 변경 웹훅 연동

이 문서는 게임플레이 파트너사의 연동에 필요한 카카오디벨로퍼스 공식 가이드 내용을 요약한 안내입니다.
실제 구현 전 반드시 [카카오 로그인 계정 상태 변경 웹훅 공식 가이드](https://developers.kakao.com/docs/ko/kakaologin/callback#ssf)에서 최신 요청·응답·검증 규격과 제약사항을 확인하세요.

카카오가 파트너사 서버로 사용자의 카카오 로그인 계정 상태 변경 이벤트를 전달하는 웹훅입니다. 약관 동의 철회·연결 해제는 카카오디벨로퍼스에 등록하는 **카카오 로그인 계정 상태 변경 웹훅**으로 수신합니다.

약관 철회로 인한 파트너사 앱 연결 해제는 카카오가 대신 처리합니다. 파트너사는 웹훅으로 전달되는 연결 해제 이벤트를 수신해 **게임 이용 데이터 파기와 내부 상태 정리**를 수행합니다. 약관 철회로 연결 해제된 사용자와 개별 앱에서 연결 해제된 사용자를 같은 웹훅에서 함께 받아 처리할 수 있습니다.

파트너사는 `OAUTH: User Unlinked` 이벤트를 수신해 `reason`으로 약관 철회와 개별 앱 연결 해제를 구분하고, 데이터 파기와 내부 상태 정리를 수행합니다.

> **관련 가이드**: [카카오싱크 설정](/docs/authentication/kakao-login-sync): 앱·서비스 약관 설정, [카카오싱크 API](/api-sdk/kakaosync/rest-api): 연결 해제 요청, [심사 체크리스트](/docs/checklist/review-checklist): 철회 처리 자체 점검 항목

::: info 기존 약관 동의 철회 통지 API에서 전환 중이라면
파트너사 자체 구현 콜백으로 약관 동의 철회를 통지받던 파트너사는 [동의 철회·연결 해제 웹훅 (디벨로퍼스 마이그레이션 가이드)](/api-sdk/data/terms-withdrawal-migration)를 참고해 전환하세요. 연동 대상, `reason`별 처리 기준, 파트너사 처리 요구사항, 연동 흐름 등 상세 규격도 해당 가이드에서 확인할 수 있습니다.
:::

## 참고 문서

* [카카오 로그인 계정 상태 변경 웹훅](https://developers.kakao.com/docs/ko/kakaologin/callback#ssf): SET 구조·검증·응답 규격
* [카카오싱크 설정](/docs/authentication/kakao-login-sync): 앱·서비스 약관 설정
* [카카오싱크 API](/api-sdk/kakaosync/rest-api): 서비스 탈퇴와 연결 해제 요청
* [동의 철회·연결 해제 웹훅 (디벨로퍼스 마이그레이션 가이드)](/api-sdk/data/terms-withdrawal-migration): 기존 연동 전환 안내
* [심사 체크리스트](/docs/checklist/review-checklist)
* 기술 문의: [카카오디벨로퍼스 데브톡](https://devtalk.kakao.com/c/game-play/353)