거래내역 조회
V1구버전 개발자센터
V2신버전 개발자센터

거래내역 조회

국내 거래내역 조회 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_PAYCHK_LIST_FLAG를 사용합니다.

저장해두기cst_id02 거래내역 조회custKey02 거래내역 조회AuthKey02 거래내역 조회
POST테스트https://democpay.payple.kr/php/auth.php
POST라이브https://cpay.payple.kr/php/auth.php

한 번의 파트너 인증 후 30분의 유효 시간 동안 조회 요청을 해야 합니다.
거래내역 조회는 1초에 1회, 2분당 20회를 초과하는 요청은 거부됩니다.
거래내역 조회 요청 시 요구되는 파트너 인증에 필요한 Request 파라미터는 아래와 같습니다.

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

02거래내역 조회

server

다건 결과조회 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를 요청해주세요.

주의
  • 조회 기간 내에 취소가 발생한 결제건은, 결제일이 기간 밖이더라도 응답에 포함됩니다.
    예) 4/25 결제건이 5/1에 환불 처리되었다면, 5/1 조회 시 이 건은 응답에 포함됩니다.
  • 응답 본문(PCD_CONTENT[i])의 결제 정보(금액, 상품명, 카드/계좌 정보 등)는 원결제 기준이며, 조회 기간 내 발생한 거래는 PCD_TRANSACTIONS 배열로 별도 제공됩니다.
  • PCD_LASTKEY는 EVENT_DATE 모드 전용 커서로, PAY_DATE 요청에는 사용할 수 없습니다.
받아서 넣기PCD_CST_ID01 파트너 인증 요청PCD_CUST_KEY01 파트너 인증 요청PCD_AUTH_KEY01 파트너 인증 요청
POST테스트https://democpay.payple.kr/php/PayChkActList.php
POST라이브https://cpay.payple.kr/php/PayChkActList.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_PAYCHK_LIST_FLAG필수String
1		거래내역 조회 요청을 위한 파라미터입니다. 다건 결과조회와 동일한 플래그를 사용합니다.Y
PCD_START_DATE필수String
8		조회 시작일입니다. YYYYMMDD 형식으로 전송합니다. PCD_END_DATE와의 조회 날짜 범위는 최대 1년입니다.20260501
PCD_END_DATE필수String
8		조회 종료일입니다. YYYYMMDD 형식으로 전송합니다. PCD_START_DATE와의 조회 날짜 범위는 최대 1년입니다.20260501
PCD_PAY_TYPE필수String
10		결제수단입니다.card : 카드결제 / transfer : 계좌결제card
PCD_DATE_TYPE필수String
10		거래내역 조회를 위해 반드시 EVENT_DATE를 전송해야 합니다.
PAY_DATE 모드는 국내 카드 > 결과조회 또는 국내 계좌 > 결과조회의 다건 조회를 사용합니다.EVENT_DATE : 기간 내 발생한 승인/취소 거래 발생일시 기준		EVENT_DATE
PCD_PAY_OIDString
64		특정 원거래 주문번호로 조회 결과를 필터링합니다.
전송 시 해당 주문번호의 거래내역만 조회되며, 미전송 시 조회 기간 내 전체 거래를 조회합니다.		order12345
PCD_LIMITNumber조회 건수 제한 값입니다. 미전송 시 기본값은 100이며, 최소 1부터 최대 1000까지 설정할 수 있습니다.
(EVENT_DATE 모드 전용 상한)		1000
PCD_LASTKEYString
255		첫 요청에서는 생략합니다.
응답의 PCD_DATA.PCD_HAS_MORE가 true인 경우 반환된 PCD_DATA.PCD_LASTKEY를 다음 요청에 전송합니다.
EVENT_DATE 모드에서 발급된 PCD_LASTKEY는 PAY_DATE 모드 요청에 사용할 수 없습니다.		gmUZOwXKxH64MWh3CsL3xg==
PCD_REGULER_FLAGString
1		월 중복 결제 방지 사용여부 플래그입니다.
Y로 전송 시, 월 중복 결제 방지 결제건만 조회됩니다.		N
결제 연동과 관련된 무엇이든 물어보세요