🚀 Sandbox Environment
Welcome! The Sandbox is a safe, virtual testing environment where no actual payments occur.
Before deploying code to Production, feel free to experiment with all scenarios here, from API integration to error handling and cancellation logic.
All payment requests in the Sandbox environment are processed virtually. Even if you enter a real credit card number, it is not transmitted to the card company, and no bill will be issued.
🆚 Sandbox vs. Production
To avoid confusion during development, please clearly understand the differences between the two environments.
| Feature | Sandbox | Production (Real) |
|---|---|---|
| API Domain | https://testpgapi.easypay.co.krhttps://testapi.easypay.co.kr | https://pgapi.easypay.co.krhttps://api.easypay.co.kr |
| Payment Method | Real credit card numbers accepted | Real credit card numbers accepted |
| Actual Billing | Not Charged (0 KRW) | Actually Charged |
| Data Retention | Reset daily at midnight (Volatile) | 5 years (Legal Compliance) |
| Alert Emails | Not sent | Sent to customer |
🛠️ What can I test?
The KICC Sandbox provides 99% identical responses to the actual payment process.
- Normal Approval/Cancel: Verify that the payment flow works correctly (HTTP 200 OK).
- Error Handling: Check your defense logic against various Error Cases such as Insufficient Balance, Exceeded Limit, or Wrong Password.
- Network Timeout: Test how your client reacts when the server response is delayed (Timeout).
- Webhook Reception: Verify that notifications (e.g., Virtual Account deposit) reach your server correctly.
🚦 Quick Start
Please proceed in the following order to start testing.
1️⃣ Get Key
Get a test Secret Key for API calls immediately.
2️⃣ Try API
Before coding, input parameters on the web and check responses.
To avoid CORS errors when calling Sandbox APIs, we recommend configuring Proxy settings in your frontend project (React, Vue, etc.) during development.