파라미터

대사〉국내 정산

1. 파트너 인증 요청

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

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

파트너 인증이 성공적으로 완료된 후에 받게 되는 Response 파라미터는 다음과 같습니다.

파라미터	타입	설명	값 예시
server_name	String	파트너 인증 서버의 Domain을 반환합니다.	democpay.payple.kr
result	String	응답 코드입니다. success : 성공 / error : 실패	success
result_msg	String	응답 메시지입니다.	사용자 인증 완료!!
cst_id	String	파트너 ID 입니다. 매 인증 시 변동되는 값입니다.	UFVNNVZ…
custKey	String	파트너 키입니다. 매 인증 시 변동되는 값입니다.	T3JzRkp5L…
AuthKey	String	파트너 인증 키입니다. 매 인증 시 변동되는 값입니다.	a688ccb3555...
PCD_PAY_HOST	String	페이플 접속 주소입니다.	https://democpay.payple.kr
PCD_PAY_URL	String	파트너 인증 결과로 응답되는 URL Path 입니다.	/php/SettlementAct.php
return_url	String	파트너 인증 결과로 응답되는 URL 입니다.	https://democpay.payple.kr/php/SettlementAct.php

2. 정산내역 조회

파트너 인증 후 정산내역 조회 요청 시 필요한 Request 파라미터는 아래와 같습니다. 정산일(PCD_SETTLE_DATE)이 당일인 데이터는 당일 오전 07:00부터 조회할 수 있습니다. 조회 기간(PCD_START_DATE~PCD_END_DATE)은 최대 31일까지 지정할 수 있습니다. 정산내역 조회는 1초에 1회, 2분당 20회를 초과하는 요청은 거부됩니다.

파라미터	타입	길이	설명	값 예시
PCD_CST_ID	String	255	파트너 인증 후 수신한 ID입니다.	UFVNNVZ…
PCD_CUST_KEY	String	255	파트너 인증 후 수신한 키입니다.	T3JzRkp5L…
PCD_AUTH_KEY	String	255	파트너 인증 후 수신한 인증 키입니다.	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

정산내역 조회 요청이 성공적으로 완료된 후에 받게 되는 Response 파라미터는 다음과 같습니다.

파라미터	타입	설명	값 예시
PCD_PAY_RST	String	응답 결과입니다. success : 성공 error : 실패	success
PCD_PAY_CODE	String	응답 코드입니다. 성공 시 PSTL0000 실패 시 PSTL* 등 오류 코드	PSTL0000
PCD_PAY_MSG	String	응답 메시지입니다.	success
PCD_DATA	Object	정산내역 조회 결과 데이터입니다.
PCD_CONTENT	Object[]	조회된 정산 거래 단건 목록입니다. 거래가 없으면 빈 배열입니다.
PCD_TXN_TYPE	String	거래 구분입니다. APPROVAL : 승인 CANCEL : 취소	APPROVAL
PCD_PAY_OID	String	결제 요청 시 전달한 주문번호입니다. 결제 승인 및 취소 시 동일한 값입니다.	ORDER-A-003
PCD_PAY_TIME	String	원결제 승인 시각입니다. 형식: yyyy-MM-dd HH:mm:ss (KST)	2026-05-17 20:30:00
PCD_PAY_CANCEL_TIME	String	취소 시각입니다. 결제 승인 거래는 null 취소 거래는 yyyy-MM-dd HH:mm:ss	2026-05-17 15:00:00
PCD_SETTLE_DATE	String	정산일입니다. 형식: yyyy-MM-dd	2026-05-18
PCD_PAY_TYPE	String	결제 수단입니다. 응답은 소문자로 제공됩니다. card : 카드 결제 (카드 빌링 결제 포함) easypay : 간편페이 (네이버페이, 카카오페이) transfer : 계좌이체	card
PCD_PAYER_NAME	String	구매자명입니다.	홍길동
PCD_PAY_GOODS	String	상품명입니다.	테스트 상품
PCD_PAY_AMOUNT	Number	거래 금액입니다.	39000
PCD_FEE_SUPPLY	Number	거래 수수료 공급가입니다. 취소 시 결제 수단에 따라 부호가 달라집니다. CARD / EASYPAY : 음수 TRANSFER : 양수	1131
PCD_FEE_VAT	Number	거래 수수료 VAT입니다. 취소 시 결제 수단에 따라 부호가 달라집니다. CARD / EASYPAY : 음수 TRANSFER : 양수	113
PCD_FEE_TOTAL	Number	거래 수수료 합계입니다. PCD_FEE_TOTAL = PCD_FEE_SUPPLY + PCD_FEE_VAT (부호 반영 후)	1244
PCD_SETTLE_AMOUNT	Number	정산 금액입니다. 부호는 거래 구분에 따라 자동 반영됩니다. APPROVAL = PCD_PAY_AMOUNT − PCD_FEE_TOTAL (양수) CANCEL = −(PCD_PAY_AMOUNT + PCD_FEE_TOTAL) (음수)	37756
PCD_HAS_MORE	Boolean	다음 페이지 존재 여부입니다. PCD_LASTKEY 가 null 이 아니면 true 입니다.	true
PCD_LASTKEY	String	다음 페이지 커서입니다. 마지막 페이지면 null 입니다.	eyJhcHByb3ZlZEF0IjoiMjAyNi0wNC0yMFQxMDowMDowMCJ9
PCD_PAGE_TOTALS	Object	현재 페이지 응답의 합산입니다.
PCD_TOTAL_COUNT	Number	현재 페이지 거래 수 합계입니다.	5
PCD_TOTAL_APPROVAL_AMOUNT	Number	현재 페이지 승인 금액 합계입니다.	159000
PCD_TOTAL_CANCEL_AMOUNT	Number	현재 페이지 취소/부분취소 금액 합계입니다.	70000
PCD_TOTAL_FEE_AMOUNT	Number	현재 페이지 순 수수료 합계입니다. 부호 반영 후 합계입니다. ※ 수수료 절삭 정책으로 인해 거래 건별 PCD_FEE_TOTAL 단순 합과 ±N원 차이가 날 수 있습니다.	2234
PCD_TOTAL_SETTLE_AMOUNT	Number	현재 페이지 정산 금액 합계입니다. PCD_TOTAL_SETTLE_AMOUNT = PCD_TOTAL_APPROVAL_AMOUNT − PCD_TOTAL_CANCEL_AMOUNT − PCD_TOTAL_FEE_AMOUNT ※ 수수료 절삭 정책으로 인해 거래 건별 합과 ±N원 차이가 날 수 있습니다. 정확한 합계가 필요한 경우 첫 페이지(PCD_LASTKEY 생략)부터 PCD_HAS_MORE=false까지 순차 호출 후 토탈을 합산해주세요.	86766