---
url: /api-sdk/share/reward-result.md
description: 카카오톡 공유 발생 후 카카오디벨로퍼스 연동으로 보상 가능 여부 판정 참고 데이터를 수신하는 방식 안내
---

# 공유 웹훅 연동

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

카카오톡 공유 발생 후 카카오디벨로퍼스 연동을 통해 보상 가능 여부 판정 참고 데이터를 수신할 수 있습니다. 파트너사는 이 문서의 규격을 참고해 수신 API 엔드포인트를 자체 구현하고, 카카오디벨로퍼스의 **\[앱] > \[웹훅] > \[카카오톡 공유 웹훅]** 에 수신 URL을 등록합니다. 웹훅 URL은 HTTPS와 443 포트만 등록할 수 있습니다.

공유 SDK 호출 시 `server_callback_args`에 담은 식별 값이 웹훅 본문으로 echo back되어, 카카오 서버가 공유 컨텍스트를 복원하고 보상 판정 참고 데이터를 파트너사 서버로 전달합니다.

> **관련 가이드**: [공유 설정](/docs/share/settings)

## 파트너사 처리 요구사항

* 수신 API는 **3초 이내에 HTTP 상태 코드 2XX로 응답해야 합니다.** 권장이 아니라 필수 응답 규격입니다.
* 3초 안에 처리를 끝낼 수 없다면 이벤트를 먼저 수신·저장해 응답하고 보상 판정은 비동기로 처리합니다.
* 응답이 없거나 지연되면 재시도가 발생하므로, 같은 이벤트를 여러 번 받아도 결과가 같도록 멱등 처리합니다.

## 참고 문서

* [카카오톡 공유 웹훅](https://developers.kakao.com/docs/ko/kakaotalk-share/callback): 요청·응답·인증 상세 규격
* [공유 설정](/docs/share/settings): 공유 SDK 호출과 `server_callback_args` 구성
* [심사 체크리스트](/docs/checklist/review-checklist): 공유 관련 자체 점검 항목
* 기술 문의: [카카오디벨로퍼스 데브톡](https://devtalk.kakao.com/c/game-play/353)