로고Developer Center

파라미터

국내 계좌운영


1. 취소

1 .1 파트너 인증 요청

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

파라미터필수타입길이설명값 예시
cst_idString12파트너 인증을 위한 ID 입니다. 라이브 ID 는 계약이 완료되어야 발급 가능합니다.test
custKeyString255파트너 인증을 위한 키입니다. 라이브 키는 계약이 완료되어야 발급 가능합니다.
  • 외부에 노출되면 안되는 정보입니다. 보안에 유의해주세요.
abcd1234567890
PCD_PAYCANCEL_FLAGString1취소 요청을 위한 파라미터입니다.Y

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

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

1.2 취소 요청

파트너 인증 후 취소 요청 시 필요한 Request 파라미터는 아래와 같습니다.

파라미터필수타입길이설명값 예시
PCD_CST_IDString255파트너 인증 후 수신한 ID입니다.UFVNNVZ…
PCD_CUST_KEYString255파트너 인증 후 수신한 키입니다.T3JzRkp5L…
PCD_AUTH_KEYString255파트너 인증 후 수신한 인증 키입니다.a688ccb3555…
PCD_REFUND_KEYString255계약이 완료되면 발급되는 취소를 위한 고유 키입니다.
  • 파트너관리자에서 확인 가능
a41c…
PCD_PAYCANCEL_FLAGString1취소 요청을 위한 파라미터입니다.Y
PCD_PAY_OIDString255원거래 주문번호입니다.order12345
PCD_PAY_DATEString8원거래 결제일자입니다.20231219
PCD_REFUND_TOTALNumber10취소 금액입니다.
  • 원거래 금액보다 적으면 부분취소로 진행
1000
PCD_REFUND_TAXTOTALNumber9복합과세 원거래의 취소 시에만 이용하며, 복합과세 주문의 취소할 부가세를 설정합니다.50

취소 요청이 성공적으로 완료된 후에 받게 되는 Response 파라미터는 다음과 같습니다.

파라미터타입설명값 예시
PCD_PAY_RSTString요청 결과입니다.
  • success : 성공 / error : 실패
success
PCD_PAY_CODEString응답 코드입니다.PAYC0000
PCD_PAY_MSGString응답 메시지입니다.환불 성공
PCD_PAY_OIDString주문번호입니다.order12345
PCD_PAY_TYPEString결제수단(카드/계좌)입니다.
  • 카드 : card / 계좌: transfer
transfer
PCD_PAYER_NOString파트너(상점)에서 이용하는 회원번호입니다.1234
PCD_PAYER_IDString정기(빌링), 비밀번호 간편결제 시 필요한 빌링키입니다.
  • 앱카드 결제(PCD_CARD_VER = ‘02’)인 경우, 빌링키는 반환되지 않습니다.
OVA3...
PCD_PAY_YEARString월 중복방지 거래 - 년(Year)2023
PCD_PAY_MONTHString월 중복방지 거래 - 월(Month)12
PCD_PAY_GOODSString상품명입니다.테스트 상품
PCD_REGULER_FLAGString월 중복방지 거래 설정 여부입니다.N
PCD_REFUND_TOTALString취소 금액입니다.1000
PCD_REFUND_TAXTOTALString복합과세 주문의 취소 부가세입니다.50
PCD_PAY_TIMEString취소를 요청한 시간입니다.20231219134223
PCD_TAXSAVE_RSTString현금영수증 취소 결과입니다.0000
PCD_TAXSAVE_MSGString현금영수증 취소 결과 메시지입니다.현금영수증 발행취소 성공

2. 결과조회 요청

2.1 파트너 인증 요청

결과조회 요청 시 요구되는 파트너 인증에 필요한 Request 파라미터는 아래와 같습니다.
한 번의 파트너 인증 후 30분의 유효 시간 동안 조회 요청을 해야 하며, 10분당 1,000건을 초과하는 요청은 거부됩니다.

파라미터필수타입길이설명값 예시
cst_idString12파트너 인증을 위한 ID 입니다. 라이브 ID 는 계약이 완료되어야 발급 가능합니다.test
custKeyString255파트너 인증을 위한 키입니다. 라이브 키는 계약이 완료되어야 발급 가능합니다.
  • 외부에 노출되면 안되는 정보입니다. 보안에 유의해주세요.
abcd1234567890
PCD_PAYCHK_FLAGString1결과조회 요청을 위한 파라미터입니다.Y

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

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

2.2 결과조회 요청

