게임플레이 파트너 가이드

테마 전환

계정 상태 변경 웹훅 연동 ​

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

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

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

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

관련 가이드: 카카오싱크 설정: 앱·서비스 약관 설정, 카카오싱크 API: 연결 해제 요청, 심사 체크리스트: 철회 처리 자체 점검 항목

기존 약관 동의 철회 통지 API에서 전환 중이라면

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

참고 문서 ​