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

운영

국내 카드〉결과 조회

연동하기

웹훅(Webhook)을 통한 결제 결과 수신에 실패한 경우에도 결제 결과를 확인하실 수 있습니다.
한 번의 파트너 인증 후 30분의 유효 시간 동안 조회 요청을 해야 합니다.

단건 조회, 다건 조회는 각각 별도의 유량 제어 정책이 적용됩니다.
단건 조회는 1초에 2회, 10분당 1,000회를 초과하는 요청은 거부됩니다.
다건 조회는 1초에 1회, 2분당 20회를 초과하는 요청은 거부됩니다.

연동 흐름

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

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’ 오류 메시지가 반환됩니다.

1.2 다건 조회 예시

다건 조회 API에서도 파트너 인증 요청 방식은 단건 조회와 동일합니다.
다건 조회 인증/요청에는 PCD_PAYCHK_LIST_FLAG를 사용합니다.

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’ 오류 메시지가 반환됩니다.

2.2 다건 조회 예시

조회 날짜 범위(PCD_START_DATE~PCD_END_DATE)는 최대 1년까지 가능합니다.

PCD_DATE_TYPE으로 날짜 조회 기준을 선택합니다

첫 요청에서는 PCD_LASTKEY를 생략합니다.
PCD_HAS_MORE가 true이면 응답으로 받은 PCD_LASTKEY를 다음 요청에 그대로 전달합니다.
PCD_LASTKEY는 PCD_DATE_TYPE 모드 간 호환되지 않습니다.

