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

운영

국내 카드결과 조회


연동하기

웹훅(Webhook)을 통한 결제 결과 수신에 실패한 경우에도 결제 결과를 확인하실 수 있습니다.
한 번의 파트너 인증 후 30분의 유효 시간 동안 조회 요청을 해야 하며, 10분당 1,000건을 초과하는 요청은 거부됩니다.

연동 흐름

국내카드결과조회_플로우
국내카드결과조회_플로우

1. 파트너 인증 요청

Server
파라미터 확인 →

1.1 요청 예시

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_PAYCHK_FLAG": "Y"
5}

·주의사항

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

2. 결과 조회 요청

Server
파라미터 확인 →

2.1 요청 예시

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

POSThttps://democpay.payple.kr/php/PayChkAct.php테스트 환경
POSThttps://cpay.payple.kr/php/PayChkAct.php라이브 환경
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_PAYCHK_FLAG": "Y",
6  "PCD_PAY_TYPE": "card",
7  "PCD_PAY_OID": "order12345",
8  "PCD_PAY_DATE": "20231219"
9}

·주의사항

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