파라미터

국내 카드〉비밀번호 간편결제

1. 결제창 호출

아래는 결제창 호출 시 사용 가능한 Request 파라미터 목록입니다.

파라미터	필수	타입	길이	설명	값 예시
clientKey		String	128	파트너 인증을 위한 클라이언트키입니다. 라이브 클라이언트키는 계약 완료 후 발급가능합니다.	test_DF55F29DA654A8CBC0F0A9DD4B556486
PCD_PAY_TYPE		String	20	결제수단(카드/계좌)을 선택합니다. 카드 : card / 계좌: transfer	card
PCD_PAY_WORK		String	20	승인 요청 방식이며 비밀번호 간편결제는 카드등록과 동시에 결제가 진행되므로 CERT 로 설정합니다.	CERT
PCD_CARD_VER		String	2	카드 결제수단 중 앱카드, 정기(빌링), 비밀번호 간편결제 방식을 선택합니다. 정기(빌링) / 비밀번호 간편결제 : 01 앱카드 : 02	01
PCD_SIMPLE_FLAG		String	1	비밀번호 간편결제 이용을 위한 설정값입니다.	Y
PCD_PAYER_AUTH TYPE		String	3	비밀번호 이용을 위한 설정값입니다.	pwd
PCD_PAY_GOODS		String	255	상품명입니다.	테스트 상품
PCD_PAY_TOTAL		Number	10	총 결제금액입니다.	1000
PCD_RST_URL		String	-	결제 정보가 성공적으로 입력된 경우, 인증 결과가 POST 방식으로 전송됩니다. 경로지정 방식에 따라 결제창이 다르게 띄워집니다.	https://result-domain.com
PCD_PAYER_ID	재결제 시	String	255	재결제 시 필요한 빌링키입니다. 첫결제 시에는 사용하지 않습니다.	OVA3…
PCD_PAY_OID		String	255	주문번호입니다. 파트너(상점)에서 생성한 거래에 대한 고유식별번호입니다. 중복되지 않는 고유한 값을 발급해야하며, 미전송 시 페이플에서 발급한 주문번호를 응답합니다.	order12345
PCD_PAYER_NO		Number	20	파트너(상점)에서 이용하는 회원번호입니다.	1234
PCD_PAYER_NAME		String	80	구매자 이름입니다.	김이플
PCD_PAYER_HP		String	20	구매자 휴대폰번호입니다. 구매자에게 결제된 상점정보를 알림톡으로 발송합니다.	01012345678
PCD_PAYER_EMAIL		String	100	구매자 이메일입니다. 결제완료, 취소 메일이 발송됩니다.	complete@payer-email.com
PCD_PAY_ISTAX		String	1	과세 여부입니다. 기본값은 Y 이며, 유형별로 아래와 같이 설정해주세요. 과세, 복합과세 : Y 비과세 : N	Y
PCD_PAY_TAXTOTAL		Number	9	복합과세 주문 시에만 이용하며, 복합과세 주문의 부가세를 설정합니다. 예 : 총 결제금액(PCD_PAY_TOTAL) 10,000원 중 복합과세 주문의 부가세가 500원이면 500으로 설정	500
callbackFunction		-	-	클라이언트단에서 결과수신이 필요할 경우 사용합니다. callbackFunction을 사용해도 PCD_RST_URL은 필수로 입력되어야 합니다.	getResult
PCD_USER_DEFINE1		String	2048	파트너(상점)에서 입력한 값을 그대로 응답합니다. 단, 특수문자는 공백처리 합니다.	define1
PCD_USER_DEFINE2		String	2048	파트너(상점)에서 입력한 값을 그대로 응답합니다. 단, 특수문자는 공백처리 합니다.	define2

2. 인증결과 수신

인증이 성공적으로 완료된 경우, 수신되는 Response 파라미터는 다음과 같습니다.

