DEFINITION웹훅이란?
웹훅은 어떤 일이 일어났을 때 외부 서비스가 우리 서버로 즉시 알려 주는 자동 호출 방식입니다.
웹훅 · Webhook · 최종 수정 · 작성 시스템메이트 개발팀
DETAIL자세히 알아보기
API가 "우리가 물어보는" 방식이라면 웹훅은 "상대가 알려 주는" 방식입니다. 결제 완료, 가상계좌 입금, 배송 완료 같은 이벤트를 실시간으로 받을 때 씁니다.
KEY POINTS웹훅 핵심 포인트
- 01이벤트 알림
결제 완료 · 입금 · 배송 완료 같은 일이 생기면 상대 서비스가 우리 주소로 바로 알려 줍니다.
- 02검증
받은 알림이 진짜 그 서비스에서 왔는지 서명 · 비밀키로 확인해야 합니다.
- 03중복 대비
같은 알림이 두 번 올 수 있어, 이미 처리한 건은 다시 처리하지 않게 설계합니다.
WHEN이럴 때 필요합니다
- 가상계좌 입금 · 결제 취소를 실시간으로 반영해야 할 때
- 몇 분마다 상대 서비스에 "바뀐 것 있나요?" 묻는 방식(폴링)이 비효율적일 때
CASES사례로 보는 웹훅
적용 예시
가상계좌 입금 즉시 주문 확정
예를 들어 가상계좌 결제를 받는 쇼핑몰이라면, 고객이 입금하는 순간 PG사가 웹훅으로 입금 사실을 알려 줍니다. 쇼핑몰은 이를 받아 주문을 "결제 완료"로 바꾸고 알림톡을 보내므로, 관리자가 통장 내역을 보고 수동으로 확인할 필요가 없습니다.
FAQ웹훅 자주 묻는 질문
Q웹훅이 실패하면 데이터가 빠지나요?
대부분의 서비스는 실패 시 재전송하지만, 안전하게 하려면 하루 한 번 API로 누락 여부를 대조하는 보정 작업을 함께 둡니다.