간편결제 VAN 연동 개요

이 가이드는 이지페이(EasyPay) 간편결제를 통해 사용자 인증을 완료한 후, 실제 결제 승인은 KICC VAN 시스템을 통해 처리하는 방식을 설명합니다.

가장 큰 특징은 별도의 온라인 전용 ID를 발급받을 필요 없이, 기존에 사용 중인 오프라인 단말기 ID를 그대로 사용하여 온라인 결제를 승인하고 통합 정산받을 수 있다는 점입니다.

서비스 특징

새로운 PG 계약이나 ID 발급이 필요 없습니다. 매장에서 사용 중인 POS/단말기 ID(Van TID)를 그대로 사용하여 이지페이 간편결제를 연동할 수 있습니다.

오프라인 매장 매출과 온라인 간편결제 매출이 하나의 VAN ID로 합산되어 입금 및 정산 관리가 매우 효율적입니다.

결제는 크게 [1. 사용자 인증] 단계와 [2. VAN 승인] 단계로 나뉩니다.

VAN 결제 시스템 연동 시 가장 중요한 것은 데이터 정합성입니다.

가맹점 서버에서 VAN 시스템으로 승인을 요청했으나, 네트워크 타임아웃(Timeout) 이나 시스템 오류(응답 없음) 로 인해 결과를 받지 못한 경우, 실제로는 승인이 되었을 수도 있습니다.

이때 반드시 망취소(Net-Cancel) API를 호출하여 해당 거래를 즉시 무효화해야 합니다.

개발자 필독 (망취소 로직)

승인 요청(Approve) 후 다음과 같은 상황이 발생하면 무조건 망취소 API를 호출해야 합니다.