🏬 VAN 결제 연동 가이드
KICC VAN 결제 서비스는 크게 비대면 결제 솔루션인 '이지톡페이' 와, 자체 페이 구축을 위한 '간편결제 전용 API' 로 나뉩니다. 귀사의 서비스 형태에 맞는 연동 방식을 선택하세요.
🚨 중요: API 도메인 확인
VAN 결제 서비스의 경우 결제 서비스별 API 도메인이 상이합니다. 반드시 도메인을 꼭 확인하여 주시기 바랍니다.
📱 1. 이지톡페이 (EasyTalkPay)
고객에게 결제 링크(URL)를 보내거나, 앱 내에서 비대면 결제를 처리합니다. 연동 방식에 따라 이지샵 발송방식과 API 연동방식으로 구분됩니다.
🆚 이지샵 발송방식 vs API 연동방식
| 구분 | 이지샵 발송 | API 연동 |
|---|---|---|
| 방식 | 이지샵에서 알림톡 발송으로 결제 진행 | 이지톡페이 전용 결제창을 호출하여 결제 진행 |
| 장점 | 개발이 필요없이 로그인 후 즉시 사용 | 상점 서버에서 직접 API호출하여 결제처리 |
| 대상 | 콜센터, 소규모 사업자 | 쇼핑몰, 예약 플랫폼, O2O 서비스 |
- 본 가이드에서는 API 연동방식을 제공하고 있습니다.
🚀 2. 간편결제 전용 가이드 (VAN API)
앞서 소개한 이지페이 간편결제 를 VAN 망(오프라인망) 을 통해 처리하기 위한 순수 API 가이드입니다. REST API를 통해 빠르고 가볍게 결제를 승인할 수 있습니다.
🛠️ 제공 API 목록
핵심 기능은 승인, 취소, 그리고 VAN 통신의 안전장치인 망취소로 구성됩니다.
| 기능 | 설명 | Endpoint 예시 |
|---|---|---|
| 결제 승인 | 등록된 카드로 결제를 요청합니다. | POST /smpy/kiccpay/reqAprv |
| 결제 취소 | 승인된 거래를 취소(환불)합니다. | POST /smpy/kiccpay/reqCancel |
| 망취소 (Net Cancel) | (중요) 승인 요청 후 응답을 받지 못했을 때 사용합니다. | POST /smpy/kiccpay/reqRtran |
⚠️ 망취소(Network Cancel)란?
VAN 결제 환경에서는 필수적인 개념입니다. 상점이 승인 요청을 보냈으나 네트워크 타임아웃 등으로 '성공/실패 응답을 받지 못한 상태(Unknown)' 일 때, 혹시 모를 중복 결제를 막기 위해 해당 거래를 무조건 취소시키는 API입니다.
개발자 필독
결제 승인 API 호출(Request) 후 Time-out이 발생하거나 응답(Response)을 수신하지 못한 경우, 반드시 망취소 API를 호출하는 로직을 구현해야 데이터 무결성이 보장됩니다.