파트너 인증 후 결과조회 요청 시 필요한 Request 파라미터는 아래와 같습니다.

파라미터필수타입길이설명값 예시
PCD_CST_IDString255파트너 인증 후 수신한 ID입니다.UFVNNVZ…
PCD_CUST_KEYString255파트너 인증 후 수신한 키입니다.T3JzRkp5L…
PCD_AUTH_KEYString255파트너 인증 후 수신한 인증 키입니다.a688ccb3555…
PCD_PAYCANCEL_FLAGString1결과조회 요청을 위한 파라미터입니다.Y
PCD_PAY_TYPEString10결제수단입니다.
  • card : 카드결제 / transfer : 계좌결제
transfer
PCD_PAY_OIDString255원거래 주문번호입니다.order12345
PCD_PAY_DATEString8원거래 결제일자입니다.20231219

결과조회 요청이 성공적으로 완료된 후에 받게 되는 Response 파라미터는 다음과 같습니다.

파라미터타입설명값 예시
PCD_PAY_RSTString요청 결과입니다.
  • success : 성공 / error : 실패
success
PCD_PAY_CODEString응답 코드입니다.PCHK000
PCD_PAY_MSGString응답 메시지입니다.결제 완료
PCD_PAY_OIDString주문번호입니다. 파트너(상점)에서 미전송 시 페이플에서 발급한 주문번호를 응답합니다.order12345
PCD_PAY_TYPEString결제수단(카드/계좌)입니다.
  • success : 성공 / error : 실패
transfer
PCD_PAYER_NOString파트너(상점)에서 이용하는 회원번호입니다.1234
PCD_PAYER_IDString정기(빌링), 비밀번호 간편결제 시 필요한 빌링키입니다.
  • 앱카드 결제(PCD_CARD_VER = ‘02’)인 경우, 빌링키는 반환되지 않습니다.
OVA3
PCD_PAYER_EMAILString구매자 이메일입니다.complete@payer-email.com
PCD_REGULER_FLAGString월 중복방지 거래 설정 여부입니다.N
PCD_PAY_YEARString월 중복방지 거래 - 년(Year)2023
PCD_PAY_MONTHString월 중복방지 거래 - 월(Month)12
PCD_PAY_GOODSString상품명입니다.테스트 상품
PCD_PAY_AMOUNTString(현재는 이용하지 않는) 총 결제금액입니다.
PCD_PAY_DISCOUNTString(현재는 이용하지 않는) 할인금액입니다.
PCD_PAY_AMOUNT_REALString(현재는 이용하지 않는) 총 결제금액 - 할인금액입니다.
PCD_PAY_TOTALString총 결제금액입니다.1000
PCD_PAY_ISTAXString과세 여부입니다.Y
PCD_PAY_TAXTOTALString복합과세 부가세입니다.500
PCD_PAY_BANKString은행 코드입니다.020
PCD_PAY_BANKNAMEString은행명입니다.우리은행
PCD_PAY_BANKNUMString계좌번호입니다.123-********-456
PCD_PAY_TIMEString결제를 요청한 시간입니다.20231219134223
PCD_TAXSAVE_FLAGString현금영수증 발행 여부입니다.
  • 발행 : Y / 미발행 : N
Y
PCD_TAXSAVE_RSTString현금영수증 발행 결과입니다.
  • 성공 : Y / 실패 : N
Y
PCD_TAXSAVE_MGTNUMString현금영수증 국세청 발행번호입니다.G123456

3. 빌링키 조회

3.1 파트너 인증 요청

빌링키 조회 요청 시 요구되는 파트너 인증에 필요한 Request 파라미터는 아래와 같습니다.
한 번의 파트너 인증으로 30분 동안 조회 요청이 가능합니다. 매 조회마다 새로운 인증이 필요하지 않습니다.

파라미터필수타입길이설명값 예시
cst_idString12파트너 인증을 위한 ID 입니다. 라이브 ID 는 계약이 완료되어야 발급 가능합니다.demo
custKeyString255파트너 인증을 위한 키입니다. 라이브 키는 계약이 완료되어야 발급 가능합니다.
  • 외부에 노출되면 안되는 정보입니다. 보안에 유의해주세요.
abcd1234567890
PCD_PAY_WORKString20빌링키 조회 요청을 위한 파라미터입니다.PUSERINFO

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

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

3.2 빌링키 조회 요청

파트너 인증 후 빌링키 조회 요청 시 필요한 Request 파라미터는 아래와 같습니다.

