국내 링크결제

페이플 링크결제는 사용자 친화적인 인터페이스를 통해 신속하게 결제 링크를 생성하기 때문에 비대면 결제에 적합한 제품입니다.
결제 링크는 파트너 관리자 페이지 또는 API를 사용하여 생성 가능합니다.
링크결제 API는 국내 결제(카드/계좌)에서만 제공됩니다.

00연동 준비

페이플이 제공하는 테스트 정보를 통해 계약 전 단계에서도 누구나 연동 체험이 가능합니다.

테스트 환경 접속 정보

접속 도메인https://democpay.payple.kr

cst_idtest

custKeyabcd1234567890

clientKeytest_DF55F29DA654A8CBC0F0A9DD4B556486

PCD_REFUND_KEY (결제취소 시 이용)a41ce010ede9fcbfb3be86b24858806596a9db68b79d138b147c3e563e1829a0

주의

요청 header 설정파트너 인증시 referer 헤더의 값을 결제창이 호출될 도메인으로 입력해주세요. 별도의 테스트 계정을 발급 받으신 경우, 도메인을 검증하므로 등록한 도메인이 포함된 referer로 설정해야합니다. 일치하지 않으면 가 반환됩니다.

참고

환경별 키 분리테스트와 라이브는 clientKeycst_idcustKey 가 모두 다릅니다. 환경변수로 분리해두면 같은 인증 오류를 피할 수 있습니다.

통신 보안파트너사는 TLS v1.2 이상 / SSL 보안 통신(HTTPS)을 필수적으로 적용해야 합니다.

테스트 환경카드는 실제 결제 후 24시간 내 자동 취소, 계좌는 실제 출금 없음문서 바로가기 웹훅결제 완료, 취소 완료, 결제수단 등록, 결제수단 해지 결과를 받아 누락을 막습니다문서 바로가기

파라미터 값 유의사항

Emoji 등 한글, 영어, 숫자를 제외한 문자를 파라미터에 포함할 경우, 결제 또는 결제내역 조회가 정상적으로 처리되지 않을 수 있습니다.
모든 파라미터 값에는 이모지 사용을 지양해 주시기 바라며 파라미터에 사용 가능한 특수문자는 아래와 같습니다.

