API Reference > 웹훅

웹훅

웹훅(Webhook)은 특정 이벤트가 발생했을 때 NHN KCP 서버가 가맹점 서버로 실시간 알림을 전송하는 기능입니다.

웹훅 공통 파라미터

NHN KCP에서 가맹점으로 드리는 웹훅 공통 데이터입니다.
✅가상계좌 웹훅 데이터는 API Reference의 가상계좌 입금 메뉴를 참고해 주세요.


{
 "site_cd":"T0000",
 "tno":"20250521435727",
 "order_no":"TEST1234567890",
 "tx_cd":"TX00",
 "tx_tm":"20250521120000"
}

string5

site_cd

NHN KCP 발급 사이트(상점)코드
ex) "site_cd": "T0000"

string14

tnoPC / Mobile

NHN KCP 거래 고유번호
※ 거래고유번호 전체로 사용 하시기 바랍니다. (임의의 숫자나 파싱하여 사용 불가)
전송된 가상계좌 결제 건의 tno가 전달 됩니다.
ex) “tno” : “24123456789012”

string50

order_no

가맹점에서 생성한 주문번호
ex) "order_no": "TEST123456789"

string16

tx_cd

업무처리 구분코드
가상계좌 입금 통보 – TX00
ex) "tx_cd": "TX00"

string14

tx_tm

통보된 업무에 대한 업무처리 완료 시간
ex) "tx_tm": "20260131235959"

string4

result

NHN KCP에서 전송한 결과 데이터를 가맹점 서버에서 정상적으로 받았는지를 확인하기 위한 변수입니다.

가맹점 서버에서 결과 데이터를 정상적으로 처리한 경우 result 값을 ‘0000’으로 설정 바랍니다.
정상처리 되지 못한 경우엔 result 값을 임의의 값으로 설정 바랍니다.
result 값이 ‘0000’이 아닌 경우 당사 측에서 가맹점 측으로 최대 10번까지 재전송을 진행합니다.
ex) "result": "0000"

NHN KCP에서 전송한 결과 데이터를 가맹점 서버에서 정상적으로 받았는지 확인하기 위한 변수입니다.

{
 "result":"0000",
}

가맹점 DB 처리 로직

NHN KCP에서 가맹점으로 드리는 웹훅 데이터는 가맹점 DB 상태를 변경하는 데 사용됩니다.
아래는 Webhook 소스코드 내에 가상계좌 입금 데이터 DB 처리 작업 부분이니, 가맹점 환경에 맞게 적용해 주세요.


if(tx_cd.equals("TX00"))
{
     //DB 처리 내용 삽입
}