Webhook(노티)


Webhook

해당 페이지에서는 가상계좌 입금에대한 통보 처리에 대한 가이드를 안내합니다.

상점은 Webhook 페이지를 통해 결제 건에 대한 변경된 상태를 처리 할 수 있습니다. 가상계좌의 경우,
결제자가 발급된 가상계좌에 대해 입금을 해야 최종적으로 결제가 완료됩니다.

결제자의 입금여부를 결제가 진행된 웹 페이지 상에서는 확인할 수 없기 때문에,
결제자가 입금을 하게 되면, 해당 결제 건에 대한 입금결과를 NHN KCP에서 가맹점 측으로 별도로 전송합니다.

결과적으로 가맹점은 이 페이지를 통해 결제 건에 대한 변경된 상태를 처리 할 수 있습니다.

Webhook 페이지의 샘플은 다운로드 자료실 표준 WEB/MOBILE 샘플 내에 포함되어 있습니다.

※ 가맹점 서버의 Webhook 페이지가 NHN KCP 파트너 관리자 페이지 [상점정보관리 – 보안관리 – 결제결과URL설정]에 미리 등록되어 있어야 실 거래 건에 대한 노티처리가 가능합니다.

해당 페이지에 URL이 등록되지 않은 경우 NHN KCP에서는 DATA를 별도로 전송하지 못하게 됩니다.

Webhook 서버IP정보

DescriptionServer Info
NHN KCP 통보 테스트 서버 IP ADDRESS210.122.176.144
NHN KCP 통보 실 서버 IP ADDRESS 1103.215.144.173
NHN KCP 통보 실 서버 IP ADDRESS 2103.215.144.174

※ 위 IP에 대한 방화벽 허용 처리가 사전에 진행되어야 합니다.


Webhook 파라미터 가이드

가상계좌 파라미터

string30

ipgm_name

거래에 대한 주문자명


number12

ipgm_mnyx

입금자가 실제 입금한 입금 금액
※ 주의 – 입금자가 주문 금액과 상이한 금액을 입금 한 경우, NHN KCP에서는 가맹점에 Webhook 페이지를 통해 실 입금 내역을 통보하고 입금 금액 그대로 가맹점에 정산이 이루어집니다. 해당 페이지에서 DB처리 시 실 입금 금액과 주문금액을 비교해서 상이한 경우 내부적으로 확인해주시기 바랍니다.


number12

totl_mnyx

해당 계좌에 입금 된 금액의 합계
일회성 가상계좌의 경우 ipgm_mnyx와 동일한 금액이 통보되나, 고정식 가상계좌의 경우 해당 계좌에 입금된 총 금액이 통보됩니다.


number20

ipgm_time

가상계좌에 입금된 시간


string2

bank_code

가상계좌 은행코드


string20

account

입금된 가상계좌 번호


string20

noti_id

가상계좌의 각 입금 통보 건에 대한 고유한 값을 가지는 변수
※ 주의 – 가상계좌의 경우 결제 1 건에 대해서 통보가 여러 번 나갈 수 있습니다.
예) 고객이 가상계좌에 입금 후 은행을 통해 취소 요청을 한 경우 은행에서 NHN KCP로 취소 전문이 전송(일회 계좌은행 출금 불가) – 해당 건은 입금 전문1번과 취소 전문 1번이 가맹점으로 통보됩니다.


number2

op_cd

가상계좌 입금 처리 결과 구분 코드
가상계좌는 입금처리 이외에도 은행 공동망을 통한취소가 이루어 질 수 있음.
해당 변수를 통해서 가상계좌 상태 구분을 반드시 해주시기 바랍니다. ‘13’을 제외한 모든 건은 입금 건으로 처리 하시기 바랍니다.
op_cd = ‘13’ 은 입금이 잘못 된 경우로 가맹점에 취소 노티가 나갑니다.


string14

remitter

결제 금액을 입금한 입금자명
주문자명과 다를 수 있습니다.


number14

cash_no

가상계좌 발급 시 현금영수증 등록 요청 건에 대해 입금완료 후 리턴 되는 현금영수증 거래번호

Webhook 파라미터

string5

site_cd

KCP 발급 사이트(상점)코드


string14

tno

결제 완료 후 NHN KCP에서 리턴 하는 거래번호입니다
각 결제 건에 대해 고유의 값 가집니다.
※ 거래고유번호 전체로 사용 하시기 바랍니다.


string40

order_no

가맹점에서 생성한 주문번호


number16

tx_cd

업무처리 구분코드
가상계좌 입금 통보 – TX00


number12

tx_tm

통보된 업무에 대한 업무처리 완료 시간


string4)

result

NHN KCP에서 전송한 결과 데이터를 가맹점 서버에서 정상적으로 받았는지를 확인하기 위한 변수로 가맹점 서버에서 결과 데이터를 정상적으로 받아서 성공적으로 처리한 경우 result 값을 ‘0000’으로 설정
정상적으로 처리 완료되지 못한 경우 임의의 값 설정
result 값을 확인하여 ‘0000’이 아닐 경우 NHN KCP 통보 서버에서 다시 통보함

모의입금 안내

NHN KCP는 테스트 가상계좌 발급 건에 한하여 [모의 입금 페이지]를 제공하고 있습니다.

가상계좌 모의입금 페이지는 NHN KCP 거래번호와 가상계좌번호를 통해 입금대기 상태의 결제 건을 입금완료로 바꾸며,
가상계좌 모의입금 페이지는 테스트 서버에서 일어난 거래 건에 대해서만 유효하며 실 결제에서 일어난 건에 대해서는 사용이 불가능 합니다.

모의 입금 페이지는 아래의 URL을 통해서 접근 할 수 있습니다.

모의입금 페이지 "https://devadmin.kcp.co.kr/Modules/Noti/TEST_Vcnt_Noti.jsp"