거래내역 조회
국내 거래내역 조회 API는 페이플 파트너사가 국내 카드·계좌 결제의 승인/취소 거래 이력을 발생일시 기준으로 조회하고, 내부 거래 데이터와 대사할 수 있도록 제공하는 API입니다.
실시간 거래 상태 조회는 국내 카드 > 결과조회 또는 국내 계좌 > 결과조회의 단건 조회를 사용하세요.
한 번의 파트너 인증 후 30분의 유효 시간 동안 조회 요청을 해야 합니다.
거래내역 조회는 1초에 1회, 2분당 20회를 초과하는 요청은 거부됩니다.
00연동 준비
페이플 가입 계약 심사가 완료되면 테스트 계정이 발급되며, 발급받은 테스트 계정으로 연동을 체험할 수 있습니다.
https://democpay.payple.kr발급받은 cst_id발급받은 custKey01파트너 인증 요청
serverHeader 설정 후 API를 요청해주세요.
거래내역 조회 인증/요청에는 다건 결과조회와 동일하게 PCD_PAYCHK_LIST_FLAG를 사용합니다.
cst_id02 거래내역 조회custKey02 거래내역 조회AuthKey02 거래내역 조회https://democpay.payple.kr/php/auth.phphttps://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 파트너 인증 요청https://democpay.payple.kr/php/PayChkActList.phphttps://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_OID | String 64 | 특정 원거래 주문번호로 조회 결과를 필터링합니다. 전송 시 해당 주문번호의 거래내역만 조회되며, 미전송 시 조회 기간 내 전체 거래를 조회합니다. | order12345 |
| PCD_LIMIT | Number | 조회 건수 제한 값입니다. 미전송 시 기본값은 100이며, 최소 1부터 최대 1000까지 설정할 수 있습니다. ( EVENT_DATE 모드 전용 상한) | 1000 |
| PCD_LASTKEY | String 255 | 첫 요청에서는 생략합니다. 응답의 PCD_DATA.PCD_HAS_MORE가 true인 경우 반환된 PCD_DATA.PCD_LASTKEY를 다음 요청에 전송합니다.EVENT_DATE 모드에서 발급된 PCD_LASTKEY는 PAY_DATE 모드 요청에 사용할 수 없습니다. | gmUZOwXKxH64MWh3CsL3xg== |
| PCD_REGULER_FLAG | String 1 | 월 중복 결제 방지 사용여부 플래그입니다. Y로 전송 시, 월 중복 결제 방지 결제건만 조회됩니다. | N |