`!@#$%^*()_=-[]{};:./?

샘플 코드java node react python php

01파트너 인증 요청

server

저장해두기cst_id02 링크 생성 요청custKey02 링크 생성 요청AuthKey02 링크 생성 요청

POST테스트https://democpay.payple.kr/php/auth.php

POST라이브https://cpay.payple.kr/php/auth.php

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

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

02링크 생성 요청

server

받아서 넣기PCD_CST_ID01 파트너 인증 요청PCD_CUST_KEY01 파트너 인증 요청PCD_AUTH_KEY01 파트너 인증 요청

POST테스트https://democpay.payple.kr/php/link/api/LinkRegAct.php?ACT_=LINKREG

POST라이브https://cpay.payple.kr/php/link/api/LinkRegAct.php?ACT_=LINKREG

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

파라미터	타입	설명	값 예시
PCD_CST_ID필수	String 255	파트너 인증 후 수신한 ID입니다.	UFVNNVZ…
PCD_CUST_KEY필수	String 255	파트너 인증 후 수신한 키입니다.	T3JzRkp5L…
PCD_AUTH_KEY필수	String	파트너 인증 후 수신한 인증 키입니다. 파트너 인증 응답으로 받은 값을 그대로 사용해주세요.	a688ccb3555…
PCD_PAY_WORK필수	String 255	결제링크 생성을 요청합니다.	LINKREG
PCD_PAY_TYPE필수	String 255	결제수단을 선택합니다.기본값(카드+계좌) : transfer+card카드: card / 계좌: transfer	transfer+card
PCD_PAY_GOODS필수	String 255	상품명입니다. Emoji 또는 허용되지 않은 특수문자(& ' " \ < > \| \n \r\n , +)만으로 구성된 값은 입력할 수 없습니다.	테스트 상품
PCD_PAY_TOTAL필수	Number 255	총 결제금액입니다.	1000
PCD_PAY_GOODS_EXPLAIN	String 255	상품 설명입니다. Emoji 또는 허용되지 않은 특수문자(& ' " \ < > \| \n \r\n , +)만으로 구성된 값은 입력할 수 없습니다.	해당 상품은 테스트를 위한 상품입니다.
PCD_PAY_ISTAX	String 1	과세 여부입니다. 기본값은 Y 이며, 유형별로 아래와 같이 설정해주세요.과세, 복합과세 : Y비과세 : N	Y
PCD_PAY_TAXTOTAL	Number 9	복합과세 주문 시에만 이용하며, 복합과세 주문의 부가세를 설정합니다.예: 총 결제금액(PCD_PAY_TOTAL) 10,000원 중 복합과세 주문의 부가세가 500원이면 500으로 설정	500
PCD_LINK_EXPIREDATE	String 8 또는 10 또는 14	결제 만료일시를 설정합니다. 미지정 시 무기한으로 만료일시가 설정됩니다. YYYYMMDD 형태로 요청 시 만료일시는 해당 날짜의 23:59:59로 설정됩니다. YYYYMMDD, YYYYMMDDHH, YYYYMMDDHHMMSS 형태로 전송하지 않을 시 예외가 발생합니다. 20270425 로 요청 시 만료일시는 2027-04-25 23:59:59입니다. 2027042509 로 요청 시 만료일시는 2027-04-25 09:00:00입니다. 20270425235959 로 요청 시 만료일시는 2027-04-25 23:59:59입니다.	20270425 혹은 2027042509 혹은 20270425235959
PCD_LINK_PARAMETER	String 255	사용자 정의 파라미터입니다.	params1=val1&params2=val2
PCD_LINK_NOTI_MSG	String 255	결제완료 화면에서 표시될 내용을 입력합니다. 결제 완료 후 구매자에게 전달하고자 하는 안내 문구가 있으면 이를 사용할 수 있습니다. Emoji 또는 허용되지 않은 특수문자(& ' " \ < > \| \n \r\n , +)만으로 구성된 값은 입력할 수 없습니다.
PCD_LINK_MEMO	String 1024	상점 관리자에서 표시될 메모입니다. Emoji 또는 허용되지 않은 특수문자(& ' " \ < > \| \n \r\n , +)만으로 구성된 값은 입력할 수 없습니다.	테스트 링크결제
PCD_LINK_URL	String 255	결제 완료 화면에서 구매자가 '이동하기' 버튼을 클릭하면 이동할 URL을 지정할 수 있습니다.	www.your-domain.com
PCD_GOODS_AMOUNT	Number 3	결제 마감 수량을 지정합니다.1 ~ 999까지 가능	15
PCD_CARD_VER카드	String 5	카드 결제방식을 선택합니다.기본값(앱카드+빌링): 01+0201 : 빌링 - 정기결제가 아닌 일회성 키인 결제02 : 앱카드PCD_PAY_TYPE 이 'card' 인 경우에만 해당	01+02
PCD_PAY_METHOD카드	String 255	간편페이 결제방식을 선택합니다. 입력된 값에 따라 결제 수단이 노출되며, 이는 해당 결제수단을 이용하는 파트너사에 한해 적용됩니다.네이버페이 : naverPay카카오페이 : kakaoPay네이버페이, 카카오페이 둘 다 이용 : naverPay+kakaoPay	naverPay+kakaoPay
PCD_TAXSAVE_FLAG계좌	String 1	현금영수증 발행창 호출 여부입니다.호출 : Y미호출: 미입력	Y

03링크 전달과 결과 수신

server

응답의 PCD_LINK_URL 을 구매자에게 전달합니다. 결제 결과는 웹훅으로 받습니다. 이 단계에서 호출하는 API 는 없습니다.

주의

PCD_LINK_URL 은 요청과 응답에서 뜻이 다름링크 생성 요청의 PCD_LINK_URL 은 결제 완료 화면에서 이동할 주소이고, 응답의 PCD_LINK_URL 은 생성된 링크 주소입니다. 구매자에게는 응답 값을 전달하세요.

04링크 만료처리 요청 (필요 시)

server

결제가 필요 없어진 링크를 막을 때 사용합니다. 링크 생성 직후에 해야 하는 단계가 아닙니다.

POST테스트https://democpay.payple.kr/php/link/api/LinkRegAct.php?ACT_=LINKEXPIRE

POST라이브https://cpay.payple.kr/php/link/api/LinkRegAct.php?ACT_=LINKEXPIRE

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

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

3.2 링크 만료처리 요청

파라미터	타입	설명	값 예시
PCD_CST_ID필수	String 255	파트너 인증 후 수신한 ID입니다.	UFVNNVZ…
PCD_CUST_KEY필수	String 255	파트너 인증 후 수신한 키입니다.	T3JzRkp5L…
PCD_AUTH_KEY필수	String	파트너 인증 후 수신한 인증 키입니다. 파트너 인증 응답으로 받은 값을 그대로 사용해주세요.	a688ccb3555…
PCD_LINK_KEY필수	String	생성된 링크의 고유 키입니다.	MTI6MTU4NDYwNzI4Mg

05링크 결제상태 조회 요청 (필요 시)

server

결제 여부를 직접 확인할 때 사용합니다. 결제 결과는 웹훅으로도 수신됩니다.

참고

주문 목록은 최대 10건결제가 완료된 건이 있으면 PCD_LINK_ORDERS 에 주문 목록이 최대 10건까지 조회됩니다. 전체 주문 수는 PCD_LINK_PAYCOUNT 로 확인하세요.

POST테스트https://democpay.payple.kr/php/link/api/LinkRegAct.php?ACT_=LINKSTATUS

POST라이브https://cpay.payple.kr/php/link/api/LinkRegAct.php?ACT_=LINKSTATUS

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

파라미터	타입	설명	값 예시
cst_id필수	String 12	파트너 인증을 위한 ID 입니다. 라이브 ID 는 계약이 완료되어야 발급 가능합니다.	test
custKey필수	String 255	파트너 인증을 위한 키입니다. 라이브 키는 계약이 완료되어야 발급 가능합니다.외부에 노출되면 안되는 정보입니다. 보안에 유의해주세요.	abcd1234567890
PCD_PAY_WORK필수	String 20	링크 결제 상태 조회 요청을 위한 파라미터 입니다.	LINKSTATUS

4.2 결제 상태 조회 요청

파라미터	타입	설명	값 예시
PCD_CST_ID필수	String 255	파트너 인증 후 수신한 ID입니다.	UFVNNVZ…
PCD_CUST_KEY필수	String 255	파트너 인증 후 수신한 키입니다.	T3JzRkp5L…
PCD_AUTH_KEY필수	String	파트너 인증 후 수신한 인증 키입니다. 파트너 인증 응답으로 받은 값을 그대로 사용해주세요.	a688ccb3555…
PCD_LINK_KEY필수	String	생성된 링크의 고유 키입니다.	MTI6MTU4NDYwNzI4Mg