Simple Payment VAN Integration Overview
This guide explains the integration method where user authentication is completed via EasyPay Simple Payment, while the actual payment approval is processed through the KICC VAN system.
The key advantage of this service is that it allows you to process online payments and receive integrated settlement by using your existing offline terminal ID, without the need to issue a separate online-only ID.
Service Features
1. Use of Existing Offline VAN IDs
No new PG contracts or additional IDs are required. You can integrate EasyPay Simple Payment using the same POS/Terminal ID (VAN TID) currently used in your physical stores.
2. Integrated Revenue Management
Revenue from physical stores and online simple payments are consolidated under a single VAN ID, making deposit and settlement management highly efficient.
3. Decoupled Authentication and Approval
- Authentication (Auth): The user enters their Payment PIN and completes authentication through the Simple Payment service.
- Approval (Approve): The actual card transaction and fund transfer are processed by calling the VAN API.
Process Flow
The payment process is divided into [1. User Authentication] and [2. VAN Approval] stages.
Mandatory Requirement: Net-Cancel
Maintaining data integrity is the most critical factor when integrating with the VAN payment system.
If a merchant server requests approval from the VAN system but fails to receive a response due to a Network Timeout or System Error, the transaction might have actually been approved. In such cases, you must immediately invalidate the transaction by calling the Net-Cancel API.
After sending an approval request (Approve), you MUST call the Net-Cancel API if any of the following occur:
- Read Timeout: No response is received within the configured time (Recommended: 30 seconds).
- Communication Error: Connection loss, socket errors, etc.
- Parsing Failure: The response is not in a valid JSON/Standard format.