로고Developer Center

결제창 연동

링크결제


연동하기

페이플 링크결제는 사용자 친화적인 인터페이스를 통해 신속하게 결제 링크를 생성하기 때문에 비대면 결제에 적합한 제품입니다.
결제 링크는 파트너 관리자 페이지 또는 API를 사용하여 생성 가능합니다.

링크결제 체험하기 →

연동 흐름

결제창연동링크결제_플로우
결제창연동링크결제_플로우

1. 링크 생성을 위한 파트너 인증 요청

Server
파라미터 확인 →

1.1 custKey 확인

계약 완료 후 페이플 담당자에게 전달받은 custKey를 확인해주세요.

·주의사항

custKey 외부에 노출되면 안되는 정보입니다. 보안에 유의해주세요.

1.2 인증 요청

REST API 를 통한 파트너 인증이 성공하면, 결제링크 생성을 진행할 수 있습니다.

1.3 요청 예시

Header 설정 후 API를 요청해주세요.

POSThttps://democpay.payple.kr/php/auth.php테스트 환경
POSThttps://cpay.payple.kr/php/auth.php라이브 환경
Header
1Content-Type : application/json
2Cache-Control : no-cache
3Referer : https://your-domain.com
Body
JSON
1{
2  "cst_id": "test",
3  "custKey": "abcd1234567890",
4  "PCD_PAY_WORK": "LINKREG"
5}

·주의사항

Referer 필드에는 페이플에 등록된 파트너(상점)의 도메인을 정확히 입력해주세요. 도메인이 일치하지 않을 경우, ‘AUTH0004’ 오류 메시지가 반환됩니다.

2. 링크 생성 요청

Server
파라미터 확인 →

2.1 생성 요청

파트너 인증을 완료한 후 REST API를 이용해 결제 링크 생성을 요청하면, 해당 요청에 따라 링크가 생성됩니다.

2.2 요청 예시

Header 설정 후 API를 요청해주세요.

POSThttps://democpay.payple.kr/php/link/api/LinkRegAct.php?ACT_=LINKREG테스트 환경
POSThttps://cpay.payple.kr/php/link/api/LinkRegAct.php?ACT_=LINKREG라이브 환경
Header
1Content-Type : application/json
2Cache-Control : no-cache
3Referer : https://your-domain.com
Body
JSON
1{
2  "PCD_CST_ID": "UFVNNVZ...",
3  "PCD_CUST_KEY": "T3JzRkp5L...",
4  "PCD_AUTH_KEY": "a688ccb3555...",
5  "PCD_PAY_WORK": "LINKREG",
6  "PCD_PAY_TYPE": "card",
7  "PCD_PAY_GOODS": "테스트 상품",
8  "PCD_PAY_GOODS_EXPLAIN": "해당 상품은 테스트를 위한 상품으로 실결제가 진행되지 않는 상품입니다.",
9  "PCD_PAY_TOTAL": "1000",
10  "PCD_LINK_EXPIREDATE": "2025010122"
11}

3. 연동 완료

모든 연동 작업을 완료하셨습니다.
웹훅(Webhook)으로 링크결제 결과를 수신할 수 있습니다.