KCP · PAYMENT GATEWAY
NHN KCP
PG 연동 안내.
국내 가맹점 결제창과 승인·취소 API 구축에 필요한 NHN KCP 개발자 안내입니다.
KCP · PAYMENT GATEWAY
ROUTE PREVIEW
사용자 기기
Client
HTTPS · 결제 API
연결 중계
PG 결제
주문 서버 · 승인/취소
테스트 키, 서버 승인·취소, 웹훅과 주문 상태 검증을 구성합니다.
PACKET FLOW
현재 결제 미연동
NHN KCP 결제 설정 안내
국내 가맹점 결제창과 승인·취소 API 구축에 필요한 NHN KCP 개발자 안내입니다.
실제 결제에는 가맹점 계약, 비밀 키의 안전한 보관, 서버 승인·취소 API와 테스트가 필요합니다.
IMPLEMENTATION GUIDE
04 IMPLEMENTATION STEPS
NHN KCP 구현 순서
국내 가맹점 결제창과 승인·취소 API 구축에 필요한 NHN KCP 개발자 안내입니다. 결제 결과는 서버에서 주문 정보와 대조해 확정해야 합니다. 가맹점 심사와 실제 결제 API 연동은 별도 작업입니다.
시작 전 준비사항
- KCP 가맹점 등록과 서비스별 계약·심사
- 테스트 상점 정보와 결제수단별 연동 규격
- 서버 주문 검증·승인·취소 및 결과 통지 처리
구현 및 검증 순서
- 가맹 조건과 결제 범위 확인
사업자 국가·업종에서 제공자 계정을 사용할 수 있는지, 수수료·정산·결제 통화와 필요한 수단을 공식 안내에서 확인합니다.
- 테스트 계정·키 구성
테스트 환경에 도메인과 callback·웹훅 주소를 등록하고, 공개 키와 서버 비밀 키를 구분해 개발·운영 설정을 분리합니다.
- 서버 주문·승인 흐름 구현
서버가 주문 금액·통화·사용자 소유권을 계산하고 결제 승인·캡처 결과를 검증한 다음 주문 상태를 확정하도록 구현합니다.
- 취소·웹훅·운영 점검
중복 알림, 실패·지연 승인, 전체·부분 환불과 분쟁 흐름을 테스트합니다. 카드 인증정보나 비밀 키가 로그·클라이언트에 노출되지 않는지 확인합니다.
운영 전 확인 목록
- 가맹점 국가·업종·통화와 제공자 지원 범위를 확인했는가
- 주문 금액·통화와 승인·캡처를 서버에서 검증하는가
- 웹훅·취소·중복 요청을 안전하고 멱등하게 처리하는가
결제수단·가맹점 설정에 따른 최신 매뉴얼과 테스트 절차를 확인하세요. 운영 키를 저장소나 클라이언트 코드에 포함하지 말고, 승인·취소 결과와 주문 상태를 서버에서 대조하세요. 카드번호·CVC 등 인증정보를 자체 서버에 저장하지 마세요.