Guide > 웹훅
웹훅
웹훅
웹훅(Webhook) 서비스
NHN KCP에서 결제 상태 변경(ex, 가상계좌 입금 완료 등)과 같은 이벤트가 발생하면,
사전에 등록한 가맹점의 URL로 HTTP 기반 콜백(POST) 요청을 전송하여 해당 이벤트 데이터를 전달합니다.
즉, 가맹점이 별도로 상태를 조회하지 않아도
이벤트 발생 시점에 맞춰 NHN KCP가 자동으로 결제 결과를 통보해주는 실시간 연동 방식입니다.
📍 웹훅이 필요한 이유
가상계좌의 경우 카드 결제처럼 즉시 승인되는 구조가 아닌, 구매자의 입금 시점에 따라 결제 완료 시점이 달라집니다.
에스크로의 경우 결제 승인 이후에도 다양한 상태 변경(ex, 배송시작, 즉시취소 등) 이벤트가 발생하는 구조이기 때문에
가상계좌 입금 완료 여부 파악과 에스크로 상태 동기화를 위해 웹훅 연동은 필수적이에요.
✅ 가맹점 서버의 웹훅 페이지가 NHN KCP 파트너관리자에 미리 등록되어 있어야, 실 거래 건에 대해 노티처리가 가능합니다.
✅ 웹훅 파라미터는 API Reference를 확인해 주세요.
웹훅 서버 IP 정보
| 항목 | 테스트 | 운영 |
|---|---|---|
| Webhook 서버 IP | 210.122.176.144 | 103.215.144.173 103.215.144.174 210.122.72.173 |
| 연결 방향 | INBOUND/OUTBOUND | INBOUND/OUTBOUND |
1. 웹훅 이벤트 등록하기
NHN KCP 파트너관리자의 웹훅 관리 메뉴에서 웹훅 URL을 누르면 아래와 같이 웹훅 URL 등록 페이지가 열립니다.
인코딩 설정 및 웹훅 URL을 입력하고 '저장'을 누르면 웹훅이 등록됩니다.
이제 결제 상태 변경이 발생하면, 설정한 웹훅 URL로 웹훅 이벤트가 전송됩니다.
단, Webhook 주소가 https로 시작하지 않을 경우 이벤트가 발송되지 않을 수 있으니 유의해 주세요.

2. 웹훅 재전송 정책
가맹점에서 웹훅을 잘 받았다면 NHN KCP로 '0000' 응답을 보내주세요.
‘0000’ 응답을 보내면 웹훅 상태가 '성공'입니다.
‘0000’ 응답을 보내지 않고 최초 웹훅 전송이 실패하면, NHN KCP에서 최대 10회까지 웹훅을 재전송합니다.