정산내역 조회
V1구버전 개발자센터
V2신버전 개발자센터

정산내역 조회

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

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

00연동 준비

페이플 가입 계약 심사가 완료되면 테스트 계정이 발급되며, 발급받은 테스트 계정으로 연동을 체험할 수 있습니다.

테스트 환경 접속 정보
접속 도메인https://democpay.payple.kr
cst_id발급받은 cst_id
custKey발급받은 custKey
주의
요청 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 는 계약이 완료되어야 발급 가능합니다.발급받은 cst_id
custKey필수String
255
파트너 인증을 위한 키입니다. 라이브 키는 계약이 완료되어야 발급 가능합니다.외부에 노출되면 안되는 정보입니다. 보안에 유의해주세요.발급받은 custKey
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_METHODString
10
결제 수단 필터입니다.
미전송 시 모든 결제 수단을 조회합니다.
요청 시에는 대문자로 전송합니다.
CARD : 카드 결제 (카드 빌링 결제 포함)EASYPAY : 간편페이 (네이버페이, 카카오페이)TRANSFER : 계좌이체
CARD
PCD_LIMITNumber페이지 크기입니다.기본값 100, 최소 1, 최대 3000100
PCD_LASTKEYString
255
다음 페이지 커서입니다.
첫 요청에서는 생략합니다.
응답의 PCD_HAS_MORE 가 true 인 경우 반환된 PCD_LASTKEY 를 그대로 다음 요청에 전송합니다.
디코딩·값 변경 없이 그대로 전달해주세요.
eyJhcHByb3ZlZEF0IjoiMjAyNi0wNC0yMFQxMDowMDowMCJ9
결제 연동과 관련된 무엇이든 물어보세요