🚀 샌드박스 환경(Sandbox Environment)
환영합니다! 샌드박스(Sandbox)는 실제 결제가 발생하지 않는 안전한 가상 테스트 환경입니다.
상용(Production) 환경에 코드를 배포하기 전에, 이곳에서 API 연동부터 에러 처리, 취소 로직까지 모든 시나리오를 마음껏 실험해 보세요.
🛑 필독: 실제 돈이 나가지 않습니다
샌드박스 환경에서의 모든 결제 요청은 가상으로 처리됩니다. 실제 신용카드 번호를 입력해도 카드사로 전송되지 않으며, 청구서에 찍히지 않습니다.
🆚 샌드박스 vs 상용 환경 차이점
개발 시 혼동을 줄이기 위해 두 환경의 차이점을 명확히 확인하세요.
| 구분 | 샌드박스 (Sandbox) | 상용 환경 (Real/Production) |
|---|---|---|
| API 도메인 | https://testpgapi.easypay.co.krhttps://testapi.easypay.co.kr | https://pgapi.easypay.co.krhttps://api.easypay.co.kr |
| 결제 수단 | 실제 고객의 신용카드 사용 가능 | 실제 고객의 신용카드 사용 가능 |
| 실제 과금 | 발생 안 함 (0원) | 실제 청구됨 |
| 데이터 보관 | 매일 자정 초기화 (휘발성) | 법적 보관 기간 준수 (5년) |
| 결제알람 메일 | 발송되지 않음 | 고객에게 실제 발송됨 |
🛠️ 무엇을 테스트할 수 있나요?
KICC 샌드박스는 실제 결제 프로세스와 99% 동일한 응답을 내려줍니다.
- 정상 승인/취소: 결제 흐름이 정상적으로 타는지 확인 (HTTP 200 OK)
- 오류 처리 (Error Handling): 잔액 부족, 한도 초과, 비밀번호 오류 등 다양한 에러 케이스에 대한 방어 로직 점검
- 네트워크 타임아웃: 서버 응답이 지연될 때(Timeout) 클라이언트가 어떻게 반응하는지 테스트
- 웹훅(Webhook) 수신: 가상 계좌 입금 통보 등이 내 서버로 제대로 들어오는지 확인
🚦 시작하기 (Quick Start)
본격적인 테스트를 위해 아래 순서대로 진행해 주세요.
1️⃣ 키 발급받기
API 호출을 위한 테스트용 Secret Key를 즉시 발급받으세요.
2️⃣ API 체험하기
코드를 짜기 전, 웹상에서 파라미터를 입력하고 응답을 확인하세요.
💡 팁: 로컬 개발 환경 설정
샌드박스 API를 호출할 때 CORS 에러를 피하기 위해, 개발 중인 프론트엔드 프로젝트(React, Vue 등)에서 Proxy 설정을 권장합니다.