파라미터필수타입길이설명값 예시
PCD_CST_IDString255파트너 인증 후 수신한 ID입니다.UFVNNVZ…
PCD_CUST_KEYString255파트너 인증 후 수신한 키입니다.T3JzRkp5L…
PCD_AUTH_KEYString255파트너 인증 후 수신한 인증 키입니다.a688ccb3555…
PCD_PAYER_IDString255빌링키입니다.OVA3…

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

파라미터타입설명값 예시
PCD_PAY_RSTString요청 결과입니다.
  • success : 성공 / error : 실패
success
PCD_PAY_CODEString응답 코드입니다.0000
PCD_PAY_MSGString응답 메시지입니다.회원조회 성공
PCD_PAY_TYPEString결제수단(카드/계좌)입니다.transfer
PCD_PAY_BANKACCTYPEString구매자의 개인, 사업자 여부입니다.
  • 개인 / 사업자
개인
PCD_PAYER_IDString빌링키입니다.OVA3…
PCD_PAYER_NAMEString구매자 이름입니다.김이플
PCD_PAYER_HPString구매자 휴대폰번호입니다.010-****-5678
PCD_PAY_BANKString은행 코드입니다.020
PCD_PAY_BANKNAMEString은행명입니다.우리은행
PCD_PAY_BANKNUMString계좌번호입니다.123-********-456

4. 빌링키 해지

4.1 파트너 인증 요청

빌링키 해지 요청 시 요구되는 파트너 인증에 필요한 Request 파라미터는 아래와 같습니다.
한 번의 파트너 인증으로 30분 동안 조회 요청이 가능합니다. 매 조회마다 새로운 인증이 필요하지 않습니다.

파라미터필수타입길이설명값 예시
cst_idString255파트너 인증을 위한 ID 입니다. 라이브 ID 는 계약이 완료되어야 발급 가능합니다.test
custKeyString255파트너 인증을 위한 키입니다. 라이브 키는 계약이 완료되어야 발급 가능합니다.
  • 외부에 노출되면 안되는 정보입니다. 보안에 유의해주세요.
abcd1234567890
PCD_PAY_WORKString20빌링키 해지 요청을 위한 파라미터입니다.PUSERDEL

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

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

4.2 빌링키 해지 요청

파트너 인증 후 해지 요청 시 필요한 Request 파라미터는 아래와 같습니다.

파라미터필수타입길이설명값 예시
PCD_CST_IDString255파트너 인증 후 수신한 ID입니다.UFVNNVZ…
PCD_CUST_KEYString255파트너 인증 후 수신한 키입니다.T3JzRkp5L…
PCD_AUTH_KEYString255파트너 인증 후 수신한 인증 키입니다.a688ccb3555…
PCD_PAYER_IDString255빌링키입니다.OVA3…

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

파라미터타입설명값 예시
PCD_PAY_RSTString요청 결과입니다.
  • success : 성공 / error : 실패
success
PCD_PAY_CODEString응답 코드입니다.PUER0000
PCD_PAY_MSGString응답 메시지입니다.계좌해지 완료
PCD_PAY_TYPEString결제수단(카드/계좌)입니다.transfer
PCD_PAY_WORKString빌링키 해지 요청을 위한 파라미터입니다.PUSERDEL
PCD_PAYER_IDString빌링키입니다.OVA3…
PCD_PAYER_NOString파트너(상점)에서 이용하는 회원번호입니다.1234

5. 현금영수증 발행

5.1 파트너 인증 요청

현금영수증 발행 요청 시 요구되는 파트너 인증에 필요한 Request 파라미터는 아래와 같습니다.
한 번의 파트너 인증으로 30분 동안 조회 요청이 가능합니다. 매 조회마다 새로운 인증이 필요하지 않습니다.

파라미터필수타입길이설명값 예시
cst_idString12파트너 인증을 위한 ID 입니다. 라이브 ID 는 계약이 완료되어야 발급 가능합니다.test
custKeyString255파트너 인증을 위한 키입니다. 라이브 키는 계약이 완료되어야 발급 가능합니다.
  • 외부에 노출되면 안되는 정보입니다. 보안에 유의해주세요.
abcd1234567890
PCD_PAY_WORKString20현금영수증 발행 요청을 위한 파라미터입니다.TSREG

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

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

5.2 현금영수증 발행 요청

파트너 인증 후 현금영수증 발행 요청 시 필요한 Request 파라미터는 아래와 같습니다.

