운영

대사〉국내 정산〉정산내역 조회

연동하기

정산내역 조회 API는 페이플 파트너사가 정산 대상 거래 내역을 직접 조회하고, 내부 주문/매출 데이터와 대사할 수 있도록 제공하는 API입니다.
정산일 기준의 거래 단건 목록으로 제공됩니다.
한 번의 파트너 인증 후 30분의 유효 시간 동안 조회 요청을 해야 합니다.
정산내역 조회는 1초에 1회, 2분당 20회를 초과하는 요청은 거부됩니다.

연동 흐름

1. 파트너 인증 요청

Server

파라미터 확인 →

1.1 요청 예시

Header 설정 후 API를 요청해주세요.
정산내역 조회 인증/요청에는 PCD_SETTLEMENT_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.com

Body

JSON

1{
2  "cst_id": "test",
3  "custKey": "abcd1234567890",
4  "PCD_SETTLEMENT_FLAG": "Y"
5}

·주의사항

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

2. 정산내역 조회 요청

Server

파라미터 확인 →

2.1 요청 예시

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

조회 기간(PCD_START_DATE~PCD_END_DATE)은 정산일 기준이며 최대 31일까지 지정 가능합니다.

첫 요청에서는 PCD_LASTKEY를 생략합니다.
PCD_HAS_MORE가 true이면 PCD_LASTKEY를 다음 요청에 그대로 전달합니다 (디코딩·값 변경 금지)
PCD_HAS_MORE가 false이면 마지막 페이지입니다.

POSThttps://democpay.payple.kr/php/SettlementAct.php테스트 환경

POSThttps://cpay.payple.kr/php/SettlementAct.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_SETTLEMENT_FLAG": "Y",
6  "PCD_START_DATE": "2026-05-18",
7  "PCD_END_DATE": "2026-05-18",
8  "PCD_LIMIT": 100
9}

다음 페이지 요청 Body

JSON

1{
2  "PCD_CST_ID": "UFVNNVZ...",
3  "PCD_CUST_KEY": "T3JzRkp5L...",
4  "PCD_AUTH_KEY": "a688ccb3555...",
5  "PCD_SETTLEMENT_FLAG": "Y",
6  "PCD_START_DATE": "2026-05-18",
7  "PCD_END_DATE": "2026-05-18",
8  "PCD_LIMIT": 100,
9  "PCD_LASTKEY": "eyJhcHByb3ZlZEF0IjoiMjAyNi0wNC0yMFQxMDowMDowMCIsImlkIjo5ODc2NTR9"
10}

Response (결제 + 취소 혼합)

JSON

1{
2  "PCD_PAY_RST": "success",
3  "PCD_PAY_CODE": "PSTL0000",
4  "PCD_PAY_MSG": "success",
5  "PCD_DATA": {
6    "PCD_CONTENT": [
7      {
8        "PCD_TXN_TYPE": "APPROVAL",
9        "PCD_PAY_OID": "ORDER-A-003",
10        "PCD_PAY_TIME": "2026-05-17 20:30:00",
11        "PCD_PAY_CANCEL_TIME": null,
12        "PCD_SETTLE_DATE": "2026-05-18",
13        "PCD_PAY_TYPE": "card",
14        "PCD_PAYER_NAME": "홍길동",
15        "PCD_PAY_GOODS": "테스트 상품",
16        "PCD_PAY_AMOUNT": 39000,
17        "PCD_FEE_SUPPLY": 1131,
18        "PCD_FEE_VAT": 113,
19        "PCD_FEE_TOTAL": 1244,
20        "PCD_SETTLE_AMOUNT": 37756
21      },
22      {
23        "PCD_TXN_TYPE": "CANCEL",
24        "PCD_PAY_OID": "ORDER-A-002",
25        "PCD_PAY_TIME": "2026-05-15 10:00:00",
26        "PCD_PAY_CANCEL_TIME": "2026-05-17 15:00:00",
27        "PCD_SETTLE_DATE": "2026-05-18",
28        "PCD_PAY_TYPE": "easypay",
29        "PCD_PAYER_NAME": "김철수",
30        "PCD_PAY_GOODS": "테스트 상품2",
31        "PCD_PAY_AMOUNT": 50000,
32        "PCD_FEE_SUPPLY": -500,
33        "PCD_FEE_VAT": -50,
34        "PCD_FEE_TOTAL": -550,
35        "PCD_SETTLE_AMOUNT": -49450
36      }
37    ],
38    "PCD_HAS_MORE": true,
39    "PCD_LASTKEY": "eyJhcHByb3ZlZEF0IjoiMjAyNi0wNC0yMFQxMDowMDowMCIsImlkIjo5ODc2NTR9",
40    "PCD_PAGE_TOTALS": {
41      "PCD_TOTAL_COUNT": 2,
42      "PCD_TOTAL_APPROVAL_AMOUNT": 39000,
43      "PCD_TOTAL_CANCEL_AMOUNT": 50000,
44      "PCD_TOTAL_FEE_AMOUNT": 694,
45      "PCD_TOTAL_SETTLE_AMOUNT": -11694
46    }
47  }
48}

