Skip to main content
SDK API에서 이벤트 발생 시 게임 서버로 알림을 보냅니다.

이벤트 종류

웹훅 형식

헤더
페이로드

서명 검증

웹훅 요청이 PlayCamp에서 온 것인지 확인하기 위해 서명을 검증해야 합니다.
SDK의 verifyWebhook() 유틸리티로 서명 검증, 타임스탬프 검증, 페이로드 파싱을 처리합니다:

수신 예시 (Express)

express.json() 대신 express.raw({ type: 'application/json' })를 사용해야 원본 body로 서명 검증이 가능합니다.

callbackId 추적

API 요청 시 callbackId를 전달하면, 해당 요청으로 발생한 웹훅 이벤트에 동일한 callbackId가 포함됩니다. 이를 통해 요청과 웹훅 이벤트를 매칭할 수 있습니다.

이벤트별 페이로드

payment.refunded (결제 환불)

POST /sponsors로 다른 크리에이터를 지정한 경우와 PUT /sponsors/user/:userId로 변경한 경우 모두 발송됩니다.
웹훅 페이로드는 oldCreatorKey/newCreatorKey를 사용합니다. 부스트 변경 이력 APIpreviousCreatorKey/creatorKey와 필드 이름이 다릅니다.

payment.bulk_created (벌크 결제)

벌크 결제 완료 시 요약 이벤트가 1회 발생합니다.

웹훅 테스트

로컬 개발을 위해 테스트 서명을 생성할 수 있습니다:

웹훅 관리