파라미터필수타입길이설명값 예시
PCD_CST_IDString255파트너 인증 후 수신한 ID입니다.UFVNNVZ…
PCD_CUST_KEYString255파트너 인증 후 수신한 키입니다.T3JzRkp5L…
PCD_AUTH_KEYString255파트너 인증 후 수신한 인증 키입니다.a688ccb3555…
PCD_PAYER_IDString255빌링키입니다.OVA3…
PCD_PAY_OIDString255원거래 주문번호입니다.order12345
PCD_TAXSAVE_AMOUNTNumber10현금영수증 발행 금액입니다.1000
PCD_TAXSAVE_TRADEUSEString10현금영수증 발행 구분입니다.
  • personal : 개인 소득공제
  • coompany : 사업자 지출증빙
  • 미입력 시 구매자가 결제창에서 선택한 구분값으로 진행
personal
PCD_TAXSAVE_IDENTINUMString20현금영수증 발행 대상번호입니다.
  • 휴대폰번호 또는 사업자번호
01012345678
PCD_REGULER_FLAGString1월 중복 결제 방지 기능이 적용된 원거래에만 사용됩니다.Y

현금영수증 발행 요청이 성공적으로 완료된 후에 받게 되는 Response 파라미터는 다음과 같습니다.

파라미터타입설명값 예시
PCD_PAY_RSTString요청 결과입니다.
  • success : 성공 / error : 실패
success
PCD_PAY_CODEString응답 코드입니다.TSRG0000
PCD_PAY_MSGString응답 메시지입니다.현금영수증 발행완료
PCD_PAY_WORKString현금영수증 발행 요청을 위한 파라미터입니다.TSREG
PCD_PAYER_IDString빌링키입니다.OVA3…
PCD_PAY_OIDString원거래 주문번호입니다.order12345
PCD_REGULER_FLAGString월 중복방지 거래 설정 여부입니다.N
PCD_TAXSAVE_AMOUNTString현금영수증 발행 금액입니다.1000
PCD_TAXSAVE_MGTNUMString현금영수증 국세청 발행번호입니다.G12345678

6. 현금영수증 취소

6.1 파트너 인증 요청

현금영수증 취소 요청 시 요구되는 파트너 인증에 필요한 Request 파라미터는 아래와 같습니다.
한 번의 파트너 인증으로 30분 동안 조회 요청이 가능합니다. 매 조회마다 새로운 인증이 필요하지 않습니다.

파라미터필수타입길이설명값 예시
cst_idString12파트너 인증을 위한 ID 입니다. 라이브 ID 는 계약이 완료되어야 발급 가능합니다.test
custKeyString255파트너 인증을 위한 키입니다. 라이브 키는 계약이 완료되어야 발급 가능합니다.
  • 외부에 노출되면 안되는 정보입니다. 보안에 유의해주세요.
abcd1234567890
PCD_PAY_WORKString20현금영수증 취소 요청을 위한 파라미터입니다.TSCANCEL

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

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

6.2 현금영수증 취소 요청

파트너 인증 후 현금영수증 취소 요청 시 필요한 Request 파라미터는 아래와 같습니다.

파라미터필수타입길이설명값 예시
PCD_CST_IDString255파트너 인증 후 수신한 ID입니다.UFVNNVZ…
PCD_CUST_KEYString255파트너 인증 후 수신한 키입니다.T3JzRkp5L…
PCD_AUTH_KEYString255파트너 인증 후 수신한 인증 키입니다.a688ccb3555…
PCD_PAYER_IDString255빌링키입니다OVA3…
PCD_PAY_OIDString255원거래 주문번호입니다.order12345

현금영수증 취소 요청이 성공적으로 완료된 후에 받게 되는 Response 파라미터는 다음과 같습니다.

파라미터타입설명값 예시
PCD_PAY_RSTString요청 결과입니다.
  • success : 성공 / error : 실패
success
PCD_PAY_CODEString응답 코드입니다.TSDL0000
PCD_PAY_MSGString응답 메시지입니다.현금영수증 취소 성공
PCD_PAY_WORKString현금영수증 발행 요청을 위한 파라미터입니다.TSCANCEL
PCD_PAYER_IDString빌링키입니다.OVA3…
PCD_PAY_OIDString원거래 주문번호입니다.order12345
PCD_REGULER_FLAGString월 중복방지 거래 설정 여부입니다.N
PCD_TAXSAVE_AMOUNTString원거래 현금영수증 발행 금액이며, 취소 요청 금액입니다.1000
PCD_TAXSAVE_MGTNUMString원거래 현금영수증 국세청 발행번호입니다.[취소번호] G12345678-1