로고Developer Center
홈페이지가입문의

파라미터

국내 카드정기(빌링) 결제


1. 결제창 호출

아래는 결제창 호출 시 사용 가능한 Request 파라미터 목록입니다.

파라미터필수타입길이설명값 예시
clientKeyString128파트너 인증을 위한 클라이언트키입니다.
라이브 클라이언트키는 계약 완료 후 발급가능합니다.
test_DF55F29DA654A8CBC0F0A9DD4B556486
PCD_PAY_TYPEString20결제수단(카드/계좌)을 선택합니다.
  • 카드 : card / 계좌: transfer
card
PCD_PAY_WORKString20승인 요청 방식이며 카드 등록만 필요하다면 AUTH, 등록과 동시에 결제가 필요하다면
CERT 로 설정합니다.
AUTH
PCD_CARD_VERString2카드 결제수단 중 앱카드, 정기(빌링), 비밀번호 간편결제 방식을 선택합니다.
  • 정기(빌링) / 비밀번호 간편결제 : 01
  • 앱카드 : 02
01
PCD_PAY_GOODSString255상품명입니다.테스트 상품
PCD_PAY_TOTALNumber10총 결제금액입니다.1000
PCD_RST_URLString-결제 정보가 성공적으로 입력된 경우, 인증 결과가 POST 방식으로 전송됩니다.
경로지정 방식에 따라 결제창이 다르게 띄워집니다.
https://result-domain.com
PCD_PAY_OIDString255주문번호입니다. 파트너(상점)에서 생성한 거래에 대한 고유식별번호입니다. 중복되지 않는 고유한 값을 발급해야하며, 미전송 시 페이플에서 발급한 주문번호를 응답합니다.order12345
PCD_PAYER_NONumber18파트너(상점)에서 이용하는 회원번호입니다.1234
PCD_PAYER_NAMEString80구매자 이름입니다.김이플
PCD_PAYER_HPString20구매자 휴대폰번호입니다. 구매자에게 결제된 상점정보를 알림톡으로 발송합니다.01012345678
PCD_PAYER_EMAILString100구매자 이메일입니다. 결제완료, 취소 메일이 발송됩니다.complete@payer-email.com
PCD_PAY_ISTAXString1과세 여부입니다. 기본값은 Y 이며, 유형별로 아래와 같이 설정해주세요.
  • 과세, 복합과세 : Y
  • 비과세 : N
Y
PCD_PAY_TAXTOTALNumber9복합과세 주문 시에만 이용하며, 복합과세 주문의 부가세를 설정합니다.
  • 예 : 총 결제금액(PCD_PAY_TOTAL) 10,000원 중 복합과세 주문의 부가세가 500원이면 500으로 설정
500
callbackFunction--클라이언트단에서 결과수신이 필요할 경우 사용합니다. callbackFunction을 사용해도 PCD_RST_URL은 필수로 입력되어야 합니다.getResult
PCD_USER_DEFINE1String2048파트너(상점)에서 입력한 값을 그대로 응답합니다. 단, 특수문자는 공백처리 합니다.define1
PCD_USER_DEFINE2String2048파트너(상점)에서 입력한 값을 그대로 응답합니다. 단, 특수문자는 공백처리 합니다.define2

2. 인증결과 수신

인증이 성공적으로 완료된 경우, 수신되는 Response 파라미터는 다음과 같습니다.

파라미터타입설명값 예시
PCD_PAY_RSTString인증 결과입니다.
  • success : 성공 / error : 실패 / close : 구매자가 결제 완료 전 결제창 종료
success
PCD_PAY_CODEString응답 코드입니다.0000
PCD_PAY_MSGString응답 메시지입니다.카드등록이 완료되었습니다.
PCD_PAY_WORKString승인 요청 방식 결과입니다.AUTH
PCD_AUTH_KEYString내부 인증토큰입니다.K0VnW…
PCD_PAY_TYPEString결제수단(카드/계좌)을 선택합니다.
  • 카드 : card / 계좌: transfer
