연동환경 구성

테스트 환경과 운영 환경

NHN KCP는 테스트 환경과 운영 환경을 제공합니다.
테스트 환경은 운영 환경과 모든 기능이 동일하게 동작하며, 실제 서비스와 동일한 조건에서 연동 개발이 가능합니다.

아래는 테스트 환경과 운영 환경의 기본 설정 값입니다.

구분	테스트	운영
결제창	모바일(거래등록) : https://testsmpay.kcp.co.kr 표준결제창 : https://testspay.kcp.co.kr/plugin/kcp_spay_hub.js	모바일(거래등록) : https://smpay.kcp.co.kr 표준결제창 : https://spay.kcp.co.kr/plugin/kcp_spay_hub.js
결제 승인 (SPL)	stg-spl.kcp.co.kr / PORT 443	spl.kcp.co.kr / PORT 443
HUB API	testpaygw.kcp.co.kr / PORT 8090	paygw.kcp.co.kr / PORT 8090
KCP PAY UI	https://testquickpay.kcp.co.kr / PORT 8200	https://quickpay.kcp.co.kr / PORT 8200
KCP PAY API	https://testqpay-api.kcp.co.kr / PORT 443	https://qpay-api.kcp.co.kr / PORT 443
사이트코드	`T0000` 일반결제 (표준결제, LITE PAY) `AO0OZ` KCP PAY (간편결제) `A52Q7` 자동결제 (자동결제)	가맹점별 계약 시 발급된 코드값
Webhook IP	210.122.176.144	103.215.144.173 / 103.215.144.174 210.122.72.173

NHN KCP 결제 서버와 통신하려면 아래 도메인 및 포트에 대한 방화벽 허용이 필요합니다. TLS 1.2 이상을 지원해야 합니다.
NHN KCP Webhook(가상계좌 입금 통보 등)을 수신하려면, Webhook IP에 대한 인바운드 허용도 필요합니다.

가맹점 서버에서 NHN KCP로 요청을 보내려면, 아래 도메인·포트에 대한 아웃바운드 허용이 필요합니다.

테스트 환경에서 테스트를 정상적으로 진행했다면, 운영 환경으로 전환해야 합니다.
아래와 같이 사이트코드, 서비스 인증서, 운영 API URL을 변경 후 운영을 시작하세요.

KCP와 계약하면 귀사의 고유 사이트코드가 발급됩니다.
발급받은 사이트코드를 테스트 사이트코드를 적용한 곳에 동일하게 적용하세요.

KCP 파트너관리자에서 PEM 형태의 서비스 인증서를 발급받고,
서비스 인증서를 테스트 서비스 인증서를 적용한 곳에 동일하게 적용하세요.

서비스 인증서·개인키 발급 방법은 KCP PG-API를 확인하세요.

테스트 환경의 API URL을 운영 환경 URL로 변경하세요. 각 URL은 API Reference에 상세히 설명되어 있습니다.

서비스	테스트 환경	운영 환경
거래등록	https://testsmpay.kcp.co.kr/trade/register.do	https://smpay.kcp.co.kr/trade/register.do
결제 승인	https://stg-spl.kcp.co.kr/gw/enc/v1/payment	https://spl.kcp.co.kr/gw/enc/v1/payment
표준결제 결제창 스크립트	https://testspay.kcp.co.kr/plugin/kcp_spay_hub.js	https://spay.kcp.co.kr/plugin/kcp_spay_hub.js