파라미터
국내 카드〉간편페이 정기(빌링) 결제
1. 결제창 호출
간편페이 정기(빌링) 결제에 필요한 주요 Request 파라미터입니다. 공통 파라미터는 국내 카드 정기(빌링) 결제 파라미터를 함께 확인해주세요.
| 파라미터 | 필수 | 타입 | 길이 | 설명 | 값 예시 |
|---|---|---|---|---|---|
| clientKey | String | 128 | 파트너 인증을 위한 클라이언트키입니다. | test_DF55F29DA654A8CBC0F0A9DD4B556486 | |
| PCD_PAY_TYPE | String | 20 | 결제수단입니다. 간편페이 정기(빌링) 결제는 card로 설정합니다. | card | |
| PCD_PAY_WORK | String | 20 | 카드 인증과 빌링키 발급 절차를 진행하도록 CERT로 설정합니다.
| CERT | |
| PCD_CARD_VER | String | 2 | 빌링 결제방식인 01로 설정합니다. | 01 | |
| PCD_EASYBILL_FLAG | String | 1 | 간편페이 정기(빌링) 결제창을 호출하기 위한 설정값입니다.
| Y | |
| PCD_PAY_GOODS | String | 255 | 상품명입니다. | 테스트 상품 | |
| PCD_PAY_TOTAL | Number | 10 | 총 결제금액입니다. | 1000 | |
| PCD_RST_URL | String | - | 카드 인증 결과가 POST 방식으로 전송되는 URL입니다. | https://result-domain.com | |
| PCD_PAY_METHOD | String | 20 | 발급받을 간편페이 빌링키와 결제창에 표시할 수단을 선택합니다.
| naverPay kakaoPay | |
| PCD_PAYER_NO | Number | 18 | 파트너(상점)에서 관리하는 회원번호입니다. | 1234 |
2. 최초 인증 결과 수신
간편페이 빌링키 인증 결과에서 확인해야 하는 주요 Response 파라미터입니다.
| 파라미터 | 타입 | 설명 | 값 예시 |
|---|---|---|---|
| PCD_PAY_RST | String | 인증 결과입니다.
| success |
| PCD_PAY_CODE | String | 응답 코드입니다. | 0000 |
| PCD_PAY_MSG | String | 응답 메시지입니다. | 카드인증완료 |
| PCD_PAY_WORK | String | 승인 요청 방식 결과입니다. | CERT |
| PCD_CARD_VER | String | 카드 결제수단 중 앱카드, 정기(빌링), 비밀번호 간편결제 방식입니다. | 01 |
| PCD_AUTH_KEY | String | 내부 인증토큰입니다. | K0VnW… |
| PCD_PAY_REQKEY | String | 이후 승인 요청에 필요한 결제 키입니다. | Vnx... |
| PCD_PAY_COFURL | String | 승인 요청 Request URL 입니다.
| https://democpay.payple.kr/php/PayCardConfirmAct.php?ACT_=PAYM |
| PCD_PAY_METHOD | String | 빌링키를 발급한 간편페이 수단입니다.
| naverPay |
| PCD_PAYER_ID | String | 간편페이 정기(빌링) 결제 시 필요한 빌링키입니다.
| OVA3... |
| PCD_PAY_OID | String | 주문번호입니다. 파트너(상점)에서 미전송 시 페이플에서 발급한 주문번호를 응답합니다. | order12345 |
| PCD_PAY_TOTAL | Number | 총 결제금액입니다. | 1000 |
3. 발급을 위한 결제 승인 요청
빌링키 인증 결과로 받은 인증값을 이용해 최초 결제를 승인합니다. 실제 요청 URL은 PCD_PAY_COFURL 응답값을 사용해주세요.
| 파라미터 | 필수 | 타입 | 길이 | 설명 | 값 예시 |
|---|---|---|---|---|---|
| PCD_CST_ID | String | 12 | 파트너 인증을 위한 ID 입니다. 라이브 ID 는 계약이 완료되어야 발급 가능합니다. | test | |
| PCD_CUST_KEY | String | 255 | 파트너 인증을 위한 키입니다. 라이브 키는 계약이 완료되어야 발급 가능합니다.
| abcd1234567890 | |
| PCD_AUTH_KEY | String | - | 인증결과로 수신하는 파트너 인증 키입니다. 파트너 인증 응답으로 받은 값을 그대로 사용해주세요. | K0VnW… | |
| PCD_PAY_REQKEY | String | 255 | 인증결과로 수신하는 결제 키입니다. | Vnx... | |
| PCD_PAYER_ID | String | 255 | 간편페이 정기(빌링) 결제 시 필요한 빌링키입니다. | OVA3… |
발급을 위한 결제 승인이 성공적으로 완료된 후 받게 되는 주요 Response 파라미터입니다.
| 파라미터 | 타입 | 설명 | 값 예시 |
|---|---|---|---|
| PCD_PAY_RST | String | 승인 결과입니다.
| success |
| PCD_PAY_CODE | String | 응답 코드입니다. | PCCF0000 |
| PCD_PAY_MSG | String | 응답 메시지입니다. | 카드결제완료 |
| PCD_PAY_WORK | String | 승인 요청 방식 결과입니다. | CERT |
| PCD_PAY_METHOD | String | 승인에 사용된 간편페이 수단입니다.
| naverPay kakaoPay |
| PCD_PAYER_ID | String | 간편페이 정기(빌링) 결제 시 필요한 빌링키입니다.
| OVA3… |
| PCD_PAY_OID | String | 주문번호입니다. 파트너(상점)에서 미전송 시 페이플에서 발급한 주문번호를 응답합니다. | order12345 |
| PCD_PAY_TOTAL | String | 총 결제금액입니다. | 1000 |
| PCD_PAY_CARDNAME | String | 카드사명입니다. | 삼성카드 |
| PCD_PAY_CARDNUM | String | 카드번호입니다. | 1234-**-**-5678 |
| PCD_PAY_CARDAUTHNO | String | 승인번호입니다. | 85324231 |
| PCD_PAY_CARDRECEIPT | String | 매출 전표(영수증) 출력 URL 입니다. | https://www.danalpay.com/... |
4. 파트너 인증 요청
빌링키 승인 요청 시 요구되는 파트너 인증에 필요한 Request 파라미터는 아래와 같습니다.
| 파라미터 | 필수 | 타입 | 길이 | 설명 | 값 예시 |
|---|---|---|---|---|---|
| cst_id | String | 12 | 파트너 인증을 위한 ID 입니다. 라이브 ID 는 계약이 완료되어야 발급 가능합니다. | test | |
| custKey | String | 255 | 파트너 인증을 위한 키입니다. 라이브 키는 계약이 완료되어야 발급 가능합니다.
| abcd1234567890 | |
| PCD_PAY_TYPE | String | 20 | 결제수단(카드/계좌)입니다.
| card | |
| PCD_SIMPLE_FLAG | String | 1 | 정기(빌링), 비밀번호 간편결제 시 필요한 설정값입니다. | Y |
파트너 인증이 성공적으로 완료된 후에 받게 되는 Response 파라미터는 다음과 같습니다.
| 파라미터 | 타입 | 설명 | 값 예시 |
|---|---|---|---|
| server_name | String | 파트너 인증 서버의 Domain을 반환합니다. | democpay.payple.kr |
| result | String | 인증 결과입니다. | 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/SimplePayAct.php?ACT_=PAYM |
| return_url | String | 파트너 인증 결과로 응답되는 URL 입니다. | https://democpay.payple.kr/php/SimplePayAct.php?ACT_=PAYM |
5. 빌링키로 재결제
실결제 승인 과정에서 필요한 Request 파라미터는 다음과 같습니다.
| 파라미터 | 필수 | 타입 | 길이 | 설명 | 값 예시 |
|---|---|---|---|---|---|
| PCD_CST_ID | String | 255 | 파트너 인증을 위한 ID 입니다. | UFVNNVZ… | |
| PCD_CUST_KEY | String | 255 | 파트너 인증 후 수신한 키입니다. | T3JzRkp5L… | |
| PCD_AUTH_KEY | String | - | 인증완료 후 수신하는 파트너 인증 키입니다. 파트너 인증 응답으로 받은 값을 그대로 사용해주세요. | K0VnW… | |
| PCD_PAY_TYPE | String | 20 | 카드 결제수단 중 앱카드, 정기(빌링), 비밀번호 간편결제 방식을 선택합니다.
| card | |
| PCD_PAYER_ID | String | 255 | 간편페이 정기(빌링) 결제 시 필요한 빌링키입니다.
| OVA3… | |
| PCD_PAY_GOODS | String | 255 | 상품명입니다. Emoji 또는 허용되지 않은 특수문자(& ' " \ < > | \n \r\n , +)만으로 구성된 값은 입력할 수 없습니다. | 테스트 상품 | |
| PCD_SIMPLE_FLAG | String | 1 | 정기(빌링) 결제 시 필요한 설정값입니다. | Y | |
| PCD_PAY_TOTAL | Number | 10 | 총 결제금액입니다. | 1000 | |
| PCD_PAY_METHOD | String | 20 | 사용할 간편페이 수단을 명시하려는 경우 선택적으로 전송합니다. 미전송 시 PCD_PAYER_ID에 연결된 간편페이 수단으로 처리됩니다.
| naverPay kakaoPay | |
| PCD_PAY_OID | String | 64 | 승인 요청 건의 주문번호로 파트너(상점)에서 생성한 거래의 고유 식별번호입니다. 중복되지 않는 고유한 값을 발급해야 하며, 미전송 시 페이플에서 발급한 주문번호를 응답합니다. 한글은 사용할 수 없으며 영문, 숫자, 특수문자(-, _, .)만 사용 가능합니다. | order12345 | |
| PCD_PAYER_NO | Number | 18 | 파트너(상점)에서 이용하는 회원번호입니다. | 1234 | |
| PCD_PAYER_NAME | String | 80 | 구매자 이름입니다. Emoji 또는 허용되지 않은 특수문자(& ' " \ < > | \n \r\n , +)만으로 구성된 값은 입력할 수 없습니다. | 김이플 | |
| PCD_PAYER_HP | String | 15 | 구매자 휴대폰번호입니다. 구매자에게 결제된 상점정보를 알림톡으로 발송합니다. | 01012345678 | |
| PCD_PAYER_EMAIL | String | 100 | 구매자 이메일입니다. 결제완료, 취소 메일이 발송됩니다. | complete@payer-email.com | |
| PCD_PAY_ISTAX | String | 1 | 과세 여부입니다. 기본값은 Y 이며, 유형별로 아래와 같이 설정해주세요.
| Y | |
| PCD_PAY_TAXTOTAL | Number | 9 | 복합과세 주문 시에만 이용하며, 복합과세 주문의 부가세를 설정합니다.
| 500 | |
| PCD_USER_DEFINE1 | String | 2048 | 파트너(상점)에서 입력한 값을 그대로 응답합니다. | define1 | |
| PCD_USER_DEFINE2 | String | 2048 | 파트너(상점)에서 입력한 값을 그대로 응답합니다. | define2 |
빌링키 승인이 성공적으로 완료된 후에 받게 되는 Response 파라미터는 다음과 같습니다.
| 파라미터 | 타입 | 설명 | 값 예시 |
|---|---|---|---|
| PCD_PAY_RST | String | 승인 결과입니다.
| success |
| PCD_PAY_CODE | String | 응답 코드입니다. | SPCD0000 |
| PCD_PAY_MSG | String | 응답 메시지입니다. | 카드결제완료 |
| PCD_PAY_OID | String | 주문번호입니다. 파트너(상점)에서 미전송 시 페이플에서 발급한 주문번호를 응답합니다. | order12345 |
| PCD_PAY_TYPE | String | 결제수단(카드/계좌)입니다. | card |
| 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_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_USER_DEFINE1 | String | 파트너(상점)에서 입력한 값을 그대로 응답합니다. | define1 |
| PCD_USER_DEFINE2 | String | 파트너(상점)에서 입력한 값을 그대로 응답합니다. | define2 |