연동 로드맵
처음 보는 개발자를 위한 안내 지도, KCP의 로드맵으로 문서를 빠르게 찾아보세요.
어떤 결제 서비스를 연동하고 싶나요?
연동하고 싶은 서비스를 선택하세요. 선택한 서비스를 연동할 때 필요한 문서를 찾아 드리겠습니다.
추천
표준결제
카드, 계좌이체, 휴대폰, 상품권, 포인트
LITE
LITE PAY
카드, 계좌이체, 휴대폰, 상품권, 포인트
자동결제
카드
간편결제
페이코, 카카오페이, 네이버페이, 토스페이 등
에스크로
계좌이체, 가상계좌
가상계좌
일회성 계좌번호 발급
표준결제
신용카드, 계좌이체, 휴대폰, 상품권, 포인트 등 모든 결제수단을 제공하는 KCP의 Standard 서비스입니다.
참조 문서
LITE PAY
신용카드, 계좌이체, 휴대폰, 상품권, 포인트 등 모든 결제수단을 제공하며 PC/모바일 모두 동일한 API 흐름으로 처리하므로 코드 구조가 단순한 서비스입니다.
참조 문서
자동결제
카드를 등록하고 배치키를 발급받아 정기적으로 자동 승인하는 결제 서비스입니다.
구독 서비스, 월정액 요금, 회원권 등 반복 과금이 필요한 서비스에 적합합니다.
구독 서비스, 월정액 요금, 회원권 등 반복 과금이 필요한 서비스에 적합합니다.
참조 문서
간편결제
카카오페이, 네이버페이, 토스페이, 삼성페이 등 다양한 제휴 간편결제를 연동하는 서비스입니다.
표준결제 연동에 포함되어 있으며, 별도 계약 후 결제창에 간편결제 수단이 노출됩니다.
표준결제 연동에 포함되어 있으며, 별도 계약 후 결제창에 간편결제 수단이 노출됩니다.
참조 문서
에스크로
구매자의 결제 금액을 NHN KCP가 보관하고, 구매 확인 후 판매자에게 정산하는 안전거래 서비스입니다.
전자상거래법에 따라 배송이 수반되는 상품 거래 시 에스크로 또는 구매안전 서비스를 제공해야 합니다.
전자상거래법에 따라 배송이 수반되는 상품 거래 시 에스크로 또는 구매안전 서비스를 제공해야 합니다.
참조 문서
가상계좌
결제 건마다 고유한 일회성 가상계좌번호를 발급하여, 고객이 해당 계좌에 주문 금액을 입금하는 서비스입니다.
결제창 없이 서버 간 API 통신으로 발급하며, 입금 완료는 Webhook으로 통보됩니다.
결제창 없이 서버 간 API 통신으로 발급하며, 입금 완료는 Webhook으로 통보됩니다.
참조 문서
연동 단계별 추천 경로
처음부터 끝까지 순서대로 확인해야 한다면 아래 흐름으로 이동하세요.
1.
2.
3.
자주 묻는 질문
표준결제와 LITE PAY의 차이점은 무엇인가요?
일반결제(신용카드, 휴대폰, 계좌이체 등)를 연동할 때 두 가지 방식 중 선택할 수 있습니다.
표준결제는 PC와 모바일을 별도로 운영하고 있어 각 환경에 최적화된 연동을 원하는 경우,
LITE PAY는 신규 서비스를 시작하며 가장 간결한 API 구조로 빠르게 연동하고 싶은 경우에 추천드립니다.
| 구분 | Standard표준결제 | LITELITE PAY |
|---|---|---|
| 추천 상황 | 환경별 최적화 PC와 모바일을 각각의 결제창 구조에 맞춰 연동하려는 경우에 적합합니다. | 빠른 신규 연동 PC와 모바일을 동일한 API 흐름으로 간결하게 연동하려는 경우에 적합합니다. |
| PC / Mobile 연동 | PC와 Mobile 분리 PC는 JS 스크립트로 결제창을 호출하고, Mobile은 거래등록 API를 먼저 요청합니다. | PC와 Mobile 통합 PC와 Mobile 모두 거래등록 API 기반의 동일한 흐름으로 처리합니다. |
| 거래등록 | Mobile 결제창 호출 시 필수입니다.PC 표준결제는 거래등록 없이 결제창 호출이 가능합니다. | PC / Mobile 모두 필수입니다.거래등록 응답값을 기반으로 결제창을 호출합니다. |
| 서명데이터 | 결제 승인 흐름에서는 별도 서명데이터가 필요하지 않습니다. | SHA256withRSA 서명데이터 사용 API 요청 시 개인키 기반 서명데이터를 생성해 전달합니다. |
| 결제창 유형 지정 | PC 결제창과 Mobile 결제창을 각각의 방식으로 연동합니다. | reg_type 값으로 결제창 유형을 지정합니다.web / mobile 중 선택하여 설정합니다. |
| 연동 특징 | 기존 표준결제 구조와 호환성이 높고, PC·모바일 환경별 제어가 용이합니다. | API 흐름이 단순해 신규 서비스 구축, 빠른 연동, 공통 로직 관리에 유리합니다. |
| 승인 요청 URL | https://spl.kcp.co.kr/gw/enc/v1/payment | |
결제 서비스를 무엇으로 선택할지 모르겠어요.
위 어떤 결제 서비스를 연동하고 싶나요?에서 서비스를 선택하면 참조 문서를 안내받을 수 있습니다. 구현하려는 결제 방식과 서비스 특성에 맞는 연동 방법을 선택하는 데 도움이 됩니다.
반복 결제나 구독 결제를 만들고 싶어요.
자동결제에서 배치키 발급, 배치키 승인, 배치키 관리 흐름을 확인하세요. 발급한 배치키를 이용해 반복 결제나 구독 결제를 구성할 수 있습니다.
가상계좌 입금 완료를 확인하고 싶어요.
결제정보 위변조를 막을 수 있나요?
네. 결제검증에서 결제금액, 결제수단, 주문번호를 검증하는 방법을 확인하세요. 주요 결제정보를 서버에서 검증해 위변조 여부를 확인할 수 있습니다.
Guide와 API Reference의 차이점은 무엇인가요?
Guide에서 전체 흐름을 이해한 뒤, 실제 요청·응답 필드와 전문 규격을 확인할 때 API Reference를 함께 보면 좋습니다.
Guide에서 “왜 이 단계가 필요한지”를 먼저 확인하고, API Reference에서 “어떤 필드를 어떤 값으로 보내야 하는지”를 확인하세요.