🏬 VAN Payment Integration Guide
KICC VAN payment services are primarily divided into 'EasyTalkPay', a non-face-to-face payment solution, and the 'Simple Payment Dedicated API' for building your own payment system. Please select the integration method that fits your service model.
For VAN payment services, the API domains differ for each payment service. Please ensure you verify the correct domain before proceeding with the integration.
📱 1. EasyTalkPay
Process non-face-to-face payments within your app or by sending a payment link (URL) to customers. This is categorized into the EasyShop Dispatch Method and the API Integration Method.
🆚 EasyShop Dispatch vs. API Integration
| Category | EasyShop Dispatch | API Integration |
|---|---|---|
| Method | Send payment links via EasyShop (AlimTalk) | Invoke the EasyTalkPay Payment Window via API |
| Pros | Immediate use without development | Seamless integration within the merchant's server |
| Target | Call centers, small businesses | E-commerce, booking platforms, O2O services |
- This guide focuses on the API Integration Method.
🚀 2. Simple Payment Dedicated Guide (VAN API)
This is a pure API guide for processing EasyPay Simple Payment through the VAN network (financial network). You can approve payments quickly and efficiently via our REST API.
🛠️ Provided API List
The core functions consist of Approval, Cancellation, and Net-Cancel, which serves as a safety mechanism for VAN communications.
| Function | Description | Endpoint Example |
|---|---|---|
| Payment Approval | Requests a payment with a registered card. | POST /smpy/kiccpay/reqAprv |
| Payment Cancellation | Cancels (refunds) an approved transaction. | POST /smpy/kiccpay/reqCancel |
| Net-Cancel | (Critical) Used when no response is received after an approval request. | POST /smpy/kiccpay/reqRtran |
⚠️ What is a Net-Cancel (Network Cancel)?
This is an essential concept in the VAN payment environment. If a merchant sends an approval request but fails to receive a 'Success/Failure' response (Unknown status) due to a network timeout, etc., this API must be used to invalidate that transaction to prevent potential duplicate payments.
If a Time-out occurs or a response is not received after calling the Payment Approval API, you MUST implement a logic to call the Net-Cancel API to ensure data integrity.