파라미터	타입	설명	값 예시
PCD_PAY_RST	String	인증 결과입니다. success : 성공 / error : 실패 / close : 구매자가 결제 완료 전 결제창 종료	success
PCD_PAY_CODE	String	응답 코드입니다.	0000
PCD_PAY_MSG	String	응답 메시지입니다.	카드인증완료
PCD_PAY_TYPE	String	결제수단(카드/계좌)입니다.	card
PCD_CARD_VER	String	카드 결제수단 중 앱카드, 정기(빌링), 비밀번호 간편결제 방식입니다.	01
PCD_PAY_WORK	String	승인 요청 방식 결과입니다.	CERT
PCD_AUTH_KEY	String	이후 승인 요청에 필요한 파트너 인증 키입니다.	K0VnW…
PCD_PAY_REQKEY	String	이후 승인 요청에 필요한 결제 키입니다.	Vnx...
PCD_PAY_HOST	String	페이플 접속 주소입니다.	https://democpay.payple.kr
PCD_PAY_URL	String	(현재는 이용하지 않는) 파트너 인증 결과입니다.
PCD_PAY_COFURL	String	승인 요청 Request URL 입니다.	https://democpay.payple.kr/php/PayCardConfirmAct.php?ACT_=PAYM
PCD_PAYER_ID	String	정기(빌링), 비밀번호 간편결제 시 필요한 빌링키입니다.	OVA3…
PCD_PAYER_NO	String	파트너(상점)에서 이용하는 회원번호입니다.	1234
PCD_PAYER_NAME	String	구매자 이름입니다.	김이플
PCD_PAYER_HP	String	구매자 휴대폰번호입니다.	01012345678
PCD_PAYER_EMAIL	String	구매자 이메일입니다.	complete@payer-email.com
PCD_PAY_OID	String	주문번호입니다. 파트너(상점)에서 미전송 시 페이플에서 발급한 주문번호를 응답합니다.	order12345
PCD_PAY_GOODS	String	상품명입니다.	테스트 상품
PCD_PAY_TOTAL	String	총 결제금액입니다.	1000
PCD_PAY_TAXTOTAL	String	복합과세 부가세입니다.	500
PCD_PAY_ISTAX	String	과세 여부입니다.	Y
PCD_PAY_CARDNAME	String	카드사명입니다	삼성카드
PCD_PAY_CARDNUM	String	카드번호입니다.	1234-**-**-5678
PCD_PAY_CARDQUOTA	String	할부 개월수입니다.
PCD_PAY_CARDTRADENUM	String	해당 거래의 고유한 키입니다.
PCD_PAY_CARDAUTHNO	String	승인번호입니다.
PCD_PAY_CARDRECEIPT	String	매출 전표(영수증) 출력 URL 입니다.
PCD_PAY_TIME	String	결제를 요청한 시간입니다.	20231219134223
PCD_REGULER_FLAG	String	월 중복방지 거래 설정 여부입니다.	N
PCD_PAY_YEAR	String	월 중복방지 거래 - 년(Year)	2023
PCD_PAY_MONTH	String	월 중복방지 거래 - 월(Month)	12
PCD_SIMPLE_FLAG	String	정기(빌링), 비밀번호 간편결제 시 필요한 설정값입니다.	N
PCD_RST_URL	String	결제 정보가 성공적으로 입력된 경우, 인증 결과가 POST 방식으로 전송됩니다. 경로지정 방식에 따라 결제창이 다르게 띄워집니다.	https://result-domain.com
PCD_PAY_AMOUNT	String	(현재는 이용하지 않는) 총 결제금액입니다.
PCD_PAY_DISCOUNT	String	(현재는 이용하지 않는) 할인금액입니다.
PCD_PAY_AMOUNT_REAL	String	(현재는 이용하지 않는) 총 결제금액 - 할인금액입니다.
PCD_USER_DEFINE1	String	파트너(상점)에서 입력한 값을 그대로 응답합니다. 단, 특수문자는 공백처리 합니다.	define1
PCD_USER_DEFINE2	String	파트너(상점)에서 입력한 값을 그대로 응답합니다. 단, 특수문자는 공백처리 합니다.	define2

3. API로 승인 요청

실결제 승인 과정에서 필요한 Request 파라미터는 다음과 같습니다.

