연동준비

간편페이 연동 체크리스트〉

간편페이 연동 체크리스트는 기존에 페이플을 이용하시는 파트너사에서 추가로 확인해야 할 부분만 정리한 문서입니다.
기본 연동 방법은 국내카드 > 앱카드 결제 및 파라미터 > 국내카드 > 앱카드 결제 문서를 참고해 주세요.

안내사항

기존에 페이플을 사용 중인 파트너사는 간편페이 연동 개발 후 운영환경 적용을 위해서는 페이플에서 간편페이 사용을 위한 설정 변경이 필요합니다.
운영 오픈 일정(일자/시간)을 반드시 사전에 페이플에 공유해 주세요.
신규 파트너사는 별도의 공유 과정 없이 바로 연동하실 수 있습니다.

연동 체크포인트

기존에 페이플 국내 카드 결제를 연동하신 파트너사에서 네이버페이, 카카오페이 등의 간편페이를 추가로 연동하실 때 확인해야 하는 체크포인트입니다.
아래 단계에 따라 차례대로 진행해주세요.

1. JavaScript 파일 변경

Client

기존에 cpay.payple.1.0.1.js를 사용하고 계신 경우, 신규 간편페이 연동을 위해 JavaScript 파일 변경이 필요합니다.

구분	JavaScript 파일 경로
기존	`cpay.payple.kr/js/cpay.payple.1.0.1.js`
변경	`cpay.payple.kr/js/v1/payment.js`

script.html

HTML

1<!-- 기존 스크립트 -->
2<script src="https://cpay.payple.kr/js/cpay.payple.1.0.1.js"></script>
3
4<!-- 변경 후 스크립트 (브라우저 캐시 방지를 위한 버전 파라미터 포함) -->
5<script src="https://cpay.payple.kr/js/v1/payment.js?v=20250613090000"></script>

·주의사항

브라우저 캐시로 인한 구버전 파일 참조를 방지하기 위해 버전 파라미터를 추가해주세요.
버전 값은 YYYYMMDDHHMMSS 형식으로 구성합니다.

2. 결제창 호출 함수 파라미터 변경

Client

PaypleCpayAuthCheck 함수 호출 시 인증 방식을 변경해야 합니다.

기존 방식: 서버에서 인증 요청 → 응답 데이터에서 AUTH_KEY 추출 → JavaScript에서 사용
새로운 방식: 서버 인증 과정 없이 clientKey를 JavaScript에서 직접 사용

구분	인증 파라미터
기존	`AUTH_KEY` 사용
변경	`clientKey` 사용

payment.js

JavaScript

1// 기존 방식 (서버에서 받아온 AUTH_KEY 사용)
2obj.AUTH_KEY = "E342THJ4ZXB2742 93JAHSJ3";
3
4// 변경 후 방식 (clientKey 직접 사용)
5obj.clientKey = "test_DF55F29DA654A8CBC0F0A9DD4B556486";

·주의사항

clientKey는 파트너 관리자 > 상점 정보 > 기본 정보 항목에서 확인하실 수 있습니다.
기존 AUTH_KEY 방식은 과거 연동 방식으로, 원활한 유지보수와 새로운 간편페이 기능 지원을 위해 변경이 필요합니다.

3. 간편페이 관련 파라미터

Optional

간편페이 연동 시 사용할 수 있는 요청/응답 파라미터는 다음과 같습니다.

· 요청 파라미터

파라미터 필수여부 설명

파라미터	필수여부	설명
`PCD_PAY_METHOD`	선택	특정 간편페이만 결제창에 단독 노출하고 싶은 경우 사용 `appCard`: 앱카드 `naverPay`: 네이버페이 `kakaoPay`: 카카오페이

PCD_PAY_METHOD

선택

특정 간편페이만 결제창에 단독 노출하고 싶은 경우 사용

appCard: 앱카드

naverPay: 네이버페이

kakaoPay: 카카오페이

payment.js

JavaScript

1// 네이버페이만 선택 가능한 결제창 호출
2obj.PCD_PAY_METHOD = "naverPay";
3
4// 카카오페이만 선택 가능한 결제창 호출
5obj.PCD_PAY_METHOD = "kakaoPay";
6
7// 앱카드만 선택 가능한 결제창 호출
8obj.PCD_PAY_METHOD = "appCard";

· 응답 파라미터

파라미터 수신시점 설명

파라미터	수신시점	설명
`PCD_PAY_METHOD`	인증 결과 승인 결과	구매자가 선택한 결제 수단 `appCard`: 앱카드 `naverPay`: 네이버페이 `kakaoPay`: 카카오페이
`PCD_EASY_PAY_METHOD`	인증 결과 승인 결과	선택한 결제 수단의 상세 유형 `card`: 카드 `point`: 머니/포인트 ⚠️ 카카오페이 주의사항 다른 간편페이와 달리 카카오페이만 승인 결과에서만 해당 파라미터가 전송됩니다.

PCD_PAY_METHOD

인증 결과
승인 결과

구매자가 선택한 결제 수단

appCard: 앱카드

naverPay: 네이버페이

kakaoPay: 카카오페이

PCD_EASY_PAY_METHOD

인증 결과
승인 결과

선택한 결제 수단의 상세 유형

card: 카드

point: 머니/포인트

⚠️ 카카오페이 주의사항
다른 간편페이와 달리 카카오페이만 승인 결과에서만 해당 파라미터가 전송됩니다.

4. 연동 완료

모든 연동 작업을 완료하셨습니다.
상세한 연동 방법은 국내카드 > 앱카드 결제 및 파라미터 > 국내카드 > 앱카드 결제 문서를 참고해 주세요.