Header 설정 후 API를 요청해주세요.
POSThttps://democpay.payple.kr/php/PayChkActList.php테스트 환경
POSThttps://cpay.payple.kr/php/PayChkActList.php라이브 환경
Header
1Content-Type: application/json
2Cache-Control: no-cache
3Referer: https://your-domain.com
첫 요청 Body (PAY_DATE 모드)
JSON
1{
2  "PCD_CST_ID": "UFVNNVZ...",
3  "PCD_CUST_KEY": "T3JzRkp5L...",
4  "PCD_AUTH_KEY": "a688ccb3555...",
5  "PCD_PAYCHK_LIST_FLAG": "Y",
6  "PCD_START_DATE": "20231219",
7  "PCD_END_DATE": "20231219",
8  "PCD_PAY_TYPE": "card",
9  "PCD_DATE_TYPE": "PAY_DATE",
10  "PCD_LIMIT": 5000
11}
다음 페이지 요청 Body
JSON
1{
2  "PCD_CST_ID": "UFVNNVZ...",
3  "PCD_CUST_KEY": "T3JzRkp5L...",
4  "PCD_AUTH_KEY": "a688ccb3555...",
5  "PCD_PAYCHK_LIST_FLAG": "Y",
6  "PCD_START_DATE": "20231219",
7  "PCD_END_DATE": "20231219",
8  "PCD_PAY_TYPE": "card",
9  "PCD_DATE_TYPE": "PAY_DATE",
10  "PCD_LIMIT": 5000,
11  "PCD_LASTKEY": "gmUZOwXKxH64MWh3CsL3xg=="
12}
Response (PAY_DATE 모드 - 원결제 기준)
JSON
1{
2  "PCD_PAY_CODE": "PCHK0000",
3  "PCD_PAY_MSG": "success",
4  "PCD_DATA": {
5    "PCD_HAS_MORE": true,
6    "PCD_LASTKEY": "gmUZOwXKxH64MWh3CsL3xg==",
7    "PCD_LIMIT": 5000,
8    "PCD_CONTENT": [
9      {
10        "PCD_CST_ID": "PAYLAP01",
11        "PCD_PAY_OID": "order12345",
12        "PCD_PAY_TIME": "2023-12-19 13:42:23",
13        "PCD_PAY_TYPE": "card",
14        "PCD_PAYER_NO": "1234",
15        "PCD_PAYER_ID": "OVA3...",
16        "PCD_PAYER_EMAIL": "complete@payer-email.com",
17        "PCD_PAY_YEAR": "2023",
18        "PCD_PAY_MONTH": "12",
19        "PCD_PAY_GOODS": "테스트 상품",
20        "PCD_PAY_AMOUNT": 1000,
21        "PCD_PAY_TOTAL": 1000,
22        "PCD_PAY_ISTAX": "Y",
23        "PCD_PAY_TAXTOTAL": 500,
24        "PCD_REGULER_FLAG": "N",
25        "PCD_PAY_STATE": "결제완료",
26        "PCD_PAYER_NAME": "홍길동",
27        "PCD_PAYER_HP": "01012345678",
28        "PCD_PAY_CARDQUOTA": "00",
29        "PCD_PAY_CARDNAME": "국민",
30        "PCD_PAY_CARDNUM": "1234-****-****-5678",
31        "PCD_PAY_CARDTRADENUM": "paypletttm0101231219134223a123",
32        "PCD_PAY_CARDAUTHNO": "12345678",
33        "PCD_PAY_PAYMENT_TYPE": "신용카드"
34      }
35    ]
36  }
37}
첫 요청 Body (EVENT_DATE 모드)
JSON
1{
2  "PCD_CST_ID": "UFVNNVZ...",
3  "PCD_CUST_KEY": "T3JzRkp5L...",
4  "PCD_AUTH_KEY": "a688ccb3555...",
5  "PCD_PAYCHK_LIST_FLAG": "Y",
6  "PCD_START_DATE": "20260501",
7  "PCD_END_DATE": "20260501",
8  "PCD_PAY_TYPE": "card",
9  "PCD_DATE_TYPE": "EVENT_DATE",
10  "PCD_LIMIT": 1000
11}
Response (EVENT_DATE 모드 - 원결제 정보 + 기간 내 거래 이력)
JSON
1{
2  "PCD_PAY_CODE": "PCHK0000",
3  "PCD_PAY_MSG": "success",
4  "PCD_DATA": {
5    "PCD_HAS_MORE": false,
6    "PCD_LASTKEY": null,
7    "PCD_LIMIT": 1000,
8    "PCD_CONTENT": [
9      {
10        "PCD_CST_ID": "PAYLAP01",
11        "PCD_PAY_OID": "order12345",
12        "PCD_PAY_TIME": "2023-12-19 13:42:23",
13        "PCD_PAY_TYPE": "card",
14        "PCD_PAYER_NO": "1234",
15        "PCD_PAYER_ID": "OVA3...",
16        "PCD_PAYER_EMAIL": "complete@payer-email.com",
17        "PCD_PAY_GOODS": "테스트 상품",
18        "PCD_PAY_AMOUNT": 20000,
19        "PCD_PAY_TOTAL": 0,
20        "PCD_PAY_ISTAX": "Y",
21        "PCD_PAY_TAXTOTAL": 0,
22        "PCD_REGULER_FLAG": "N",
23        "PCD_PAY_STATE": "승인취소완료",
24        "PCD_PAYER_NAME": "홍길동",
25        "PCD_PAYER_HP": "01012345678",
26        "PCD_PAY_CARDQUOTA": "00",
27        "PCD_PAY_CARDNAME": "국민",
28        "PCD_PAY_CARDNUM": "1234-****-****-5678",
29        "PCD_PAY_CARDTRADENUM": "paypletttm0101231219134223a123",
30        "PCD_PAY_CARDAUTHNO": "12345678",
31        "PCD_PAY_PAYMENT_TYPE": "신용카드",
32        "PCD_TRANSACTIONS": [
33          {
34            "PCD_TX_TYPE": "CANCEL",
35            "PCD_TX_TIME": "2026-05-01 00:01:15",
36            "PCD_TX_AMOUNT": -20000,
37            "PCD_TX_TAX_AMOUNT": -1818
38          }
39        ]
40      }
41    ]
42  }
43}

·주의사항

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

요청·응답 필드 정의는 파라미터 페이지에서 확인할 수 있습니다.

파라미터 확인

결과조회 API의 PCHK 응답 코드 전체 목록은 응답 코드 페이지에서 확인할 수 있습니다.

응답 코드 확인