가상계좌
가상계좌 서비스 연동하기
NHN KCP 가상계좌는 가맹점 주문페이지에서 일회성 계좌번호를 발급하여 계좌에 주문 금액을 입금하는 서비스입니다.
고객이 발급된 가상계좌로 주문 금액을 입금하면 해당 가상계좌는 사용이 종료되며, 이후 동일한 가상계좌로는 추가 입금이 불가능합니다.
따라서 고객이 계좌번호를 알고 있더라도, 사용이 종료된 가상계좌에는 입금할 수 없습니다.
가상계좌 특징
일회성 계좌번호 발급
결제 건마다 고유한 가상계좌번호를 발급하며, 입금이 완료되면 해당 계좌는 자동으로 사용이 종료됩니다.
API 방식 연동
결제창 없이 서버 간 전문통신(API)으로 가상계좌를 발급합니다. 가맹점 서버에서 직접 발급 요청과 응답을 처리합니다.
Webhook 입금 통보
고객이 가상계좌에 입금하면 NHN KCP가 Webhook으로 입금 결과를 실시간 통보합니다. 통보 데이터로 결제를 완료 처리합니다.
사용중지 기능
발급된 가상계좌의 입금을 차단할 수 있는 사용중지 API를 제공합니다. 주문 취소 등 상황에서 활용할 수 있습니다.
가상계좌 서비스 과정
NHN KCP 가상계좌 결제수단은 결제창이 아닌 가상계좌 발급 정보를 서버에서 보내는(전문통신) API 방식으로 제공합니다.
1. 가상계좌 발급하기
가맹점은 서비스 인증서와 함께 가상계좌 발급 요청 데이터를 NHN KCP API URL로 전송하여 가상계좌를 발급받습니다.
발급에 성공하면 발급 성공 응답 파라미터와 함께 res_cd가 V000 값으로 응답됩니다.
발급에 실패하면 res_cd, res_msg, res_en_msg 외의 발급 응답 데이터는 리턴되지 않습니다.
2. 가상계좌 모의입금 하기
KCP에서 제공하는 가상계좌 모의입금 페이지를 사용하면, KCP 거래번호와 가상계좌번호를 입력해 입금대기 상태의 거래를 입금완료 상태로 변경할 수 있습니다. 입금완료로 변경되면 KCP는 가맹점의 Webhook 페이지로 입금 결과 데이터를 전송합니다.
이때 가맹점 Webhook URL이 KCP 파트너 관리자에 미리 등록되어 있어야 합니다.
Webhook URL이 미등록 상태이면 입금 통보를 수신할 수 없으며, 고객의 입금 사실을 확인할 수 없습니다.
모의입금 테스트 방법
- 모의입금 페이지에 접속합니다.
- 입금 통보 파라미터를 확인하고, Webhook 수신 페이지의 코드를 작성합니다.
- 가맹점 서버에 Webhook 페이지를 업로드하여 URL을 생성합니다.
- 모의입금 테스트 페이지에서 KCP 거래번호, 가상계좌번호, 입금자명, 입금 통보 URL을 입력합니다.
- 가맹점에서 DB Update 여부를 확인합니다.
모의입금 후 가맹점 DB에 Webhook 데이터를 정상 처리했다면, NHN KCP로 result 결과를 반환하세요.
<input type="hidden" name="result" value="0000"> 또는 "result":"0000"
3. 가상계좌 사용 중지하기
발급된 가상계좌에 입금할 수 없도록 사용 중지 요청을 할 수 있습니다.
이때 가상계좌 상태 값이 사용 중지 처리되는 것으로, 입금 완료된 가상계좌의 경우 환불 처리되지 않습니다.
가상계좌 사용 중지 요청 시에는 부인방지를 위한 서명데이터 값이 필요하며 site_cd+"^"+tno+"^"+mod_type 규칙으로 생성한 뒤 SHA256withRSA 알고리즘으로 인코딩하여 요청하세요.