card
PCD_PAYER_NOString파트너(상점)에서 이용하는 회원번호입니다.1234
PCD_PAYER_IDString정기(빌링), 비밀번호 간편결제 시 필요한 빌링키입니다.
  • 앱카드 결제(PCD_CARD_VER = ‘02’)인 경우, 빌링키는 반환되지 않으며 빈값으로 응답합니다.
OVA3…
PCD_PAYER_NAMEString구매자 이름입니다.김이플
PCD_PAYER_EMAILString구매자 이메일입니다. complete@payer-email.com
PCD_PAYER_HPString구매자 휴대폰번호입니다.01012345678
PCD_PAY_CARDNAMEString카드사명입니다.삼성카드
PCD_PAY_CARDNUMString카드번호입니다.1234-****-****-5678
PCD_RST_URLString결제 정보가 성공적으로 입력된 경우, 인증 결과가 POST 방식으로 전송됩니다.https://result-domain.com
PCD_USER_DEFINE1String파트너(상점)에서 입력한 값을 그대로 응답합니다. 단, 특수문자는 공백처리 합니다.define1
PCD_USER_DEFINE2String파트너(상점)에서 입력한 값을 그대로 응답합니다. 단, 특수문자는 공백처리 합니다.define2

3. 파트너 인증 요청

빌링키 승인 요청 시 요구되는 파트너 인증에 필요한 Request 파라미터는 아래와 같습니다.

파라미터필수타입길이설명값 예시
cst_idString12파트너 인증을 위한 ID 입니다. 라이브 ID 는 계약이 완료되어야 발급 가능합니다. test
custKeyString255파트너 인증을 위한 키입니다. 라이브 키는 계약이 완료되어야 발급 가능합니다.
  • 외부에 노출되면 안되는 정보입니다. 보안에 유의해주세요.
abcd1234567890
PCD_PAY_TYPEString20결제수단(카드/계좌)입니다.
  • 카드 : card / 계좌 : transfer
card
PCD_SIMPLE_FLAGString1정기(빌링), 비밀번호 간편결제 시 필요한 설정값입니다.Y

파트너 인증이 성공적으로 완료된 후에 받게 되는 Response 파라미터는 다음과 같습니다.

파라미터타입설명값 예시
server_nameString파트너 인증 서버의 Domain을 반환합니다.democpay.payple.kr
resultString인증 결과입니다.success
result_msgString결과 메시지입니다.사용자 인증 완료!!
cst_idString파트너 ID 입니다.
  • 매 인증 시 변동되는 값입니다.
UFVNNVZ…
custKeyString파트너 인증 키입니다.
  • 매 인증 시 변동되는 값입니다.
T3JzRkp5L…
AuthKeyString파트너 인증 키입니다.
  • 매 인증 시 변동되는 값입니다.
a688ccb3555...
PCD_PAY_HOSTString페이플 접속 주소입니다.https://democpay.payple.kr
PCD_PAY_URLString파트너 인증 결과로 응답되는 URL Path 입니다./php/SimplePayAct.php?ACT_=PAYM
return_urlString파트너 인증 결과로 응답되는 URL 입니다.https://democpay.payple.kr/php/SimplePayAct.php?ACT_=PAYM

4. 빌링키로 승인 요청

실결제 승인 과정에서 필요한 Request 파라미터는 다음과 같습니다.

파라미터필수타입길이설명값 예시
PCD_CST_IDString255파트너 인증을 위한 ID 입니다.UFVNNVZ…
PCD_CUST_KEYString255파트너 인증 후 수신한 키입니다.T3JzRkp5L…
PCD_AUTH_KEYString255인증완료 후 수신하는 파트너 인증 키입니다.K0VnW…
PCD_PAY_TYPEString20카드 결제수단 중 앱카드, 정기(빌링), 비밀번호 간편결제 방식을 선택합니다.
  • 카드: card / 계좌: transfer
card
PCD_PAYER_IDString255정기(빌링), 비밀번호 간편결제 시 필요한 빌링키입니다.
  • 앱카드 결제(PCD_CARD_VER = ‘02’)인 경우, 빌링키는 반환되지 않습니다.
