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

파라미터

링크결제


1. 파트너 인증 요청

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

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

파트너 인증이 성공적으로 완료된 후에 받게 되는 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/link/api/LinkRegAct.php?ACT_=LINKREG
return_urlString파트너 인증 결과로 응답되는 URL 입니다.https://democpay.payple.kr/php/link/api/LinkRegAct.php?ACT_=LINKREG

2. 링크 생성 요청

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

파라미터결제수단필수타입길이설명값 예시
PCD_CST_ID전체String255파트너 인증 후 수신한 ID입니다.UFVNNVZ…
PCD_CUST_KEY전체String255파트너 인증 후 수신한 키입니다.T3JzRkp5L…
PCD_AUTH_KEY전체String255파트너 인증 후 수신한 인증 키입니다.a688ccb3555…
PCD_PAY_WORK전체String255결제링크 생성을 요청합니다.LINKREG
PCD_PAY_TYPE전체String255결제수단을 선택합니다.
  • 기본값(카드+계좌) : transfer+card
  • 카드: card- 계좌: transfer
transfer+card
PCD_PAY_GOODS전체String255상품명입니다.테스트 상품
PCD_PAY_TOTAL전체Number255총 결제금액입니다.1000
PCD_PAY_GOODS_EXPLAIN전체String255상품 설명입니다.해당 상품은 테스트를 위한 상품으로 실결제가 진행되지 않는 상품입니다
PCD_PAY_ISTAX전체String1과세 여부입니다. 기본값은 Y 이며, 유형별로 아래와 같이 설정해주세요.
  • 과세, 복합과세 : Y
  • 비과세 : N
Y
PCD_PAY_TAXTOTAL전체Number9복합과세 주문 시에만 이용하며, 복합과세 주문의 부가세를 설정합니다.
  • 예: 총 결제금액(PCD_PAY_TOTAL) 10,000원 중 복합과세 주문의
    부가세가 500원이면 500으로 설정
500
PCD_LINK_EXPIREDATE전체String10결제 만료일시를 설정합니다. 미지정 시 무기한으로 만료일시가 설정됩니다.2025010122
PCD_LINK_PARAMETER전체String255사용자 정의 파라미터입니다.params1=val1&params2=val2
PCD_LINK_NOTI_MSG전체String255결제완료 화면에서 표시될 내용을 입력합니다. 결제 완료 후 구매자에게
전달하고자 하는 안내 문구가 있으면 이를 사용할 수 있습니다.
PCD_LINK_MEMO전체String1024상점 관리자에서 표시될 메모입니다.테스트 링크결제
PCD_LINK_URL전체String255결제 완료 화면에서 구매자가 '이동하기' 버튼을 클릭하면 이동할 URL을
지정할 수 있습니다.
www.your-domain.com
PCD_GOODS_AMOUNT전체Number3결제 마감 수량을 지정합니다.
  • 1 ~ 999까지 가능
15
PCD_CARD_VER카드String2카드 결제방식을 선택합니다.
  • 기본값(앱카드+빌링): 01+02
  • 01 : 빌링 - 정기결제가 아닌 일회성 키인 결제
  • 02 : 앱카드
  • PCD_PAY_TYPE 이 ‘card’ 인 경우에만 해당
01+02
PCD_TAXSAVE_FLAG계좌String1현금영수증 발행창 호출 여부입니다.
  • 호출 : Y
  • 미호출: 미입력
Y

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

파라미터타입설명값 예시
PCD_LINK_RSTString생성 결과입니다.
  • success, error가 반환됩니다.
success
PCD_LINK_MSGString응답 메시지입니다.링크생성이 완료되었습니다.
PCD_PAY_TYPEString결제수단입니다.transfer+card
PCD_PAY_GOODSString상품명입니다.테스트 상품
PCD_PAY_GOODS_EXPLAINString상품 설명입니다.해당 상품은 테스트를 위한 상품으로 실결제가 진행되지 않는 상품입니다.
PCD_PAY_TOTALString총 결제금액입니다.1000
PCD_PAY_ISTAXString과세 여부입니다.Y
PCD_PAY_TAXTOTALString복합과세 부가세입니다.500
PCD_REGULER_FLAGString월 중복방지 거래 설정 여부입니다.N
PCD_PAY_YEARString월 중복방지 거래 - 년(Year)2023
PCD_PAY_MONTHString월 중복방지 거래 - 월(Month)12
PCD_TAXSAVE_FLAGString현금영수증 발행 여부입니다.Y
PCD_LINK_EXPIREDATEString결제 만료일시입니다.2025-01-01 22:00:00
PCD_LINK_ADD_PARAMString사용자 정의 파라미터입니다.params1=val1&params2=val2
PCD_LINK_KEYString생성된 링크의 고유 키입니다.MTI6MTU4NDYwNzI4Mg
PCD_LINK_URLString생성된 링크의 전체 주소입니다.https://democpay.payple.kr/php/link/?SID=MTI6MTU4NDYwNzI4Mg

3. 링크 만료처리 요청

3.1 파트너 인증 요청

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

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

파트너 인증이 성공적으로 완료된 후에 받게 되는 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/link/api/LinkRegAct.php?ACT_=LINKEXPIRE
return_urlString파트너 인증 결과로 응답되는 URL 입니다.https://democpay.payple.kr/php/link/api/LinkRegAct.php?ACT_=LINKEXPIRE

3.2 링크 만료처리 요청

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

파라미터필수타입길이설명값 예시
PCD_CST_IDString255파트너 인증 후 수신한 ID입니다.UFVNNVZ…
PCD_CUST_KEYString255파트너 인증 후 수신한 키입니다.T3JzRkp5L…
PCD_AUTH_KEYString255파트너 인증 후 수신한 인증 키입니다.a688ccb3555…
PCD_LINK_KEYString12생성된 링크의 고유 키입니다.MTI6MTU4NDYwNzI4Mg

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

파라미터타입설명값 예시
PCD_PAY_RSTString인증 결과입니다.
  • success : 성공
  • error: 실패
success
PCD_PAY_MSGString응답 메시지입니다.링크결제 만료 처리가 완료되었습니다.
PCD_LINK_KEYString생성된 링크의 고유 주소입니다.MTI6MTU4NDYwNzI4Mg
PCD_LINK_URLString생성된 링크의 전체 주소입니다.https://democpay.payple.kr/php/link/?SID=MTI6MTU4NDYwNzI4Mg