거래내역 조회
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_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 는 계약이 완료되어야 발급 가능합니다.발급받은 cst_id
custKey필수String
255
파트너 인증을 위한 키입니다. 라이브 키는 계약이 완료되어야 발급 가능합니다.외부에 노출되면 안되는 정보입니다. 보안에 유의해주세요.발급받은 custKey
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
결제 연동과 관련된 무엇이든 물어보세요