Guide > 가상계좌
가상계좌
가상계좌
가상계좌 서비스 연동하기
NHN KCP 가상계좌는 가맹점 주문페이지에서 일회성 계좌번호를 발급하여 계좌에 주문 금액을 입금하는 서비스입니다.
NHN KCP는 각 은행으로부터 다수의 가상계좌를 사전에 발급받아 관리합니다.
가맹점에서 가상계좌 결제를 요청하면, NHN KCP는 보유 중인 가상계좌 중 하나를 해당 결제 건에 대해 발급해 드려요.
고객이 발급된 가상계좌로 주문 금액을 입금하면 해당 가상계좌는 사용이 종료되며, 이후 동일한 가상계좌로는 추가 입금이 불가능합니다.
따라서 고객이 계좌번호를 알고 있더라도, 사용이 종료된 가상계좌에는 입금할 수 없어요.
✅ 가상계좌 서비스에 대한 API 및 파라미터는 API Reference를 확인해 주세요.
가상계좌 서비스 과정
NHN KCP 가상계좌 결제수단을 결제창이 아닌 가상계좌 발급 정보를 서버에서 보내는(전문통신) API 방식으로 제공합니다.
1. 서비스 인증서 적용하기
서비스 인증서는 가맹점 인증과 부인 방지를 위해 API 결제 서비스에서 사용돼요.
NHN KCP는 가맹점이 전달한 서비스 인증서 정보를 검증하고, 해당 결제 요청에 대한 결과를 응답합니다.
✅ 서비스 인증서에 대한 자세한 내용은 API Reference의 KCP PG-API를 확인해 주세요.
2. 가상계좌 발급
가맹점은 서비스 인증서와 함께 가상계좌 발급 요청 데이터를 NHN KCP API URL로 전송하여, 가상계좌를 발급받습니다.
가상계좌 발급 성공의 경우 발급 성공 응답 파라미터와 함께 res_code가 [V000]의 값으로 응답되며
가상계좌 발급 실패의 경우 res_cd, res_msg, res_en_msg 외 발급 응답 데이터가 리턴되지 않습니다.
✅ 가상계좌는 다른 결제수단과 다르게 가상계좌 발급 API를 호출하면 가상계좌가 발급된 것이지, 결제가 완료된 게 아닙니다.
따라서 가상계좌 발급은 [V000] 로 응답되며, 가상계좌 입금 완료는 Webhook 입금통보로 응답됩니다.
반드시 Webhook으로 입금통보 받은 데이터로 결제를 처리해주세요.
3. 가상계좌 모의입금
가상계좌 모의 입금 페이지는 NHN KCP 거래 번호와 가상계좌번호를 통해
입금 대기 상태의 결제 건을 입금 완료로 바꾸며 Webhook 테스트를 진행할 수 있습니다.
✅ Webhook에 대한 자세한 사항은 Guide의 웹훅 페이지를 참고해 주세요.
🔗 모의 입금 테스트 페이지
https://testadmin.kcp.co.kr/Modules/Noti/TEST_Vcnt_Noti.jsp
✅ 모의 입금 테스트 방법
1.입금 통보 파라미터를 확인하여 샘플 내에 Webhook 페이지의 코드를 작성합니다.
2.가맹점 서버에 Webhook 페이지를 업로드하여 URL을 생성합니다.
3.모의 입금 테스트 페이지에서 KCP 거래번호, 가상계좌번호, 입금자명, 입금 통보 URL을 기입합니다.
4.가맹점에서 DB Update 여부를 체크합니다.
이렇게 모의입금 후, 가맹점 DB에 통보 데이터를 정상 처리 했을 경우 NHN KCP로 result 결과를 반환해주세요.
<input type="hidden" name="result" value="0000"> 또는 "reulst":"0000"
4. 가상계좌 사용중지
발급된 가상계좌에 입금할 수 없도록 사용 중지 API URL로
서비스 인증서와 서명데이터, tno, mod_type을 전달하여 처리합니다.
가상계좌 사용 중지 요청 시에는 부인방지를 위한 서명데이터 값이 필요하며
site_cd+”^”+tno+”^”+mod_type
규칙으로 생성하며 SHA256withRSA 알고리즘을 통하여 인코딩 후 요청해야 합니다.
🚨 단, 이미 입금 완료된 가상계좌의 경우 환불처리 되지 않습니다.
✅ 서명데이터에 대한 자세한 설명은 API Reference의 서명데이터 메뉴를 참고해 주세요.