@portone/mcp-server 0.13.0

package/assets/docs/opi/ko/extra/identity-verification/readme-v2.md

@@ -0,0 +1,261 @@
+---
+title: 본인인증 연동하기
+description: 포트원을 이용하여 간편하게 본인인증을 연동하는 방법을 확인합니다.
+targetVersions:
+  - v2
+versionVariants:
+  v1: /opi/ko/extra/identity-verification/v1/readme
+---
+
+**본인인증 서비스**란 인증 절차를 거쳐 본인 여부와 입력한 정보의 정확성을 확인하여 주는 서비스입니다. 현재 지원하는 본인인증 서비스는 아래와 같습니다.
+
+- 다날 휴대폰 본인인증
+- KG이니시스 통합인증
+- KCP 휴대폰 본인인증
+
+## 휴대폰 본인인증
+
+휴대폰 본인인증 서비스란 본인 명의로 개통한 휴대폰을 이용하여 최소한의 개인정보를 입력하는 인증 절차를 거쳐 본인 여부와 입력한 정보의 정확성을 확인하여 주는 서비스입니다.
+
+고객은 웹사이트에 가입, 결제, 또는 성인 인증 등을 위해 본인인증을 시행합니다. 본인인증은 모바일
+기기에 설치된 본인인증 전용 앱을 이용하거나 사용자 본인 정보(이름, 생년월일, 휴대폰번호)를 인증요청
+페이지에 입력한 후 문자로 온 인증번호를 기입하는 방식으로 이루어집니다.
+
+(이미지 첨부: 휴대폰 본인인증 화면 예시)
+
+포트원을 이용한 휴대폰 본인인증의 Flow는 JavaScript SDK를 이용하여 휴대폰 본인인증을 완료하고 고객사 서버에서 포트원 REST API를 이용하여 **인증완료정보를 획득**하는 방법으로 진행됩니다.
+
+<div class="hint" data-style="info">
+
+**API를 이용한 본인인증**
+
+다날 및 KCP의 경우 수기결제처럼 API 호출만으로 진행하는 본인인증도 지원하고 있습니다. REST API 문서의 해당 부분 설명을 참고해 주세요.
+
+</div>
+
+## 통합인증
+
+통합인증 서비스란 카카오톡 인증서, 네이버 인증서 등의 민간 인증서를 통한 인증 절차를 거쳐 본인 여부와 입력한 정보의
+정확성을 확인하여 주는 서비스입니다. 통합인증은 **KG이니시스**를 통해 제공되며 민간 인증서를
+이용하거나 사용자 본인이 가입된 간편인증을 통해 인증요청을 보내고 간편인증 페이지에서 인증처리를
+하는 방식으로 이루어집니다.
+
+> **이용가능 수단 : 네이버 / PASS / 페이코 / TOSS / 금융인증서 / 카카오 / 신한 / KB모바일 / 삼성패스**
+
+(이미지 첨부: 휴대폰 본인인증 화면 예시)
+
+## SDK를 사용한 본인인증
+
+포트원을 이용한 본인인증의 Flow는 휴대폰 본인인증, 통합인증 모두 JavaScript SDK를 이용하여 본인인증을 완료하고 고객사 서버에서 포트원 REST API를 이용하여 **인증완료정보를 획득**하는 방법으로 진행됩니다.
+
+### 1. 포트원 SDK 설치
+
+포트원 SDK를 설치하는 방법은 [인증 결제 연동하기](https://developers.portone.io/opi/ko/integration/start/v2/checkout) 문서를 참고하세요.
+
+### 2. 본인인증 요청하기
+
+SDK의 `PortOne.requestIdentityVerification()` 함수를 호출하여 본인인증창을 열 수 있습니다.
+
+먼저, 관리자 콘솔의 결제 연동 페이지에서 **Store ID**와 사용할 채널의 **채널 키**를 확인해 주세요.
+
+그리고 아래와 같이 파라미터들을 설정하여 호출합니다.
+
+```ts
+PortOne.requestIdentityVerification({
+  // 고객사 storeId로 변경해주세요.
+  storeId: "store-4ff4af41-85e3-4559-8eb8-0d08a2c6ceec",
+  identityVerificationId: `identity-verification-${crypto.randomUUID()}`,
+  // 연동 정보 메뉴의 채널 관리 탭에서 확인 가능합니다.
+  channelKey: "channel-key-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
+});
+```
+
+**identityVerificationId**는 본인인증 건을 구분하는 문자열로, 본인인증 요청 및 조회에 필요합니다.
+같은 identityVerificationId에 대해 여러 번의 본인인증 시도가 가능하나, 최종적으로 인증에 성공하는
+것은 단 한 번만 가능합니다.
+
+### 3. 본인인증 완료 처리 (브라우저)
+
+`PortOne.requestIdentityVerification()` 함수의 반환값을 통해 본인인증 요청의 결과를 확인합니다.
+
+`code`가 있으면 본인인증 과정에서 오류가 발생한 것이므로 적절히 처리하여야 합니다.
+
+본인인증이 성공한 경우 identityVerificationId를 서버에 전달하여 서버측 본인인증 완료 처리를 하도록 합니다.
+
+```ts
+const response = await PortOne.requestIdentityVerification({
+  /* 객체 생략 */
+});
+// 프로세스가 제대로 완료되지 않은 경우 에러 코드가 존재합니다
+if (response.code !== undefined) {
+  return alert(response.message);
+}
+
+const verificationResult = await fetch("{서버의 인증 정보를 받는 endpoint}", {
+  method: "POST",
+  headers: { "Content-Type": "application/json" },
+  body: JSON.stringify({
+    identityVerificationId,
+  }),
+});
+```
+
+본인인증 요청 및 응답 파라미터는 [브라우저 SDK 문서](https://developers.portone.io/sdk/ko/v2-sdk/readme)를 참조해 주세요.
+
+#### 3-1. redirect 방식의 경우
+
+모바일 환경에서의 본인인증은 대부분 redirect 방식으로 이루어집니다. redirect 방식에서는 브라우저가
+본인인증창으로 리다이렉트되었다가, 인증창에서의 작업이 끝나면 지정한 `redirectUrl`로 다시
+리다이렉트됩니다. 이 경우에는 함수 호출 결과를 이용할 수 없고, 인증 성공 여부 등은
+[쿼리 문자열](http://en.wikipedia.org/wiki/Query_string)로 전달받게 됩니다.
+
+```ts
+PortOne.requestIdentityVerification({
+  /* 파라미터 생략 */
+  redirectUrl: `${BASE_URL}/identity-verification-redirect`,
+});
+```
+
+쿼리 문자열로 전달되는 내용은 [브라우저 SDK 응답 형식](https://developers.portone.io/sdk/ko/v2-sdk/identity-verification-response)과 동일합니다.
+
+예를 들어 identityVerificationId가 `identity-verification-39ecfa97`, redirectUrl이
+`https://example.com/identity-verification-redirect`인 경우, 본인인증 성공 시에
+`https://example.com/identity-verification-redirect?identityVerificationId=identity-verification-39ecfa97`로
+리다이렉트됩니다.
+
+### 4. 인증 완료 처리 (서버)
+
+본인인증 완료 이후 획득한 `identityVerificationId`를 이용하여 고객 인증정보를 조회할 수 있습니다.
+
+```ts title="server-side"
+app.use(bodyParser.json());
+
+// "/identity-verifications"에 대한 POST 요청을 처리하는 controller
+app.post("/identity-verifications", async (req, res) => {
+  // request의 body에서 identityVerificationId 추출
+  const { identityVerificationId } = req.body;
+  try {
+    // 포트원 본인인증 내역 단건조회 API 호출
+    const verificationResponse = await fetch({
+      url: `https://api.portone.io/identity-verifications/${encodeURIComponent(identityVerificationId)}`,
+      headers: { Authorization: `PortOne ${PORTONE_API_SECRET}` },
+    });
+    if (!verificationResponse.ok)
+      throw new Error(
+        `verificationResponse: ${await verificationResponse.json()}`,
+      );
+    const identityVerification = await verificationResponse.json();
+    if (identityVerification.status !== "VERIFIED") {
+      // 인증 실패
+    }
+  } catch (e) {
+    console.error(e);
+  }
+});
+```
+
+#### 인증 정보 활용하기
+
+조회한 인증 정보에서 다음의 고객 정보를 추출하는 서비스 코드 예제입니다.
+아래 파라미터들은 모두 본인인증 단건 조회의 결과가 인증 완료 상태일 때 (status = `VERIFIED`) 제공되는 `verifiedCustomer` 필드 내에 존재합니다.
+
+- `ci`: 연계 정보(Connecting Information).
+  - 사람마다 고유하고 서비스별로 달라지지 않기 때문에, 서비스 간 연계에 사용할 수 있음.
+  - 다날의 경우 항상 제공.
+  - KCP의 경우 항상 제공.
+  - KG이니시스의 경우 카카오를 제외한 인증 업체에서 항상 제공. 카카오의 경우 별도 서류 작성이 필요합니다.
+
+- `di`: 중복 가입 확인 정보(Duplication Information).
+  - 해당 서비스 안에서만 사람마다 고유함.
+  - 이용자의 중복 가입을 확인하는 데 사용할 수 있음.
+  - 다날의 경우 항상 제공.
+  - KCP의 경우 항상 제공.
+  - KG이니시스의 경우 제공되지 않음.
+
+- `name`: 이름
+
+- `gender`: 성별
+  - 다날의 경우 항상 제공.
+
+  - KCP의 경우 항상 제공.
+
+  - KG이니시스의 경우 카카오톡 인증을 제외하고 항상 제공합니다.
+    - 카카오톡 인증의 경우 인증기관 검증 절차 없이 사용자가 직접 입력한 정보를 제공합니다.
+    - `FRGNDInfo` 파라미터를 `N`으로 설정한 경우, 카카오톡 인증 시에 성별 정보를 사용자에게 입력받지 않으며, 인증 결과에 성별을 제공하지 않습니다. [참고](https://developers.portone.io/opi/ko/integration/pg/v2/inicis-unified-identity-verification#kg이니시스-특수-파라미터-안내)
+
+- `birthDate`: 생년월일 (YYYY-MM-DD)
+
+- `operator`: 통신사
+  - 다날의 경우 하기 안내를 따라 추가 계약 후 제공.
+  - KCP의 경우 항상 제공.
+  - KG이니시스의 경우 미제공.
+
+- `phoneNumber`: 숫자로만 구성된 전화번호
+  - 다날의 경우 하기 안내를 따라 추가 계약 후 제공.
+  - KCP의 경우 항상 제공.
+  - KG이니시스의 경우 항상 제공.
+
+- `isForeigner`: 외국인 여부.
+  - 다날의 경우 하기 안내를 따라 추가 계약 후 제공.
+
+  - KCP의 경우 항상 제공.
+
+  - KG이니시스의 경우 카카오톡, 네이버 인증을 제외하고 항상 제공합니다.
+    - 카카오톡, 네이버 인증의 경우 인증기관 검증 절차 없이 사용자가 직접 입력한 정보를 제공합니다.
+    - `FRGNDInfo` 파라미터를 `N`으로 설정한 경우, 네이버와 카카오톡 인증 시에 외국인 여부를 사용자에게 입력받지 않으며, 인증 결과에 외국인 여부를 제공하지 않습니다. [참고](https://developers.portone.io/opi/ko/integration/pg/v2/inicis-unified-identity-verification#kg이니시스-특수-파라미터-안내)
+
+<div class="hint" data-style="info">
+
+다날의 외국인(**`isForeigner`**) 여부는 **API 방식** 본인인증에 한하여 **개인정보 제공동의 약관을 사이트에 게재**한 후 **<cs@portone.io>로 신청**하여 취득할 수 있습니다. 해당 부분은 당사 계약 이후 다날PG사로 요청 후 승인이 완료되면 이용 가능한 점 참고해 주시기 바랍니다.
+
+**메일 요청 신청 양식**
+
+- 상호명 :
+- 사업자번호 :
+- 본인인증용 다날 상점ID(CPID) :
+- 업종 :
+- 필요사유 :
+- 개인정보취급방침 url : 앱서비스로 URL형태로 전달이 어려우신 경우 '개인정보취급방침' 경로를 캡쳐하여 전달주시기 바랍니다.
+
+**참고 - 포트원 이용 고객사의 개인정보처리방침 적용 예시**
+
+- `(주)마플 : https://marpple.shop/kr/@/privacy`
+- `(주)브레이브모바일 / 숨고 : https://soomgo.com/terms/privacy`
+- `(주)마켓잇 : https://static.marketit.asia/static/privacy-terms.pdf`
+
+</div>
+
+```ts title="Express"
+// "/identity-verifications"에 대한 POST 요청을 처리하는 controller
+app.post("/identity-verifications", async (req, res) => {
+  // request의 body에서 identity_verification_id 추출
+  const { identityVerificationId } = req.body;
+  try {
+    // 인증 토큰 발급 받기
+    // identityVerificationId로 인증 정보 조회
+
+    const { ci, di, name, gender, birthDate } =
+      identityVerification.verifiedCustomer;
+    // 연령 제한 로직 예시
+    if (new Date(birthDate).getFullYear() <= 1999) {
+      // 연령 만족
+    } else {
+      // 연령 미달
+    }
+    // 1인 1계정 허용 로직 예시
+    if (di == null) {
+      // PG사에서 di를 미제공
+    } else {
+      // DB에서 di 조회 후 가입여부 검사
+      const user = await Users.find({ di });
+      if (user == null) {
+        // 신규 고객
+      } else {
+        // 이미 가입된 고객
+      }
+    }
+  } catch (e) {
+    console.error(e);
+  }
+});
+```