파라미터	타입	길이	설명	값 예시
PCD_CST_ID	String	12	파트너 인증을 위한 ID 입니다. 라이브 ID 는 계약이 완료되어야 발급 가능합니다.	test
PCD_CUST_KEY	String	255	파트너 인증을 위한 키입니다. 라이브 키는 계약이 완료되어야 발급 가능합니다. 외부에 노출되면 안되는 정보입니다. 보안에 유의해주세요.	abcd1234567890
PCD_PAY_TYPE	String	255	인증결과로 수신하는 파트너 인증 키입니다.	K0VnW…
PCD_PAY_REQKEY	String	255	인증결과로 수신하는 결제 키입니다.	Vnx...
PCD_PAYER_ID	String	255	정기(빌링), 비밀번호 간편결제 시 필요한 설정값입니다.	OVA3…

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

파라미터	타입	설명	값 예시
PCD_PAY_RST	String	승인 결과입니다. success : 성공 / erro r: 실패	success
PCD_PAY_CODE	String	응답코드입니다.	0000
PCD_PAY_MSG	String	응답 메시지입니다.	카드결제완료
PCD_PAY_TYPE	String	결제수단(카드/계좌)입니다. 카드 : card / 계좌: transfer	card
PCD_PAY_WORK	String	승인 요청 방식 결과입니다.	CERT
PCD_CARD_VER	String	카드 결제수단 중 앱카드, 정기(빌링), 비밀번호 간편결제 방식입니다.	01
PCD_AUTH_KEY	String	인증결과로 수신하는 파트너 인증 키입니다.	K0VnW…
PCD_PAY_REQKEY	String	승인 요청을 위한 결제 키입니다.	Vnx...
PCD_PAY_OID	String	주문번호입니다. 파트너(상점)에서 미전송 시 페이플에서 발급한 주문번호를 응답합니다.	order12345
PCD_PAYER_ID	String	정기(빌링), 비밀번호 간편결제 시 필요한 빌링키입니다. 앱카드 결제(PCD_CARD_VER = ‘02’)인 경우, 빌링키는 반환되지 않습니다.	OVA3…
PCD_PAYER_NO	String	파트너(상점)에서 이용하는 회원번호입니다.	1234
PCD_PAYER_NAME	String	구매자 이름입니다.	김이플
PCD_PAYER_HP	String	구매자 휴대폰번호입니다.	01012345678
PCD_PAYER_EMAIL	String	구매자 이메일입니다.	complete@payer-email.com
PCD_PAY_GOODS	String	상품명입니다.	테스트 상품
PCD_PAY_TOTAL	String	총 결제금액입니다.	1000
PCD_PAY_TAXTOTAL	String	복합과세 부가세입니다.	500
PCD_PAY_ISTAX	String	과세 여부입니다.	Y
PCD_PAY_TIME	String	결제를 요청한 시간입니다.	20231219134223
PCD_PAY_CARDNAME	String	카드사명입니다	삼성카드
PCD_PAY_CARDNUM	String	카드번호입니다.	1234-**-**-5678
PCD_PAY_CARDTRADENUM	String	해당 거래의 고유한 키입니다.	202312191342223302115099
PCD_PAY_CARDAUTHNO	String	승인번호입니다.	85324231
PCD_PAY_CARDRECEIPT	String	매출 전표(영수증) 출력 URL 입니다.	https://www.danalpay.com/...
PCD_SIMPLE_FLAG	String	정기(빌링), 비밀번호 간편결제 시 필요한 설정값입니다.	Y
PCD_REGULER_FLAG	String	월 중복방지 거래 설정 여부입니다.	N
PCD_PAY_YEAR	String	월 중복방지 거래 - 년(Year)	2023
PCD_PAY_MONTH	String	월 중복방지 거래 - 월(Month)	12
PCD_RST_URL	String	결제 정보가 성공적으로 입력된 경우, 인증 결과가 POST 방식으로 전송됩니다. 경로지정 방식에 따라 결제창이 다르게 띄워집니다. 승인 요청 시 빈값으로 응답됩니다.
PCD_USER_DEFINE1	String	파트너(상점)에서 입력한 값을 그대로 응답합니다. 단, 특수문자는 공백처리 합니다.	define1
PCD_USER_DEFINE2	String	파트너(상점)에서 입력한 값을 그대로 응답합니다. 단, 특수문자는 공백처리 합니다.	define2