Response (거래 없음)

JSON

1{
2  "PCD_PAY_RST": "success",
3  "PCD_PAY_CODE": "PSTL0000",
4  "PCD_PAY_MSG": "success",
5  "PCD_DATA": {
6    "PCD_CONTENT": [],
7    "PCD_HAS_MORE": false,
8    "PCD_LASTKEY": null,
9    "PCD_PAGE_TOTALS": {
10      "PCD_TOTAL_COUNT": 0,
11      "PCD_TOTAL_APPROVAL_AMOUNT": 0,
12      "PCD_TOTAL_CANCEL_AMOUNT": 0,
13      "PCD_TOTAL_FEE_AMOUNT": 0,
14      "PCD_TOTAL_SETTLE_AMOUNT": 0
15    }
16  }
17}

·주의사항

·정산일(PCD_SETTLE_DATE)이 당일인 데이터는 당일 오전 07:00부터 조회 가능합니다.
·정산일 당일 07:00 이전 또는 미래의 정산일을 조회하는 경우, 'PSTL0001' 오류가 응답됩니다.
·정산일 산출: 가맹점 계약 정산 주기에 따라 결제일로부터 N영업일 후로 결정됩니다.
·PCD_PAGE_TOTALS 금액은 수수료 절삭 정책으로 인해 거래 건별 단순 합과 ±N원 차이가 날 수 있습니다.
정확한 합계가 필요한 경우 첫 페이지부터 마지막 페이지까지 순차 호출 후 토탈을 합산해주세요.

2.2 정렬

필터 기준 정산일 (PCD_SETTLE_DATE)

정렬 기준 원결제 승인 시각 (PCD_PAY_TIME) 최신순

같은 PCD_PAY_TIME 안에서는 다음 순서로 노출됩니다

원결제 (APPROVAL) 먼저

취소/부분취소 (CANCEL), 동일 결제 건의 여러 취소는 PCD_PAY_CANCEL_TIME 오래된 순

예시

#	PCD_PAY_TIME	PCD_TXN_TYPE	PCD_PAY_OID	PCD_PAY_CANCEL_TIME
1	2026-05-17 14:00:00	APPROVAL	ORDER-B-002	null
2	2026-05-17 10:00:00	APPROVAL	ORDER-A-001	null
3	2026-05-17 10:00:00	CANCEL	ORDER-A-001	2026-05-17 11:00:00
4	2026-05-17 10:00:00	CANCEL	ORDER-A-001	2026-05-17 14:00:00

거래 유형(PCD_TXN_TYPE), 결제 수단(PCD_METHOD / PCD_PAY_TYPE) 등 요청·응답 필드 값은 파라미터 페이지에서 확인할 수 있습니다.

파라미터 확인

정산내역 조회 API의 PSTL 응답 코드 전체 목록은 응답 코드 페이지에서 확인할 수 있습니다.

응답 코드 확인