💳

🆕 앱카드 결제 (카드)

•

이 글의 목차

Payple Payment Script

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

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

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

Request Parameters

Response Parameters

4. 마무리

1. 앱카드 결제란?

•

카드사에서 제공하는 앱카드로 결제하는 방식입니다. 

•

아래 링크를 클릭해서 앱카드 결제방식을 직접 체험해보세요.

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

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

앱카드 결제창 미리보기

최초 호출창

약관 동의 및 카드 선택 후

2. 프로세스 개요

앱카드 결제의 결제 프로세스는 다음과 같이 진행됩니다.

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

3. 결제

3-1. 구매버튼 클릭

고객 결제페이지(Web)

•

고객이 파트너의 쇼핑몰에서 1,000원짜리 '티셔츠' 구매를 결정했습니다.

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 가 중복되면 처음 처리완료된 거래보다 나중에 들어온 거래요청건은 중복시도로 판단되어 거절됩니다.

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

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

Request Parameters

Show All

결제수단

Parameter

더 알아보기

Parameter value

Type (Length)

필수

Reference

카드