준비하기

Note: 개발자센터 연동하기에서는 HTTPS 통신을 위한 API 연동 가이드를 제공합니다. 먼저, 결제수단별 API 연동에 앞서 준비해야 되는 사항에 대해 체크 해주시기 바랍니다.

API를 연동하기 위해 NHN KCP에서 발급해드리는 site_cd가 필요합니다.

- 사이트코드(site_cd) : T0000

위 데이터 예시는 기본적으로 제공 해드리는 테스트 코드값 입니다.

실결제(운영) 환경 코드 발급은 홈페이지 신규신청을 통한 접수 후 발급 부탁 드리겠습니다.

※ 실결제 사이트 적용시에는 연동 메일로 받으신 사이트코드를 반드시 확인하시기 바랍니다.

TLS 1.2 미만의 SSL/TLS 버전은 보안이 취약하므로 지원하지 않습니다.

가맹점 서버의 HTTP 클라이언트 환경이 TLS1.2 이상을 지원하는지 확인해주세요.

① PC버전 OS : 표준WEB(Windows & Mac)

② PC버전 Browser : IE(Ver. 9 ~), Firefox (Ver. 27.0 ~), Chrome (Ver. 30.0 ~), Safari(Ver. 7.0 ~), Opera (Ver. 60.0~)

③ 모바일버전 OS : Android( Ver. 5.0(Lollipop) ~), IOS(Ver. 9.0 ~)

④ 모바일버전 Browser : 스마트폰 기본브라우저

※ 표준 WEB 방식은 Mac 에서 진행 시 일부 카드사 정책으로 지원되지 않을 수 있습니다.

※ 최저 지원 가능한 브라우저는 브라우저 정책에 따라 변경 될 수 있습니다.

결제 서비스 통신을 위해서는 아래 도메인, PORT 에 대해 방화벽 허가를 해주셔야 합니다.

추가적으로, 가맹점 서버의 HTTP 클라이언트 환경이 TLS1.2를 지원하는지 확인해주세요.

HTTPS 결제창 승인처리시

- 운영 : spl.kcp.co.kr:443
- 테스트 : stg-spl.kcp.co.kr:443

모바일 거래등록시

- 운영 : smpay.kcp.co.kr:443
- 테스트 : testsmpay.kcp.co.kr:443

API 승인처리를 위해 NHN KCP 발급 인증서를 활용한 서버 인증 절차가 필요합니다.

서버 인증 절차에 관한 가이드는 서버인증 메뉴를 참고 부탁 드립니다.

가맹점 주문페이지 내 iframe 에서 결제모듈 호출 시 IE, 크롬 브라우저에서 브라우저 보안정책상 정상동작 되지 않을 수 있습니다.

개발 작업 후 서비스 런칭시에는 테스트환경을 리얼환경으로 세팅하셔야 합니다. 테스트 환경에서 리얼환경으로 변경하지 않아 발생하는 손실은 당사는 책임지지 않습니다.

NHN KCP 결제 API에는 데이터베이스 연동 작업을 위한 기능은 포함되어있지 않습니다.
(데이터베이스 연동을 위한 지불 결과 데이터만 제공하며 데이터베이스 처리는 상점에서 구현 바랍니다.)

결제 창 호출 시 요청하는 site_cd 와 승인 요청 시 site_cd 가 다를 경우 결제가 원활하지 않을 수 있습니다.
반드시 결제 인증 및 승인 시 동일한 site_cd 로 요청하시기 바랍니다.

연동에 필요한 라이브러리와 샘플은 다운로드 자료실을 참조해주세요.