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

운영

링크결제〉결제 상태 조회

연동하기

생성된 링크의 결제 상태를 조회할 수 있는 기능으로, 결제 전 또는 결제 완료 여부를 확인할 수 있습니다.
결제가 완료된 건이 있는 경우 주문 목록은 최대 10건까지 조회됩니다.

연동 흐름

링크결제_결제상태조회_플로우
링크결제_결제상태조회_플로우

1. 파트너 인증 요청

Server
파라미터 확인 →

1.1 요청 예시

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

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

·주의사항

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

2. 결제상태 조회 요청

Server
파라미터 확인 →

2.1 요청 예시

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

POSThttps://democpay.payple.kr/php/link/api/LinkRegAct.php?ACT_=LINKSTATUS테스트 환경
POSThttps://cpay.payple.kr/php/link/api/LinkRegAct.php?ACT_=LINKSTATUS라이브 환경
Header
1
2    Content-Type: application/json
3    Cache-Control: no-cache
4    Referer: https://your-domain.com
5
Body
JSON
1{
2  "PCD_CST_ID": "UFVNNVZ...",
3  "PCD_CUST_KEY": "T3JzRkp5L...",
4  "PCD_AUTH_KEY": "a688ccb3555...",
5  "PCD_LINK_KEY": "MTI6MTU4NDYwNzI4Mg"
6}

·주의사항

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