OVA3…
PCD_PAY_GOODSString255상품명입니다.테스트 상품
PCD_SIMPLE_FLAGString1정기(빌링), 비밀번호 간편결제 시 필요한 설정값입니다.Y
PCD_PAY_TOTALNumber10총 결제금액입니다.1000
PCD_PAY_OIDString255주문번호입니다. 파트너(상점)에서 생성한 거래에 대한 고유식별번호입니다. 중복되지 않 는 고유한 값을 발급해야하며, 미전송 시 페이플에서 발급한 주문번호를 응답합니다.order12345
PCD_PAYER_NONumber18파트너(상점)에서 이용하는 회원번호입니다.1234
PCD_PAYER_NAMEString80구매자 이름입니다.김이플
PCD_PAYER_HPString20구매자 휴대폰번호입니다. 구매자에게 결제된 상점정보를 알림톡으로 발송합니다.01012345678
PCD_PAYER_EMAILString100구매자 이메일입니다. 결제완료, 취소 메일이 발송됩니다.complete@payer-email.com
PCD_PAY_ISTAXString1과세 여부입니다. 기본값은 Y 이며, 유형별로 아래와 같이 설정해주세요.
  • 과세, 복합과세 : Y
  • 비과세: N
Y
PCD_PAY_TAXTOTALNumber9복합과세 주문 시에만 이용하며, 복합과세 주문의 부가세를 설정합니다.
  • 예: 총 결제금액(PCD_PAY_TOTAL) 10,000원 중 복합과세 주문의 부가세가 500원이면 500으로 설정
500
PCD_USER_DEFINE1String2048파트너(상점)에서 입력한 값을 그대로 응답합니다. 단, 특수문자는 공백처리 합니다.define1
PCD_USER_DEFINE2String2048파트너(상점)에서 입력한 값을 그대로 응답합니다. 단, 특수문자는 공백처리 합니다.define2

빌링키 승인이 성공적으로 완료된 후에 받게 되는 Response 파라미터는 다음과 같습니다.

파라미터타입설명값 예시
PCD_PAY_RSTString승인 결과입니다.
  • success : 성공 / error : 실패
success
PCD_PAY_CODEString응답 코드입니다.SPCD0000
PCD_PAY_MSGString응답 메시지입니다.사용자 인증 완료!!
PCD_PAY_OIDString주문번호입니다. 파트너(상점)에서 미전송 시 페이플에서 발급한 주문번호를 응답합니다.order12345
PCD_PAY_TYPEString결제수단(카드/계좌)입니다.card
PCD_PAYER_IDString정기(빌링), 비밀번호 간편결제 시 필요한 빌링키입니다.
  • 앱카드 결제(PCD_CARD_VER = ‘02’)인 경우, 빌링키는 반환되지 않습니다.
ova3...
PCD_PAYER_NOString파트너(상점)에서 이용하는 회원번호입니다.1234
PCD_PAYER_NAMEString구매자 이름입니다.김이플
PCD_PAYER_HPString구매자 휴대폰번호입니다.01012345678
PCD_PAYER_EMAILString구매자 이메일입니다.complete@payer-email.com
PCD_PAY_GOODSString상품명입니다.테스트 상품
PCD_PAY_TOTALString총 결제금액입니다.1000
PCD_PAY_TAXTOTALString복합과세 부가세입니다.500
PCD_PAY_ISTAXString과세 여부입니다.Y
PCD_PAY_TIMEString결제를 요청한 시간입니다.20231219134223
PCD_PAY_CARDNAMEString카드사명입니다.삼성카드
PCD_PAY_CARDNUMString카드번호입니다.1234-****-****-5678
PCD_PAY_CARDTRADENUMString해당 거래의 고유한 키입니다.202312191342223302115099
PCD_PAY_CARDAUTHNOString승인번호입니다.85324231
PCD_PAY_CARDRECEIPTString매출 전표(영수증) 출력 URL 입니다.https://www.danalpay.com/...
PCD_SIMPLE_FLAGString정기(빌링), 비밀번호 간편결제 시 필요한 설정값입니다.Y
PCD_USER_DEFINE1String파트너(상점)에서 입력한 값을 그대로 응답합니다. 단, 특수문자는 공백처리 합니다.define1
PCD_USER_DEFINE2String파트너(상점)에서 입력한 값을 그대로 응답합니다. 단, 특수문자는 공백처리 합니다.define2