정산내역 조회

정산내역 조회 API는 페이플 파트너사가 정산 대상 거래 내역을 직접 조회하고, 내부 주문/매출 데이터와 대사할 수 있도록 제공하는 API입니다.
정산일 기준의 거래 단건 목록으로 제공됩니다.

한 번의 파트너 인증 후 30분의 유효 시간 동안 조회 요청을 해야 합니다.
정산내역 조회는 1초에 1회, 2분당 20회를 초과하는 요청은 거부됩니다.

00연동 준비

페이플이 제공하는 테스트 정보를 통해 계약 전 단계에서도 누구나 연동 체험이 가능합니다.

테스트 환경 접속 정보

접속 도메인https://democpay.payple.kr

cst_idtest

custKeyabcd1234567890

주의

요청 header 설정파트너 인증시 referer 헤더의 값을 결제창이 호출될 도메인으로 입력해주세요. 별도의 테스트 계정을 발급 받으신 경우, 도메인을 검증하므로 등록한 도메인이 포함된 referer로 설정해야합니다. 일치하지 않으면 가 반환됩니다.

참고

환경별 키 분리테스트와 라이브는 cst_idcustKey 가 모두 다릅니다. 환경변수로 분리해두면 같은 인증 오류를 피할 수 있습니다.

통신 보안파트너사는 TLS v1.2 이상 / SSL 보안 통신(HTTPS)을 필수적으로 적용해야 합니다.

01파트너 인증 요청

server

Header 설정 후 API를 요청해주세요.
정산내역 조회 인증/요청에는 PCD_SETTLEMENT_FLAG를 사용합니다.

저장해두기cst_id02 정산내역 조회custKey02 정산내역 조회AuthKey02 정산내역 조회

POST테스트https://democpay.payple.kr/php/auth.php

POST라이브https://cpay.payple.kr/php/auth.php

정산내역 조회 요청 시 요구되는 파트너 인증에 필요한 Request 파라미터는 아래와 같습니다.

파라미터	타입	설명	값 예시
cst_id필수	String 12	파트너 인증을 위한 ID 입니다. 라이브 ID 는 계약이 완료되어야 발급 가능합니다.	test
custKey필수	String 255	파트너 인증을 위한 키입니다. 라이브 키는 계약이 완료되어야 발급 가능합니다.외부에 노출되면 안되는 정보입니다. 보안에 유의해주세요.	abcd1234567890
PCD_SETTLEMENT_FLAG필수	String 1	정산내역 조회 요청을 위한 파라미터입니다.	Y

02정산내역 조회

server

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

첫 요청에서는 PCD_LASTKEY를 생략합니다.
PCD_HAS_MORE가 true이면 응답으로 받은 PCD_LASTKEY를 다음 요청에 그대로 전달합니다 (디코딩, 값 변경 불필요)
PCD_HAS_MORE가 false이면 마지막 페이지입니다.

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

주의

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

받아서 넣기PCD_CST_ID01 파트너 인증 요청PCD_CUST_KEY01 파트너 인증 요청PCD_AUTH_KEY01 파트너 인증 요청

POST테스트https://democpay.payple.kr/php/SettlementAct.php

POST라이브https://cpay.payple.kr/php/SettlementAct.php

파트너 인증 후 정산내역 조회 요청 시 필요한 Request 파라미터는 아래와 같습니다.
정산내역 조회는 1초에 1회, 2분당 20회를 초과하는 요청은 거부됩니다.

파라미터	타입	설명	값 예시
PCD_CST_ID필수	String 255	파트너 인증 후 수신한 ID입니다.	UFVNNVZ…
PCD_CUST_KEY필수	String 255	파트너 인증 후 수신한 키입니다.	T3JzRkp5L…
PCD_AUTH_KEY필수	String	파트너 인증 후 수신한 인증 키입니다. 파트너 인증 응답으로 받은 값을 그대로 사용해주세요.	a688ccb3555…
PCD_SETTLEMENT_FLAG필수	String 1	정산내역 조회 요청을 위한 파라미터입니다.	Y
PCD_START_DATE필수	String 10	정산일 기준 시작일입니다. yyyy-MM-dd 또는 yyyyMMdd 형식으로 전송합니다.PCD_END_DATE 와의 조회 기간은 최대 31일입니다.	2026-05-18
PCD_END_DATE필수	String 10	정산일 기준 종료일입니다. yyyy-MM-dd 또는 yyyyMMdd 형식으로 전송합니다.PCD_START_DATE 와의 조회 기간은 최대 31일입니다.	2026-05-18
PCD_METHOD	String 10	결제 수단 필터입니다. 미전송 시 모든 결제 수단을 조회합니다. 요청 시에는 대문자로 전송합니다.CARD : 카드 결제 (카드 빌링 결제 포함)EASYPAY : 간편페이 (네이버페이, 카카오페이)TRANSFER : 계좌이체	CARD
PCD_LIMIT	Number	페이지 크기입니다.기본값 100, 최소 1, 최대 3000	100
PCD_LASTKEY	String 255	다음 페이지 커서입니다. 첫 요청에서는 생략합니다. 응답의 PCD_HAS_MORE 가 true 인 경우 반환된 PCD_LASTKEY 를 그대로 다음 요청에 전송합니다.디코딩·값 변경 없이 그대로 전달해주세요.	eyJhcHByb3ZlZEF0IjoiMjAyNi0wNC0yMFQxMDowMDowMCJ9