♻️

🆕 정기결제 (카드 / 계좌)

1. 정기결제란?

•

최초 1회 카드/계좌 정보 등록만 받고, 파트너사의 다양한 결제주기에 맞춰 자동으로 결제를 받을 수 있습니다.

페이플에서 제공하는 정기결제는 등록시 결제 스케줄링(예약)을 걸어 자동으로 결제가 발생하는 방식이 아닌 결제가 필요할 때마다 파트너가 발급된 빌링키(PCD_PAYER_ID )로 실시간으로 REST 결제요청을 진행하여 결제가 나는 방식입니다. 고객 입장에서는 한번의 결제수단 등록 후에 별도의 인증 작업없이 결제가 일어나는 것으로 인식하게 됩니다.

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

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

정기결제를 위한 결제수단 등록창 미리보기

카드 등록

개인계좌 등록

법인계좌 등록

2. 프로세스 개요

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

정기결제는 페이플 결제창에서 결제정보를 입력하여 등록하는 1단계와 등록된 빌링키(PCD_PAYER_ID)로 REST 재결제를 하는 2단계로 구분됩니다.

2-1. 등록 단계 프로세스

2-2. REST 재결제 프로세스

발급받은 빌링키로 결제 요청하는 재결제 요청은 REST 방식이며, 클라이언트 키(clientKey)가 아닌 기존 파트너 인증 방식으로 인증해야 합니다.

자세한 연동방법은 이 문서의 4. 재결제 목차에서 확인해주세요!

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_WORK 를 AUTH로 설정합니다. 결제와 동시에 등록을 수행할 때는 PCD_PAY_WORK 를 PAY로 설정합니다.

Request Parameters

Show All

결제수단

Parameter

더 알아보기

Parameter value

Type (Length)

필수

Reference

카드

계좌

🆕 정기결제 (카드 / 계좌)

1. 정기결제란?

정기결제를 위한 결제수단 등록창 미리보기

2. 프로세스 개요

2-1. 등록 단계 프로세스

2-2. REST 재결제 프로세스

3. 첫등록 & 첫결제

3-1. 서비스 신청버튼 클릭

3-2. 등록 요청

Payple Payment Script

Request Parameters

3-3. 등록 진행

3-4. 결제 결과

Response Parameters

3-5. 결과 처리

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

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

4. 재결제

4-1. 재결제 프로세스

4-2 파트너 인증

Request Parameters

Response Parameters

4-3. 결제 요청

Request Parameters

Response Parameters

4-4. 결과 처리

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

4-4-2. 요청이 실패했을 경우(error)

5. 마무리