운영
대사〉국내 거래〉거래내역 조회
연동하기
국내 거래내역 조회 API는 페이플 파트너사가 국내 카드·계좌 결제의 승인/취소 거래 이력을 발생일시 기준으로 조회하고, 내부 거래 데이터와 대사할 수 있도록 제공하는 API입니다.
실시간 거래 상태 조회는 국내 카드 > 결과조회 또는 국내 계좌 > 결과조회의 단건 조회를 사용하세요.
한 번의 파트너 인증 후 30분의 유효 시간 동안 조회 요청을 해야 합니다.
거래내역 조회는 1초에 1회, 2분당 20회를 초과하는 요청은 거부됩니다.
실시간 거래 상태 조회는 국내 카드 > 결과조회 또는 국내 계좌 > 결과조회의 단건 조회를 사용하세요.
한 번의 파트너 인증 후 30분의 유효 시간 동안 조회 요청을 해야 합니다.
거래내역 조회는 1초에 1회, 2분당 20회를 초과하는 요청은 거부됩니다.
연동 흐름
1. 파트너 인증 요청
Server1.1 요청 예시
Header 설정 후 API를 요청해주세요.
거래내역 조회 인증/요청에는 다건 결과조회와 동일하게 PCD_PAYCHK_LIST_FLAG를 사용합니다.
거래내역 조회 인증/요청에는 다건 결과조회와 동일하게 PCD_PAYCHK_LIST_FLAG를 사용합니다.
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.comBody
JSON
1{
2 "cst_id": "test",
3 "custKey": "abcd1234567890",
4 "PCD_PAYCHK_LIST_FLAG": "Y"
5}·주의사항
Referer 필드에는 페이플에 등록된 파트너(상점)의 도메인을 정확히 입력해주세요. 도메인이 일치하지 않을 경우, 'AUTH0004' 오류 메시지가 반환됩니다.
2. 거래내역 조회 요청
Server2.1 요청 예시
다건 결과조회 API의 엔드포인트와 동일합니다.
조회 기간(PCD_START_DATE~PCD_END_DATE)은 거래 발생일시 기준입니다.
최대 1년까지 지정 가능합니다.
요청에 PCD_DATE_TYPE: EVENT_DATE를 반드시 포함해야 합니다.
EVENT_DATE 모드의 PCD_LIMIT는 최대 1000까지 설정 가능합니다.
첫 요청에서는 PCD_LASTKEY를 생략합니다.
PCD_HAS_MORE가 true이면 응답으로 받은 PCD_LASTKEY를 다음 요청에 그대로 전달합니다 (디코딩·값 변경 불필요)
PCD_HAS_MORE가 false이면 마지막 페이지입니다.
Header 설정 후 API를 요청해주세요.
조회 기간(PCD_START_DATE~PCD_END_DATE)은 거래 발생일시 기준입니다.
최대 1년까지 지정 가능합니다.
요청에 PCD_DATE_TYPE: EVENT_DATE를 반드시 포함해야 합니다.
EVENT_DATE 모드의 PCD_LIMIT는 최대 1000까지 설정 가능합니다.
첫 요청에서는 PCD_LASTKEY를 생략합니다.
PCD_HAS_MORE가 true이면 응답으로 받은 PCD_LASTKEY를 다음 요청에 그대로 전달합니다 (디코딩·값 변경 불필요)
PCD_HAS_MORE가 false이면 마지막 페이지입니다.
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
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", // card (카드) 또는 transfer (계좌)
9 "PCD_DATE_TYPE": "EVENT_DATE",
10 "PCD_LIMIT": 1000
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": "20260501",
7 "PCD_END_DATE": "20260501",
8 "PCD_PAY_TYPE": "card", // card (카드) 또는 transfer (계좌)
9 "PCD_DATE_TYPE": "EVENT_DATE",
10 "PCD_LIMIT": 1000,
11 "PCD_LASTKEY": "gmUZOwXKxH64MWh3CsL3xg=="
12}Response (카드 - 같은 날 결제+부분취소)
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": "2026-05-01 13:00:00", // 원결제 승인일시
13 "PCD_PAY_TYPE": "card",
14 "PCD_PAYER_NO": "1234",
15 "PCD_PAYER_ID": "OVA3...",
16 "PCD_PAY_GOODS": "테스트 상품",
17 "PCD_PAY_AMOUNT": 50000,
18 "PCD_PAY_TOTAL": 40000,
19 "PCD_PAY_ISTAX": "Y",
20 "PCD_PAY_TAXTOTAL": 3636,
21 "PCD_REGULER_FLAG": "N",
22 "PCD_PAY_STATE": "부분승인취소완료",
23 "PCD_PAYER_NAME": "홍길동",
24 "PCD_PAY_CARDQUOTA": "00",
25 "PCD_PAY_CARDNAME": "국민",
26 "PCD_PAY_CARDNUM": "1234-****-****-5678",
27 "PCD_PAY_CARDTRADENUM": "paypletttm0101260501130000a123",
28 "PCD_PAY_CARDAUTHNO": "12345678",
29 "PCD_PAY_PAYMENT_TYPE": "신용카드",
30 "PCD_TRANSACTIONS": [ // 조회 기간 내 발생 거래
31 {
32 "PCD_TX_TYPE": "APPROVAL",
33 "PCD_TX_TIME": "2026-05-01 13:00:00",
34 "PCD_TX_AMOUNT": 50000,
35 "PCD_TX_TAX_AMOUNT": 4545
36 },
37 {
38 "PCD_TX_TYPE": "CANCEL",
39 "PCD_TX_TIME": "2026-05-01 18:30:00",
40 "PCD_TX_AMOUNT": -10000,
41 "PCD_TX_TAX_AMOUNT": -909
42 }
43 ]
44 }
45 ]
46 }
47}Response (계좌 - 이전 결제건의 환불 발생)
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": "order67890",
12 "PCD_PAY_TIME": "2026-04-25 09:30:00", // 원결제 승인일시 (조회 기간 밖)
13 "PCD_PAY_TYPE": "transfer",
14 "PCD_PAYER_NO": "5678",
15 "PCD_PAYER_ID": "OVA4...",
16 "PCD_PAY_GOODS": "구독 상품",
17 "PCD_PAY_AMOUNT": 30000,
18 "PCD_PAY_TOTAL": 10000,
19 "PCD_PAY_ISTAX": "Y",
20 "PCD_PAY_TAXTOTAL": 909,
21 "PCD_REGULER_FLAG": "N",
22 "PCD_PAY_STATE": "부분승인취소완료",
23 "PCD_PAYER_NAME": "김철수",
24 "PCD_PAY_BANK": "020",
25 "PCD_PAY_BANKNAME": "우리은행",
26 "PCD_PAY_BANKNUM": "123-********-456",
27 "PCD_TAXSAVE_FLAG": "Y",
28 "PCD_TAXSAVE_RST": "Y",
29 "PCD_TAXSAVE_MGTNUM": "G123456",
30 "PCD_TRANSACTIONS": [ // 조회 기간 내 발생 거래
31 {
32 "PCD_TX_TYPE": "CANCEL",
33 "PCD_TX_TIME": "2026-05-01 10:20:30",
34 "PCD_TX_AMOUNT": -10000,
35 "PCD_TX_TAX_AMOUNT": -909
36 },
37 {
38 "PCD_TX_TYPE": "CANCEL",
39 "PCD_TX_TIME": "2026-05-01 18:45:00",
40 "PCD_TX_AMOUNT": -10000,
41 "PCD_TX_TAX_AMOUNT": -909
42 }
43 ]
44 }
45 ]
46 }
47}Response (거래 없음)
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}·주의사항
·조회 기간 내에 취소가 발생한 결제건은, 결제일이 기간 밖이더라도 응답에 포함됩니다.
예) 4/25 결제건이 5/1에 환불 처리되었다면, 5/1 조회 시 이 건은 응답에 포함됩니다.
·응답 본문(PCD_CONTENT[i])의 결제 정보(금액, 상품명, 카드/계좌 정보 등)는 원결제 기준이며, 조회 기간 내 발생한 거래는 PCD_TRANSACTIONS 배열로 별도 제공됩니다.
·PCD_LASTKEY는 EVENT_DATE 모드 전용 커서로, PAY_DATE 요청에는 사용할 수 없습니다.
2.2 정렬
필터 기준 거래 발생일시 (PCD_TX_TIME = 승인 시각 또는 환불 처리 시각)
정렬 기준 원결제의 마지막 거래 발생일시 최신순
PCD_TRANSACTIONS 배열 내부는 다음 순서로 노출됩니다
1
원결제 (APPROVAL) 먼저 (조회 기간 내에 결제일이 포함된 경우)
2
취소/부분취소 (CANCEL), PCD_TX_TIME 오래된 순
예시
같은 # 행은 같은 PCD_CONTENT 원결제 항목에 속한 거래입니다. PCD_CONTENT는 원결제의 마지막 거래 시각 최신순으로 정렬되며, PCD_TRANSACTIONS 배열 내부는 PCD_TX_TIME 오래된 순으로 정렬됩니다.
| # | PCD_PAY_OID | PCD_TX_TYPE | PCD_TX_TIME | PCD_TX_AMOUNT |
|---|---|---|---|---|
| 1 | order67890 | CANCEL | 2026-05-01 10:20:30 | -10,000 |
| 1 | order67890 | CANCEL | 2026-05-01 18:45:00 | -10,000 |
| 2 | order12345 | APPROVAL | 2026-05-01 13:00:00 | +50,000 |
| 2 | order12345 | CANCEL | 2026-05-01 18:30:00 | -10,000 |