kcp v2 연동 가이드 초안

src/content/docs/ko/_nav.yaml

@@ -265,11 +265,12 @@
     - slug: /ko/v2-payment/pg/readme
       items:
         - /ko/v2-payment/pg/nice-v2
-        - /ko/v2-payment/pg/inicis-v2
-        - /ko/v2-payment/pg/tosspayments
-        - /ko/v2-payment/pg/ksnet
         - /ko/v2-payment/pg/smartro-v2
+        - /ko/v2-payment/pg/tosspayments
         - /ko/v2-payment/pg/kpn
+        - /ko/v2-payment/pg/inicis-v2
+        - /ko/v2-payment/pg/ksnet
+        - /ko/v2-payment/pg/kcp-v2
         - /ko/v2-payment/pg/kakaopay
         - /ko/v2-payment/pg/naverpay
         - /ko/v2-payment/pg/paypal-v2

src/content/docs/ko/ready/_components/integration-guide/kcp-v2.mdx

@@ -0,0 +1,76 @@
+import Figure from '~/components/Figure.astro';
+import Hint from "~/components/Hint.astro";
+import * as prose from '~/components/prose';
+
+import image1 from "./assets/kcp-v2.png";
+import image2 from "./assets/kcp-v2-1.png";
+import image3 from "./assets/kcp-v2-2.png";
+import image4 from "./assets/kcp-v2-3.png";
+import image5 from "./assets/kcp4.png";
+import image6 from "./assets/kcp5.png";
+
+export const components = prose;
+
+<Hint style="danger">
+
+  포트원 V2에서 제공하는 KCP의 경우 **KCP의 PG-API방식**만 지원합니다. 따라서 아래와 같이 인증서 발급 후
+  사용할 수 있습니다.
+
+  해당 인증서의 경우 유효기간은 <mark style="color:red;">**5년**</mark>이며, 유효기간 만료 30일전부터 갱신이 가능합니다.
+
+  **서비스 인증서의 유효기간이 만료되거나 폐기된 경우** 즉시 결제 승인/취소 등 관련
+  <mark style="color:red;">**서비스 이용이 불가능**</mark>하오니
+  서비스 사용을 위해서 인증서를 재발급이 필요한 후 **포트원에 저장된 채널 정보를 업데이트** 해야 합니다.
+</Hint>
+
+1. [KCP 파트너관리자](https://partner.kcp.co.kr/) 접속 후 로그인을 합니다.
+2. \[고객센터]→\[인증센터]→\[KCP PG-API]를 클릭합니다.
+
+<Figure src={image1} caption="NHN KCP 파트너관리자 내 [고객센터] - [PG-API 인증서] 예시 화면" />
+
+3. KCP PG-API 발급 버튼을 클릭합니다.
+4. 파트너 관리자 비밀번호(로그인시 입력한 비밀번호)를 입력한 후 다음을 클릭합니다.
+
+<Figure src={image2} caption="[PG-API 인증서] 발급시 [파트너 관리자 비밀번호 입력] 화면" />
+
+5. 사용할 개인키 비밀번호를 입력한 후 다음을 클릭합니다.
+
+   - 개인키 비밀번호를 분실하신 경우 확인이 불가함으로 폐기 후 재발급해야 합니다.
+
+   - 개인키를 폐기하는 즉시 기존에 사용하던 개인키와 서비스 인증서 사용이 불가능하며,
+     결제 승인/취소/조회가 불가능하오니 잘 보관하시길 바랍니다.
+
+<Figure src={image3} caption="[PG-API 인증서] 발급시 [개인키 비밀번호 등록] 화면" />
+
+6. KCP PG-API 개인키 및 서비스 인증서 발급이 완료되면 로컬에 .zip 파일이 다운로드 됩니다.
+
+- 서비스 인증서의 유효기간은 발급일로부터 5년으로, 유효기간 만료 30일전부터 갱신이 가능합니다.
+- 서비스 인증서의 유효기간이 만료되었거나 폐기한 경우 원활한 서비스 사용을 위해 인증서를 재발급해주세요.
+
+<Figure src={image4} caption="[PG-API 인증서] 발급 완료 화면" />
+
+7. 로컬내에서 압축 풀면 `KCP_AUTH_{$사이트코드}_CERT.pem` 파일과 `KCP_AUTH_{$사이트코드}_PRIKEY.pem` 파일을 확인할 수 있습니다.
+
+8. 포트원 콘솔에서 채널 추가 시 \[MID(사이트코드)], \[PG-API 인증서키], \[PG-API 개인키], \[개인키 비밀번호]를
+   입력한 후 저장을 클릭합니다.
+
+9. 정기결제를 이용하시는 경우, 아래 절차를 진행해주세요.
+
+   <div class="[&_li]:list-latin">
+     1. [KCP 파트너관리자](https://partner.kcp.co.kr/) 접속 후 로그인을 합니다.
+     2. \[결제관리]→\[정기자동결제 그룹관리]→\[그룹등록]을 클릭합니다.
+     3. \[상점정보]→\[사이트코드]에서 그룹등록할 사이트코드를 선택합니다.
+     4. \[그룹정보]에서 \[유형3]을 선택한 후 원하는 그룹명을 입력합니다.
+     5. \[결제입력 정보]에서 \[결제유형] 및 \[납부유형]을 확인하시고 고객사 유형에 맞게 선택합니다.
+     6. \[고지방법]에서 원하시는 고지 방법을 선택한 후 \[등록하기]를 클릭합니다.
+
+     <Figure src={image5} caption="KCP 파트너관리자 내 관리용 그룹등록 화면" />
+
+     7. \[결제관리]→\[정기자동결제 그룹관리]→\[그룹조회]를 클릭합니다.
+     8. \[사이트코드]에서 사용한 사이트코드를 선택한 후 \[검색]을 클릭합니다.
+
+     <Figure src={image6} caption="KCP 파트너관리자 내 관리용 그룹조회 화면" />
+
+     9. 포트원 콘솔에서 채널 추가 시 앞서 발급한  \[MID(사이트코드)], \[PG-API 인증서키], \[PG-API 개인키],
+        \[개인키 비밀번호], \[정기자동결제 그룹아이디]를 입력한 후 \[저장]을 클릭합니다.
+   </div>

src/content/docs/ko/ready/readme.mdx

@@ -45,6 +45,7 @@ import image10 from "./_assets/pg/welcome1.png";
 import image2 from "./_assets/signup.png";
 import storeid from "./_assets/storeid.png";
 import IntegrationInicis from './_components/integration-guide/inicis.mdx';
+import IntegrationKcpV2 from "./_components/integration-guide/kcp-v2.mdx";
 import IntegrationPaypalV2 from './_components/integration-guide/paypal-v2.mdx';
 import IntegrationTosspayments from './_components/integration-guide/tosspayments.mdx';
 
@@ -391,43 +392,42 @@ import IntegrationTosspayments from './_components/integration-guide/tosspayment
     포트원 콘솔에서 채널 추가 시 계약 완료 후 한국결제네트웍스(KPN)로부터 전달받은 \[상점아이디(MID)] 및 \[Secret OTP]를 입력한 후 `저장`을 클릭합니다.
   </Details>
 
-  <VersionGate default="v1">
-    <Details id="channel-config-kcp">
-      <p slot="summary">NHN KCP</p>
+  <Details id="channel-config-kcp">
+    <p slot="summary">NHN KCP</p>
 
-      <Tabs>
+    <VersionGate>
+      <Tabs slot="v1">
         <Tab title="결제창 일반/수기결제 및 API 수기/정기결제">
           1. 포트원 콘솔에서 채널 추가 시 계약 완료 후 KCP로부터 전달받은 사이트코드 및 사이트키를 입력한 후 `저장`을 클릭합니다.
-
           2. 정기결제를 이용하시는 경우, 아래 절차를 진행해주세요.
 
-             <div class="[&_li]:list-latin">
-               1. [KCP 파트너관리자](https://partner.kcp.co.kr/) 접속 후 로그인을 합니다.
-               2. \[고객센터]→\[인증센터]→\[관리용 사설인증서]→\[인증서 발급]을 클릭합니다.
+          <div class="[&_li]:list-latin">
+            1. [KCP 파트너관리자](https://partner.kcp.co.kr/) 접속 후 로그인을 합니다.
+            2. \[고객센터]→\[인증센터]→\[관리용 사설인증서]→\[인증서 발급]을 클릭합니다.
 
-               <Figure src={image16} caption="KCP 파트너관리자 내 관리용 사설인증서 발급 화면 1" />
+            <Figure src={image16} caption="KCP 파트너관리자 내 관리용 사설인증서 발급 화면 1" />
 
-               3. 사용자명, 인증서 비밀번호를 입력한 후 \[다음]을 눌러 인증서를 발급합니다.
+            3. 사용자명, 인증서 비밀번호를 입력한 후 \[다음]을 눌러 인증서를 발급합니다.
 
-               <Figure src={image17} caption="KCP 파트너관리자 내 관리용 사설인증서 발급 화면 2" />
+            <Figure src={image17} caption="KCP 파트너관리자 내 관리용 사설인증서 발급 화면 2" />
 
-               <Figure src={image18} caption="KCP 파트너관리자 내 관리용 사설인증서 발급 완료 화면" />
+            <Figure src={image18} caption="KCP 파트너관리자 내 관리용 사설인증서 발급 완료 화면" />
 
-               4. \[결제관리]→\[정기자동결제 그룹관리]→\[그룹등록]을 클릭합니다.
-               5. \[상점정보]→\[사이트코드]에서 그룹등록할 사이트코드를 선택합니다.
-               6. \[그룹정보]에서 \[유형3]을 선택한 후 원하는 그룹명을 입력합니다.
-               7. \[결제입력 정보]에서 \[결제유형] 및 \[납부유형]을 확인하시고 고객사 유형에 맞게 선택합니다.
-               8. \[고지방법]에서 원하시는 고지 방법을 선택한 후 \[등록하기]를 클릭합니다.
+            4. \[결제관리]→\[정기자동결제 그룹관리]→\[그룹등록]을 클릭합니다.
+            5. \[상점정보]→\[사이트코드]에서 그룹등록할 사이트코드를 선택합니다.
+            6. \[그룹정보]에서 \[유형3]을 선택한 후 원하는 그룹명을 입력합니다.
+            7. \[결제입력 정보]에서 \[결제유형] 및 \[납부유형]을 확인하시고 고객사 유형에 맞게 선택합니다.
+            8. \[고지방법]에서 원하시는 고지 방법을 선택한 후 \[등록하기]를 클릭합니다.
 
-               <Figure src={image19} caption="KCP 파트너관리자 내 관리용 그룹등록 화면" />
+            <Figure src={image19} caption="KCP 파트너관리자 내 관리용 그룹등록 화면" />
 
-               9. \[결제관리]→\[정기자동결제 그룹관리]→\[그룹조회]를 클릭합니다.
-               10. \[사이트코드]에서 사용한 사이트코드를 선택한 후 \[검색]을 클릭합니다.
+            9. \[결제관리]→\[정기자동결제 그룹관리]→\[그룹조회]를 클릭합니다.
+            10. \[사이트코드]에서 사용한 사이트코드를 선택한 후 \[검색]을 클릭합니다.
 
-               <Figure src={image20} caption="KCP 파트너관리자 내 관리용 그룹조회 화면" />
+            <Figure src={image20} caption="KCP 파트너관리자 내 관리용 그룹조회 화면" />
 
-               11. 포트원 콘솔에서 채널 추가 시 사이트코드, 사이트키, 앞서 발급한 정기자동결제 그룹아이디를 입력한 후 \[저장]을 클릭합니다.
-             </div>
+            11. 포트원 콘솔에서 채널 추가 시 사이트코드, 사이트키, 앞서 발급한 정기자동결제 그룹아이디를 입력한 후 \[저장]을 클릭합니다.
+          </div>
         </Tab>
 
         <Tab title="결제창 정기결제">
@@ -462,8 +462,10 @@ import IntegrationTosspayments from './_components/integration-guide/tosspayment
           포트원 콘솔에서 채널 추가 시 계약 완료 후 KCP로부터 전달받은 \[사이트코드] 및 \[사이트키], \[파트너 타입], \[파트너 서브타입], \[파트너이름]를 입력한 후 `저장`을 클릭합니다.
         </Tab>
       </Tabs>
-    </Details>
-  </VersionGate>
+
+      <IntegrationKcpV2 slot="v2" />
+    </VersionGate>
+  </Details>
 
   #### 간편결제 직연동
 

src/content/docs/ko/result/notice.mdx

@@ -13,6 +13,7 @@ import daou_image2 from "./_assets/daou_notice_2.png";
 import daou_image3 from "./_assets/daou_notice_3.png";
 import inicie_image1 from "./_assets/inicis_notice.png";
 import kcp_image1 from "./_assets/kcp_notice.png";
+import kcp_v2_image from "./_assets/kcp_v2_notice.png";
 import nice_v1_image1 from "./_assets/nice-v1/nice-v1-webhook-guide-1.png";
 import nice_v2_image1 from "./_assets/nice-v2/nice-v2-webhook-guide-1.png";
 import smartro_image1 from "./_assets/smartro/smartro-webhook-guide-1.png";
@@ -42,13 +43,14 @@ import welcome_image2 from "./_assets/welcome/welcome-webhook-guide-2.png";
   </Fragment>
 
   <Fragment slot="v2">
-    |PG              |코드값 (pg provider)|입금통보 주소                                                                                                                                                                 |
-    |----------------|--------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-    |토스페이먼츠    |tosspaysments       |[https://tx-gateway-service.prod.iamport.co/virtual-account/webhook-event/tosspayments](https://tx-gateway-service.prod.iamport.co/virtual-account/webhook-event/tosspayments)|
-    |스마트로        |smartro\_v2         |입금 통보, 환불이체 URL 동일: [https://tx-gateway-service.prod.iamport.co/smartro-v2](https://tx-gateway-service.prod.iamport.co/smartro-v2)                                  |
-    |나이스페이먼츠  |nice\_v2            |[https://tx-gateway-service.prod.iamport.co/nicepay-v2](https://tx-gateway-service.prod.iamport.co/nicepay-v2)                                                                |
-    |KG이니시스      |inicis\_v2          |[https://tx-gateway-service.prod.iamport.co/inicis-v2](https://tx-gateway-service.prod.iamport.co/inicis-v2)                                                                  |
-    |한국결제네트웍스|kpn                 |[https://tx-gateway-service.prod.iamport.co/kpn/virtual-account](https://tx-gateway-service.prod.iamport.co/kpn/virtual-account)                                              |
+    |PG              |코드값 (pg provider)|입금통보 주소                                                                                                                                                                 | |
+    |----------------|--------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-|
+    |토스페이먼츠    |tosspaysments       |[https://tx-gateway-service.prod.iamport.co/virtual-account/webhook-event/tosspayments](https://tx-gateway-service.prod.iamport.co/virtual-account/webhook-event/tosspayments)| |
+    |스마트로        |smartro\_v2         |입금 통보, 환불이체 URL 동일: [https://tx-gateway-service.prod.iamport.co/smartro-v2](https://tx-gateway-service.prod.iamport.co/smartro-v2)                                  | |
+    |나이스페이먼츠  |nice\_v2            |[https://tx-gateway-service.prod.iamport.co/nicepay-v2](https://tx-gateway-service.prod.iamport.co/nicepay-v2)                                                                | |
+    |KG이니시스      |inicis\_v2          |[https://tx-gateway-service.prod.iamport.co/inicis-v2](https://tx-gateway-service.prod.iamport.co/inicis-v2)                                                                  | |
+    |한국결제네트웍스|kpn                 |[https://tx-gateway-service.prod.iamport.co/kpn/virtual-account](https://tx-gateway-service.prod.iamport.co/kpn/virtual-account)                                              | |
+    |NHN KCP         |kcp\_v2             |[https://tx-gateway-service.prod.iamport.co/kcp-v2](https://tx-gateway-service.prod.iamport.co/kcp-v2)                                                                        | |
   </Fragment>
 </VersionGate>
 
@@ -71,7 +73,7 @@ import welcome_image2 from "./_assets/welcome/welcome-webhook-guide-2.png";
   <Details id="notice-config-kcp">
     <p slot="summary">KCP 설정 방법</p>
 
-    1. [KCP 파트너관리자](https://partner.kcp.co.kr/) 접속 후 로그인을 합니다.
+    1. \[KCP 파트너관리자](https://partner.kcp.co.kr/) 접속 후 로그인을 합니다.
     2. \[상점정보관리]→\[보안관리]→\[결제결과URL 설정]을 클릭합니다.
     3. \[변경 결제결과URL]을 `https://service.iamport.kr/kcp_payments/notice_vbank`로 설정해주세요.
     4. \[인코딩 설정]을 `UTF-8`로 설정해주세요.
@@ -222,9 +224,23 @@ import welcome_image2 from "./_assets/welcome/welcome-webhook-guide-2.png";
     <p slot="summary">한국결제네트웍스(KPN) 설정 방법</p>
 
     한국결제네트웍스(KPN)는 계약 이후, 발급된 MID에 대해 **가상계좌 백노티 기능**을 별도로 요청해야 합니다.
-    
+
     한국결제네트웍스(KPN) 담당자에게 MID 정보와 함께 입금 통보 URL을 전달하여 가상계좌 백노티 기능 요청을 진행해주세요.
-    
+
     만약 입금통보를 받지 못하는 경우 한국결제네트웍스(KPN) 담당자에게 메일을 통해 확인 요청 후 변경이 필요합니다.
   </Details>
 </VersionGate>
+
+<VersionGate default="v2">
+  <Details>
+    <p slot="summary">NHN KCP 설정 방법</p>
+
+    1. [KCP 파트너관리자](https://partner.kcp.co.kr) 접속 후 로그인을 합니다.
+    2. \[상점정보관리]→\[보안관리]→\[결제결과URL 설정]을 클릭합니다.
+    3. \[변경 결제결과URL]을 `https://tx-gateway-service.prod.iamport.co/kcp-v2`로 설정해주세요.
+    4. \[인코딩 설정]을 `UTF-8`로 설정해주세요.
+    5. \[저장]을 클릭합니다.
+
+    <Figure src={kcp_v2_image} caption="KCP 파트너관리자 내 입금통보 URL 설정 화면" />
+  </Details>
+</VersionGate>

src/content/docs/ko/smartrouting/intro-sr.mdx

@@ -39,7 +39,7 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
 - **한국결제네트웍스(KPN)** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
 - **KSNET** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
 - **스마트로** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
-- **NHN KCP** (6월 중 제공예정)
+- **NHN KCP** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
 
 ### API 수기(키인)결제
 
@@ -49,7 +49,7 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
 - **한국결제네트웍스(KPN)** : 카드 / 가상계좌
 - **KSNET** : 카드 / 가상계좌
 - **스마트로** : 가상계좌
-- **NHN KCP** (6월 중 제공예정)
+- **NHN KCP** : 카드 / 가상계좌
 
 ### API 빌링키 발급 및 정기결제
 
@@ -59,7 +59,7 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
 - **한국결제네트웍스(KPN)** : 카드
 - **KSNET** : 카드
 - **스마트로** : 카드
-- **NHN KCP** (6월 중 제공예정)
+- **NHN KCP** : 카드
 
 ## 스마트 라우팅 연동 안내