Webhook
1Webhook(노티) 서비스
해당 페이지에서는 가상계좌 입금에대한 통보 처리에 대한 가이드를 안내합니다.
상점은 Webhook 페이지를 통해 결제 건에 대한 변경된 상태를 처리 할 수 있습니다. 가상계좌의 경우, 결제자가 발급된 가상계좌에 대해 입금을 해야 최종적으로 결제가 완료됩니다. 결제자의 입금여부를 결제가 진행된 웹 페이지 상에서는 확인할 수 없기 때문에 결제자가 입금을 하게 되면, 해당 결제 건에 대한 입금결과를 NHN KCP에서 가맹점 측으로 별도로 전송합니다.
가맹점 서버의 Webhook 페이지가 NHN KCP 상점관리자 [기술관리센터 - 웹훅(Webhook)관리 - 웹훅 URL 설정] 에 미리 등록되어 있어야 실 거래 건에 대한 노티처리가 가능합니다.
2Webhook 서버IP정보
| Description | Server Info |
|---|---|
| NHN KCP 통보 테스트 서버 IP ADDRESS | 210.122.176.144 |
| NHN KCP 통보 실 서버 IP ADDRESS 1 | 103.215.144.173 / 103.215.144.174 |
| NHN KCP 통보 실 서버 IP ADDRESS 2 | 203.238.36.173 / 203.238.36.178 |
3모의입금 안내
NHN KCP는 테스트 가상계좌 발급 건에 한하여 [모의 입금 페이지]를 제공하고 있습니다.
가상계좌 모의입금 페이지는 NHN KCP 거래번호와 가상계좌번호를 통해 입금대기 상태의 결제 건을 입금완료로 바꾸며 가상계좌 모의입금 페이지는 테스트 서버에서 일어난 거래 건에 대해서만 유효하며 실 결제에서 일어난 건에 대해서는 사용이 불가능 합니다.
모의 입금 페이지는 아래의 URL을 통해서 접근 할 수 있습니다.
https://testadmin.kcp.co.kr/Modules/Noti/TEST_Vcnt_Noti.jsp
4파라미터
Webhook 공통 파라미터
site_cd
KCP 발급 사이트(상점)코드
ex) "site_cd": "T0000"
tnoPC / Mobile
NHN KCP 거래 고유번호
※ 거래고유번호 전체로 사용 하시기 바랍니다. (임의의 숫자나 파싱하여 사용 불가)
전송된 가상계좌 결제 건의 tno가 전달 됩니다.
ex) “tno” : “24123456789012”
order_no
가맹점에서 생성한 주문번호
ex) "order_no": "TEST123456789"
tx_cd
업무처리 구분코드
가상계좌 입금 통보 – TX00
ex) "tx_cd": "TX00"
tx_tm
통보된 업무에 대한 업무처리 완료 시간
ex) "tx_tm": "20240131235959"
result
NHN KCP에서 전송한 결과 데이터를 가맹점 서버에서 정상적으로 받았는지를 확인하기 위한 변수입니다.
가맹점 서버에서 결과 데이터를 정상적으로 처리한 경우 result 값을 ‘0000’으로 설정 바랍니다.
정상처리 되지 못한 경우엔 result 값을 임의의 값으로 설정 바랍니다.
result 값이 ‘0000’이 아닌 경우 당사 측에서 가맹점 측으로 최대 10번까지 재전송을 진행합니다.
ex) "result": "0000"
가상계좌 파라미터
ipgm_namePC / Mobile
거래에 대한 주문자명
ex) “ipgm_name” : “홍길동”
ipgm_mnyxPC / Mobile
입금자가 실제 입금한 입금 금액
ex) “ipgm_mnyx” : “1000”
totl_mnyxPC / Mobile
해당 계좌에 입금 된 금액의 합계
ex) “totl_mnyx” : “1000”
ipgm_timePC / Mobile
가상계좌에 입금된 시간
ex) “ipgm_time” : “20240131235959”
bank_codePC / Mobile
가상계좌 은행코드
ex) “bank_code” : “03”
accountPC / Mobile
입금된 가상계좌 번호
ex) “account” : “56201234123412”
noti_idPC / Mobile
가상계좌의 각 입금 통보 건에 대한 고유한 값을 가지는 변수
ex) “noti_id” : “24013112345678901234”
op_cdPC / Mobile
입급 통보 건에 대한 고유한 값
입금건에 대한 은행 망취소 응답 13 통보.
입금과 망취소 응답이 동일한 noti_id로 발송되니 입금취소 상태 확인이 필요합니다.
op_cd = ‘13’ 은 입금이 잘못 된 경우로 가맹점에 취소 노티가 나갑니다.
ex) “op_cd” : “50”
remitterPC / Mobile
결제 금액을 입금한 입금자명
주문자명과 다를 수 있습니다.
ex) “remitter” : “홍길동”
cash_a_noPC / Mobile
현금영수증 승인번호
ex) “cash_a_no” : “591234567”
cash_noPC / Mobile
가상계좌 발급 시 현금영수증 등록 요청 건에 대해 입금완료 후 리턴 되는 현금영수증 거래번호
ex) “cash_no” : “24123456789012”