package/assets/docs/opi/ko/extra/identity-verification/v1/all/0.md

@@ -0,0 +1,35 @@
+---
+title: 통합인증 준비하기
+description: 통합인증 연동을 시작하기 위한 준비작업을 소개합니다.
+targetVersions:
+  - v1
+---
+
+## 1. 포트원 SDK 설치하기 <span id="sdk-installation" />
+
+포트원은 다양한 PG의 본인인증창을 통일된 방법으로 호출할 수 있도록 자바스크립트 SDK를 제공합니다.
+브라우저에서 포트원 SDK를 호출하여 본인인증을 진행하게 됩니다.
+
+<!-- VERSION-SPECIFIC: V1 ONLY CONTENT START -->
+
+결제창 연동을 진행할 주문 페이지에 아래 JS 라이브러리를 추가합니다.
+
+```html
+<script src="https://cdn.iamport.kr/v1/iamport.js"></script>
+```
+
+[포트원 라이브러리 추가하기](https://www.youtube.com/watch?v=FLyOmbtnr48)
+
+<!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
+
+## 2. SDK 초기화하기 <span id="sdk-installation" />
+
+포트원 SDK를 사용하여 결제창을 호출하려면, 먼저 포트원 SDK를 초기화하여야 합니다.
+
+먼저, 관리자 콘솔의 결제 연동 페이지에서 **고객사 식별코드**를 확인해 주세요.
+
+그리고 결제창을 호출할 페이지에서 다음과 같이 포트원 SDK를 초기화합니다.
+
+```ts title="client-side"
+IMP.init("{고객사 식별코드}"); // 예: imp00000000
+```

package/assets/docs/opi/ko/extra/identity-verification/v1/all/1.md

@@ -0,0 +1,44 @@
+---
+title: 통합인증 요청하기
+description: 통합인증 페이지를 호출하는 방법을 확인합니다.
+targetVersions:
+  - v1
+---
+
+통합인증은 아래 두 가지 방법으로 호출할 수 있습니다.
+
+> **팝업**(**Default**) 방식
+>
+> 통합인증 본인인증 팝업창이 열리고 본인인증를 완료하면 두 번째 인자로 지정된 `callback` 함수가 실행됩니다.
+
+> **리디렉션**(redirect)방식(**Mobile** 환경에서만 적용)
+>
+> 모바일 환경에서 `param.popup`을 **`false`**`(기본값)`로 설정하면 본인인증 페이지로 리디렉션되고 본인인증을 완료하면 `param.m_redirect_url`로 다시 리디렉션됩니다.
+>
+> `param.popup`을 **`true`** 로 설정하면 팝업(기본) 방식으로 작동합니다.
+>
+> **WebView 등 팝업이 차단되는 환경**에서는 `popup : false`로 설정하는 것을 권장합니다
+
+아래는 JavaScript SDK [**IMP.certification**](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/cft) 함수를 이용하여 통합인증
+본인인증창을 호출하는 예제입니다.
+
+```ts title="client-side"
+// IMP.certification(param, callback) 호출
+IMP.certification(
+  {
+    // param
+    channelKey: "{콘솔 내 연동 정보의 채널키}",
+    merchant_uid: "ORD20180131-0000011", // 주문 번호
+    m_redirect_url: "{리디렉션 될 URL}", // 모바일환경에서 popup:false(기본값) 인 경우 필수, 예: https://www.myservice.com/payments/complete/mobile
+    popup: false, // PC환경에서는 popup 파라미터가 무시되고 항상 true 로 적용됨
+  },
+  function (rsp) {
+    // callback
+    if (rsp.success) {
+      // 인증 성공 시 로직
+    } else {
+      // 인증 실패 시 로직
+    }
+  },
+);
+```

package/assets/docs/opi/ko/extra/identity-verification/v1/all/2.md

@@ -0,0 +1,75 @@
+---
+title: 인증 완료정보 전달하기
+description: 통합인증 이후 획득된 정보를 처리하는 방법을 안내합니다.
+targetVersions:
+  - v1
+---
+
+인증 프로세스가 완료되면 반환되는 응답 객체(**`rsp`**)의 인증 성공 여부에 따라 처리 로직을 **`callback`** 함수에 작성합니다. 요청이 성공했을 경우에 **인증번호(`imp_uid`)를 서버에 전달**하는 로직을 다음 예제를 참고하여 작성합니다. 인증 성공시 [**반환되는 값**](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/cft-rt)을 확인하세요
+
+## 1. callback Data 전달 예제
+
+<div class="tabs-container">
+
+<div class="tabs-content" data-title="JavaScript">
+
+```ts title="client-side"
+IMP.certification(
+  {
+    /* ...중략... */
+  },
+  function (rsp) {
+    // callback
+    if (rsp.success) {
+      // 인증 성공 시
+      // jQuery로 HTTP 요청
+      jQuery.ajax({
+        url: "{서버의 인증 정보를 받는 endpoint}",
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        data: { imp_uid: rsp.imp_uid },
+      });
+    } else {
+      alert("인증에 실패하였습니다. 에러 내용: " + rsp.error_msg);
+    }
+  },
+);
+```
+
+</div>
+
+<div class="tabs-content" data-title="JS ES Next">
+
+```ts title="client-side"
+IMP.certification(
+  {
+    /* ...중략... */
+  },
+  (rsp) => {
+    // callback
+    if (rsp.success) {
+      // 인증 성공 시 axios로 HTTP 요청
+      axios({
+        url: "{서버의 인증 정보를 받는 endpoint}",
+        method: "post",
+        headers: { "Content-Type": "application/json" },
+        data: { imp_uid: rsp.imp_uid },
+      });
+    } else {
+      alert(`인증에 실패하였습니다. 에러 내용: ${rsp.error_msg}`);
+    }
+  },
+);
+```
+
+</div>
+
+</div>
+
+### 2. 리디렉션 전달 예제
+
+`IMP.`**`certification`** 호출 시 설정한 **`m_redirect_url`** 로 인증 정보와 함께 다음과 같이 리디렉션됩니다.
+
+```http title="Query String"
+GET {m_redirect_url}?imp_uid={}&merchant_uid={본인인증 건의 merchant_uid}&success={true 또는 false}
+```

package/assets/docs/opi/ko/extra/identity-verification/v1/all/3.md

@@ -0,0 +1,134 @@
+---
+title: 인증정보 조회 및 활용하기
+description: 인증정보를 획득하고 활용하는 방법을 안내합니다.
+targetVersions:
+  - v1
+---
+
+통합인증 완료이후 획득한 `imp_uid`를 이용하여 고객 인증정보를 조회할 수 있습니다.
+
+## **STEP 01.** 인증정보(imp\_uid) 서버단에서 획득하기
+
+아래는 본인인증 앞단에서 넘어온 값을 서버단에서 수신받은 예제 입니다.
+
+<div class="tabs-container">
+
+<div class="tabs-content" data-title="Node.js(팝업방식)">
+
+```ts title="server-side"
+app.use(bodyParser.json());
+
+// "/certifications"에 대한 POST 요청을 처리하는 controller
+app.post("/certifications", async (request, response) => {
+  // request의 body에서 imp_uid 추출
+  const { imp_uid } = request.body;
+});
+```
+
+</div>
+
+<div class="tabs-content" data-title="Node.js(리디렉션 방식)">
+
+```ts title="server-side"
+app.use(bodyParser.json());
+
+// "/certifications/redirect"에 대한 GET 요청을 처리하는 controller
+app.get("/certifications/redirect", async (request, response) => {
+  // request의 query에서 imp_uid 추출
+  const { imp_uid } = request.query;
+});
+```
+
+</div>
+
+</div>
+
+## **STEP 02.** 인증 정보 조회하기
+
+포트원 서버에서 인증 정보를 조회하기 위해서 먼저 [**REST API access token**](https://developers.portone.io/api/rest-v1/auth?v=v1#post%20%2Fusers%2FgetToken)을 발급받습니다.
+발급받은 액세스 토큰(`access_token`)과 인증번호(`imp_uid`)로 **본인인증 결과조회 REST API** 를 호출하여 인증 정보를 조회하는 예제입니다.
+
+```ts title="server-side(Node.js)"
+app.use(bodyParser.json());
+
+// "/certifications"에 대한 POST 요청을 처리하는 controller
+app.post("/certifications", async (request, response) => {
+  // request의 body에서 imp_uid 추출
+  const { imp_uid } = request.body;
+  try {
+    // 인증 토큰 발급 받기
+    const getToken = await axios({
+      url: "https://api.iamport.kr/users/getToken",
+      // POST method
+      method: "post",
+      // "Content-Type": "application/json"
+      headers: { "Content-Type": "application/json" },
+      data: {
+        // REST API키
+        imp_key: "imp_apikey",
+        // REST API Secret
+        imp_secret:
+          "ekKoeW8RyKuT0zgaZsUtXXTLQ4AhPFW3ZGseDA6bkA5lamv9OqDMnxyeB9wqOsuO9W3Mx9YSJ4dTqJ3f",
+      },
+    });
+    // 인증 토큰
+    const { access_token } = getToken.data;
+    // imp_uid로 인증 정보 조회
+    const getCertifications = await axios({
+      // imp_uid 전달
+      url: `https://api.iamport.kr/certifications/\${imp_uid}`,
+      // GET method
+      method: "get",
+      // 인증 토큰 Authorization header에 추가
+      headers: { Authorization: access_token },
+    });
+    // 조회한 인증 정보
+    const certificationsInfo = getCertifications.data;
+  } catch (e) {
+    console.error(e);
+  }
+});
+```
+
+## **STEP 03.** 인증 정보 활용하기
+
+조회한 인증 정보에서 다음의 고객 정보를 추출하는 서비스 코드 예제입니다.\
+필요 시, 예제와 같이 고객 정보를 사용하여 연령 제한을 검사할 수 있습니다.
+
+- `name`: 이름
+- `gender`: 성별
+- `birth`: 생년월일
+- `unique_key`: CI 값과 동일. 온라인 주민번호와 같은 개인고유식별키
+- `phone :`휴대폰 번호
+
+```ts title="Node.js"
+// "/certifications"에 대한 POST 요청을 처리하는 controller
+app.post("/certifications", async (request, response) => {
+  const { imp_uid } = request.body; // request의 body에서 imp_uid 추출
+  try {
+    // 인증 토큰 발급 받기
+    /* ...중략... */
+    // imp_uid로 인증 정보 조회
+    /* ...중략... */
+    const certificationsInfo = getCertifications.data; // 조회한 인증 정보
+    const { name, birth } = certificationsInfo;
+    // 연령 제한 로직
+    if (new Date(birth).getFullYear() <= 1999) {
+      // 연령 만족
+    } else {
+      // 연령 미달
+    }
+  } catch (e) {
+    console.error(e);
+  }
+});
+```
+
+<div class="hint" data-style="info">
+
+**\<KG이니시스 통합본인인증\_특징(중요)>**
+
+- KG이니시스 통합인증서비스는 **DI 정보는 제공되지 않습니다**.
+- KG이니시스 통합인증서비스는 **카카오 인증의 경우, CI값 제공 가능하나 KG이니시스와 계약시 별도 서류 작성 절차가 필요합니다**.
+
+</div>

package/assets/docs/opi/ko/extra/identity-verification/v1/all/readme.md

@@ -0,0 +1,17 @@
+---
+title: 통합인증 연동하기
+description: 통합인증 기능을 구현하는 방법을 설명합니다.
+targetVersions:
+  - v1
+---
+
+## 통합인증 서비스란 ?
+
+카카오톡 인증서, 네이버 인증서 등의 민간 인증서를 통한 인증 절차를 거쳐 본인 여부와 입력한 정보의
+정확성을 확인하여 주는 서비스입니다. 통합인증은 **KG이니시스**를 통해 제공되며 민간 인증서를
+이용하거나 사용자 본인이 가입된 간편인증을 통해 인증요청을 보내고 간편인증 페이지에서 인증처리를
+하는 방식으로 이루어 집니다.
+
+> **이용가능 수단 : 네이버 / PASS / 페이코 / TOSS / 금융인증서 / 카카오 / 신한 / KB모바일 / 삼성패스**
+
+[이미지 링크](<https://developers.portone.io/gitbook-assets/ko/image (24) (2).png>)

package/assets/docs/opi/ko/extra/identity-verification/v1/credit-auth/1.md

@@ -0,0 +1,35 @@
+---
+title: 1. 본인인증 준비하기
+description: 신용카드 본인인증을 시작하기 위한 안내입니다.
+targetVersions:
+  - v1
+---
+
+## 1. 포트원 SDK 설치하기 <span id="sdk-installation" />
+
+포트원은 다양한 PG의 본인인증창을 통일된 방법으로 호출할 수 있도록 자바스크립트 SDK를 제공합니다.
+브라우저에서 포트원 SDK를 호출하여 본인인증을 진행하게 됩니다.
+
+<!-- VERSION-SPECIFIC: V1 ONLY CONTENT START -->
+
+결제창 연동을 진행할 주문 페이지에 아래 JS 라이브러리를 추가합니다.
+
+```html
+<script src="https://cdn.iamport.kr/v1/iamport.js"></script>
+```
+
+[포트원 라이브러리 추가하기](https://www.youtube.com/watch?v=FLyOmbtnr48)
+
+<!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
+
+## 2. SDK 초기화하기 <span id="sdk-installation" />
+
+포트원 SDK를 사용하여 결제창을 호출하려면, 먼저 포트원 SDK를 초기화하여야 합니다.
+
+먼저, 관리자 콘솔의 결제 연동 페이지에서 **고객사 식별코드**를 확인해 주세요.
+
+그리고 결제창을 호출할 페이지에서 다음과 같이 포트원 SDK를 초기화합니다.
+
+```ts title="client-side"
+IMP.init("{고객사 식별코드}"); // 예: imp00000000
+```

package/assets/docs/opi/ko/extra/identity-verification/v1/credit-auth/2.md

@@ -0,0 +1,78 @@
+---
+title: 2. 본인인증 요청하기
+description: 신용카드 본인인증 창을 호출하는 방법을 안내합니다.
+targetVersions:
+  - v1
+---
+
+신용카드 본인인증은 아래 두가지 방법으로 호출할 수 있습니다.
+
+> **팝업**(Default) 방식
+>
+> 신용카드 본인인증 팝업창이 열리고 본인인증를 완료하면 두 번째 인자로 지정된 `callback` 함수가 실행됩니다.
+
+> **리디렉션**(redirect)방식(**Mobile** 환경에서만 적용)
+>
+> 모바일 환경에서 `param.popup`을 **`false`**`(기본값)`로 설정하면 본인인증 페이지로 리디렉션되고 본인인증을 완료하면 `param.m_redirect_url`로 다시 리디렉션됩니다.
+>
+> `param.popup`을 **`true`** 로 설정하면 팝업(기본) 방식으로 작동합니다.
+>
+> **WebView 등 팝업이 차단되는 환경**에서는 `popup : false`로 설정하는 것을 권장합니다
+
+아래는 JavaScript SDK [**IMP.certification**](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/cft) 함수를 이용하여 신용카드
+본인인증창을 호출하는 예제입니다.
+
+<div class="tabs-container">
+
+<div class="tabs-content" data-title="JavaScript">
+
+```ts title="client-side"
+// IMP.certification(param, callback) 호출
+IMP.certification(
+  {
+    // param
+    channelKey: "{콘솔 내 연동 정보의 채널키}",
+    merchant_uid: "ORD20180131-0000011", // 주문 번호
+    // 모바일환경에서 popup:false(기본값) 인 경우 필수
+    m_redirect_url: "{리디렉션 될 URL}",
+    popup: false, // PC환경에서는 popup 파라미터가 무시되고 항상 true 로 적용됨
+  },
+  function (rsp) {
+    // callback
+    if (rsp.success) {
+      // 인증 성공 시 로직
+    } else {
+      // 인증 실패 시 로직
+    }
+  },
+);
+```
+
+</div>
+
+<div class="tabs-content" data-title="ES Next">
+
+```ts title="client-side"
+// IMP.certification(param, callback) 호출
+IMP.certification(
+  {
+    // param
+    channelKey: "{콘솔 내 연동 정보의 채널키}",
+    merchant_uid: "ORD20180131-0000011", // 주문 번호
+    m_redirect_url: "{리디렉션 될 URL}", // 모바일환경에서 popup:false(기본값) 인 경우 필수
+    popup: false, // PC환경에서는 popup 파라미터가 무시되고 항상 true 로 적용됨
+  },
+  (rsp) => {
+    // callback
+    if (rsp.success) {
+      // 인증 성공 시 로직
+    } else {
+      // 인증 실패 시 로직
+    }
+  },
+);
+```
+
+</div>
+
+</div>