🔑

🆕 비밀번호 간편결제 (카드 / 계좌)

•

이 글의 목차

Payple Payment Script

3-5-1. 요청이 성공했을 경우(success)

3-5-2. 요청이 실패했을 경우(error / close)

3-6 결제요청 재컨펌 (PCD_PAY_WORK: CERT)

1. 비밀번호 간편결제란?

•

6자리 비밀번호를 설정하고 재결제시 비밀번호를 인증받아 결제를 처리하는 서비스입니다

결제 연동 전, 이곳에서 페이플 결제를 직접 체험해보세요!

다른 결제방식의 연동방식을 안내받고 싶다면 이곳 을 클릭해서 확인해보세요.

비밀번호 간편결제창 미리보기

*비밀번호 설정 혹은 결제창이 나오기 전, 결제방식과 결제방법에 따라 선행되는 창은 다를 수 있습니다.

비밀번호 설정

비밀번호 설정 확인

비밀번호 결제

2. 프로세스 개요

비밀번호 간편결제의 결제 프로세스는 다음과 같이 진행됩니다.

이 문서에서는 @7/6/2023 이후로 추가된 클라이언트 키(clientKey)로 파트너 인증을 하는 방식의 결제창 호출 가이드를 설명합니다.

3. 첫등록& 첫결제

3-1. 구매버튼 클릭

고객 결제페이지(Web)

•

고객이  파트너의 쇼핑몰에서 비밀번호 등록을 요청했습니다.

3-2. 결제요청

파트너 결제페이지(Web)

클라이언트 키(clientKey)로 파트너 인증을 하고 결제창을 호출하는 경우,

파트너사의 등록 도메인과 결제창 호출 도메인의 메인 도메인이 일치하는지 검증합니다.

즉, 결제창 호출 도메인의 메인 도메인이 등록되어있지 않다면 파트너 인증이 실패되어 요청이 거부되니, 이 점 꼭 유의해주세요!

결제창 만료 시간은 30분이니, 이 점 참고하여 결제 진행해주시기 바랍니다.

Payple Payment Script

•

결제창을 호출할 수 있는 스크립트를 추가하여 페이플에 요청합니다.

@7/6/2023 이후 추가된 클라이언트 키(clientKey) 방식의 파트너 인증 방식으로 결제창을 호출하는 경우, 아래 스크립트를 추가하여 요청하셔야하니 참고해주시기 바랍니다.

// 서버별 페이플 국내결제 스크립트 추가
<script src="https://democpay.payple.kr/js/v1/payment.js"></script> // 테스트(TEST)
<script src="https://cpay.payple.kr/js/v1/payment.js"></script> // 운영(REAL)
JavaScript
복사
페이플 결제창 스크립트 추가

•

페이플 국내결제 스크립트를 추가한 후 결제요청 파라미터를 Object 객체에 담아 PaypleCpayAuthCheck(Object)를 호출하면 결제창이 열립니다.

결제창 요청 예시

// 페이플 국내결제 결제창 호출
function requsetPayplePay() {
	// obj에 결제요청 파라미터 저장
	let obj = new Object();

	/* 중략 */
	
	// 결제요청 함수 호출 
	PaypleCpayAuthCheck(obj); 
}
JavaScript
복사
JavaScript

샘플코드는 파라미터 정보 하단과 연동가이드 > 샘플코드에서 확인해보세요!

PCD_PAY_OID Parameter는 거래의 고유식별번호입니다. 요청시마다 유니크하게 새로 지정해 주세요. PCD_PAY_OID 가 중복되면 처음 처리완료된 거래보다 나중에 들어온 거래요청건은 중복시도로 판단되어 거절됩니다.

→ 이러한 이유로, 파트너사에서 유니크하게 주문번호를 지정할 수 없을 경우에는 주문번호는 미지정하는 것을 권장하고 있습니다.

※ 파트너가 주문번호를 미지정 시, 페이플에서는 임의의 주문번호를 생성하여 리턴하여 드립니다.

결제없이 비밀번호 등록만을 수행할 때는 PCD_PAY_WORK 를 AUTH로 설정합니다. 결제와 동시에 비밀번호 등록을 수행할 때는 PCD_PAY_WORK 를 PAY로 설정합니다.

Request Message

Show All

결제수단

Parameter

더 알아보기

Parameter value

Type (Length)

필수

Reference

카드

계좌