From 543a53a8876c96e49a5838b7775c2faca4e839e3 Mon Sep 17 00:00:00 2001
From: LimJiGyu <limjg25@gmail.com>
Date: Mon, 25 Mar 2024 15:10:39 +0900
Subject: [PATCH] feat: ESM url in v2-sdk readme & remove mention to
 access_token in v2

---
 src/content/docs/ko/ready/readme.mdx          |  53 +-
 .../_components/sdk-installation.mdx          |  61 +++
 src/content/docs/ko/v2-payment/authpay.mdx    |  62 +--
 .../v2-payment/v2-sdk/billing-key-request.mdx |   2 +-
 .../v2-sdk/billing-key-response.mdx           |   2 +-
 .../v2-sdk/identity-verification-request.mdx  | 518 +++++++++---------
 .../v2-sdk/identity-verification-response.mdx |   2 +-
 .../ko/v2-payment/v2-sdk/payment-request.mdx  |   2 +-
 .../ko/v2-payment/v2-sdk/payment-response.mdx |   2 +-
 .../docs/ko/v2-payment/v2-sdk/readme.mdx      |  40 +-
 10 files changed, 332 insertions(+), 412 deletions(-)
 create mode 100644 src/content/docs/ko/v2-payment/_components/sdk-installation.mdx

diff --git a/src/content/docs/ko/ready/readme.mdx b/src/content/docs/ko/ready/readme.mdx
index 0ab47ec62..98f1aecb3 100644
--- a/src/content/docs/ko/ready/readme.mdx
+++ b/src/content/docs/ko/ready/readme.mdx
@@ -11,7 +11,6 @@ import VersionGate from "~/components/gitbook/VersionGate.astro";
 import Hint from "~/components/Hint.astro";
 
 import image07 from "./_assets/apiver_v1.png";
-import apiVerV2 from "./_assets/apiver_v2.png";
 import image4 from "./_assets/apply1.png"
 import image01 from "./_assets/channel1.png";
 import image02 from "./_assets/channel2.png";
@@ -43,7 +42,6 @@ import image12 from "./_assets/pg/tosspayments.png";
 import image9 from "./_assets/pg/welcome.png";
 import image10 from "./_assets/pg/welcome1.png";
 import image2 from "./_assets/signup.png";
-import storeid from "./_assets/storeid.png";
 import IntegrationPaypalV2 from './_components/integration-guide/paypal-v2.mdx';
 import IntegrationTosspayments from './_components/integration-guide/tosspayments.mdx';
 
@@ -620,58 +618,11 @@ import IntegrationTosspayments from './_components/integration-guide/tosspayment
     <Hint style="info">
       **REST API Key, REST API Secret란?**
 
-      - V1 API 호출 시 사용되는 Access Token을 발급할 때 사용되는 값입니다.
-      - REST API Secret은 재발급이 가능하며, 재발급 즉시 기존의 Secret은 사용이 불가능합니다.
+      - API 호출 시 인증을 위해 필요한 값입니다. [인증 방식](https://developers.portone.io/api/rest-v2)을 참고해 주세요.
     </Hint>
 
     <Hint style="danger">
-      REST API Key, REST API Secret **결제 거래 건을 컨트롤할 수 있는 민감 정보**로 외부로 유출되지 않도록 주의가 필요합니다.
-    </Hint>
-  </Fragment>
-
-  <Fragment slot="v2">
-    ### 4-1. 스토어 아이디(Store ID) 복사하기
-
-    포트원을 이용한 결제 연동 시 필요한 스토어 아이디(Store ID)를 복사할 수 있습니다.
-
-    <Figure src={storeid} />
-
-    - 관리자 콘솔 화면에서 \[결제 연동] → \[연동 관리] 화면에서 스토어 아이디를 복사할 수 있습니다.
-
-    <Hint style="info">
-      **스토어 아이디(Store ID)란?**
-
-      - 포트원 가입 시 \[대표 상점]이 생성되며, 자동으로 생성되는 고유값 입니다.
-      - 추가로 하위 상점을 생성하는 경우 **상점마다 고유하게 부여**됩니다.
-      - 결제창 연동 시 사용되며, 결제 호출 시 `storeId` 파라미터에 해당 값을 넣어야 합니다.
-      - **기술 문의 시 해당 값을 공유**해 주시면 빠르게 문제 해결을 도와드릴 수 있습니다.
-    </Hint>
-
-    ### 4-2. V2 API Secret 발급하기
-
-    V2 API를 연동하기 위해서는 V2 API Secret을 별도로 발급한 후 사용이 가능합니다.
-
-    <Figure src={apiVerV2} />
-
-    - 관리자 콘솔 화면에서 \[결제연동] → \[연동 관리] → \[식별코드·API Keys] 메뉴에서 \[V2 API]를 선택합니다.
-    - `새로운 API Secret 발급`을 클릭합니다.
-    - Secret 목록에 표시될 `Secret 이름`을 입력하고 `만료 기한`을 선택한 후 `생성`을 클릭합니다.
-    - 생성된 Secret을 복사합니다. `API Secret을 확인했습니다`를 누른 후엔 Secret 값을 확인할 수 없으니 주의해 주세요.
-
-    <Hint style="danger">
-      API Secret 발급 직후에만 값을 확인할 수 있습니다. 페이지를 벗어나면 API Secret 확인이 불가하오니 복사한 후 임의의 장소에 저장하여 사용하세요.
-      만약, API Secret 값을 잊어버리신 경우 새로 발급받아 사용해야 합니다.
-    </Hint>
-
-    <Hint style="info">
-      **API Secret이란?**
-
-      - API 호출 시 사용되는 Access Token을 발급할 때 사용되는 값입니다.
-      - V2 API Secret을 발급받으신 후, 이를 이용해 [API Secret을 이용한 토큰 발급](/api/rest-v2/auth#post%20%2Flogin%2Fapi-secret) API를 호출하시면 <br /> **Access Token**을 발급받으실 수 있습니다.
-    </Hint>
-
-    <Hint style="danger">
-      API Secret은 **결제 거래 건을 컨트롤할 수 있는 민감 정보**로 외부로 유출되지 않도록 주의가 필요합니다.
+      - API Secret은 **결제 거래 건을 컨트롤할 수 있는 민감 정보**로 고객사 서버에서만 사용되어야 하며, 브라우저 등 외부에 노출되어서는 안 됩니다.
     </Hint>
   </Fragment>
 </VersionGate>
diff --git a/src/content/docs/ko/v2-payment/_components/sdk-installation.mdx b/src/content/docs/ko/v2-payment/_components/sdk-installation.mdx
new file mode 100644
index 000000000..6dc106a06
--- /dev/null
+++ b/src/content/docs/ko/v2-payment/_components/sdk-installation.mdx
@@ -0,0 +1,61 @@
+import Tab from "~/components/gitbook/tabs/Tab.astro";
+import Tabs from "~/components/gitbook/tabs/Tabs.astro";
+import Hint from "~/components/Hint.astro";
+import * as prose from '~/components/prose';
+
+export const components = prose;
+
+포트원 V2 SDK는 npm 레지스트리와 CDN을 통해 배포되고 있습니다.
+
+- npm, yarn 등 패키지 매니저를 사용한다면 의존
+  대상으로 [@portone/browser-sdk](https://www.npmjs.com/package/@portone/browser-sdk)를 추가하세요.
+
+- 패키지 매니저를 사용하지 않는다면 `<script>` 요소를 이용하여 CDN에서 SDK를 직접 불러오세요.
+
+- CDN에서 ESM 모듈 형태로도 SDK를 제공하고 있습니다.
+
+<Tabs>
+  <Tab title="패키지 의존 대상으로 추가">
+    사용하는 패키지 매니저에 알맞은 명령어를 실행하세요.
+
+    ```shell
+    npm i @portone/browser-sdk
+    ```
+
+    ```shell
+    yarn add @portone/browser-sdk
+    ```
+
+    ```shell
+    pnpm add @portone/browser-sdk
+    ```
+
+    패키지 매니저로 SDK를 불러온 경우 `PortOne` 객체를 import해서 사용합니다.
+
+    ```javascript
+    import * as PortOne from "@portone/browser-sdk/v2";
+    ```
+  </Tab>
+
+  <Tab title="<script> 요소로 추가">
+    ```html
+    <script src="https://cdn.portone.io/v2/browser-sdk.js"></script>
+    ```
+
+    `<script>` 요소로 SDK를 불러온 경우 전역 객체 `window`에 `PortOne` 객체가 추가됩니다.
+  </Tab>
+
+  <Tab title="ESM 모듈로 추가">
+    ESM 모듈을 사용하는 경우 URL에서 `PortOne` 객체를 직접 import할 수 있습니다.
+
+    ```javascript
+    import * as PortOne from "https://cdn.portone.io/v2/browser-sdk.esm.js";
+    ```
+  </Tab>
+</Tabs>
+
+<Hint style="info">
+  **타입스크립트 지원**
+
+  포트원 V2 SDK는 타입스크립트 선언 파일(`.d.ts`)의 형식으로 타입 정보를 제공하고 있습니다. npm 레지스트리를 이용하는 경우 각종 개발 환경에서 별도 설정 없이 사용 가능합니다.
+</Hint>
diff --git a/src/content/docs/ko/v2-payment/authpay.mdx b/src/content/docs/ko/v2-payment/authpay.mdx
index 3b98e6f84..4afc4a817 100644
--- a/src/content/docs/ko/v2-payment/authpay.mdx
+++ b/src/content/docs/ko/v2-payment/authpay.mdx
@@ -10,6 +10,8 @@ import Tab from "~/components/gitbook/tabs/Tab.astro";
 
 import Youtube from "~/components/gitbook/Youtube.astro";
 
+import SdkInstallation from "./_components/sdk-installation.mdx"
+
 <Details>
   <p slot="summary">
     <strong>영상으로 보기</strong>
@@ -24,65 +26,7 @@ import Youtube from "~/components/gitbook/Youtube.astro";
 
 포트원은 다양한 PG의 결제창을 통일된 방법으로 호출할 수 있도록 자바스크립트 SDK를 제공합니다. 브라우저에서 포트원 SDK를 호출하여 결제를 진행하게 됩니다.
 
-포트원 V2 SDK는 npm 레지스트리와 CDN을 통해 배포되고 있습니다.
-
-- npm, yarn 등 패키지 매니저를 사용한다면 의존 대상으로 [@portone/browser-sdk][npm-sdk]를 추가하세요.
-- 패키지 매니저를 사용하지 않는다면 `<script>` 요소를 이용하여 CDN에서 SDK를 직접 불러오세요.
-- CDN에서 ESM 모듈 형태로도 SDK를 제공하고 있습니다.
-
-[1]: https://www.npmjs.com/package/@portone/browser-sdk
-
-<Tabs>
-
-<Tab title="패키지 의존 대상으로 추가">
-
-사용하는 패키지 매니저에 알맞은 명령어를 실행하세요.
-
-```shell
-npm i @portone/browser-sdk
-```
-
-```shell
-yarn add @portone/browser-sdk
-```
-
-```shell
-pnpm add @portone/browser-sdk
-```
-
-패키지 매니저로 SDK를 불러온 경우 `PortOne` 객체를 import해서 사용합니다.
-
-```typescript
-import * as PortOne from "@portone/browser-sdk/v2";
-```
-
-</Tab>
-
-<Tab title="<script> 요소로 추가">
-```html
-<script src="https://cdn.portone.io/v2/browser-sdk.js"></script>
-```
-
-`<script>` 요소로 SDK를 불러온 경우 전역 객체 `window`에 `PortOne` 객체가 추가됩니다.
-
-</Tab>
-
-<Tab title="ESM 모듈로 추가">
-ESM 모듈을 사용하는 경우 URL에서 `PortOne` 객체를 직접 import할 수 있습니다.
-
-```javascript
-import * as PortOne from "https://cdn.portone.io/v2/browser-sdk.esm.js";
-```
-</Tab>
-
-</Tabs>
-
-<Hint style="info">
-**타입스크립트 지원**
-
-포트원 V2 SDK는 타입스크립트 선언 파일(`.d.ts`)의 형식으로 타입 정보를 제공하고 있습니다. npm 레지스트리를 이용하는 경우 각종 개발 환경에서 별도 설정 없이 사용 가능합니다.
-
-</Hint>
+<SdkInstallation />
 
 ## 2. 결제 요청
 
diff --git a/src/content/docs/ko/v2-payment/v2-sdk/billing-key-request.mdx b/src/content/docs/ko/v2-payment/v2-sdk/billing-key-request.mdx
index 2a80b159a..6096c5d0b 100644
--- a/src/content/docs/ko/v2-payment/v2-sdk/billing-key-request.mdx
+++ b/src/content/docs/ko/v2-payment/v2-sdk/billing-key-request.mdx
@@ -1,6 +1,6 @@
 ---
 title: 빌링키 발급 요청 파라미터
-description: 빌링키 발급 요청 파라미터를 확인 할 수 있습니다.
+description: 빌링키 발급 요청 파라미터를 확인할 수 있습니다.
 ---
 
 ## 빌링키 발급 요청 파라미터 정의
diff --git a/src/content/docs/ko/v2-payment/v2-sdk/billing-key-response.mdx b/src/content/docs/ko/v2-payment/v2-sdk/billing-key-response.mdx
index e2eb3926d..06020fd5d 100644
--- a/src/content/docs/ko/v2-payment/v2-sdk/billing-key-response.mdx
+++ b/src/content/docs/ko/v2-payment/v2-sdk/billing-key-response.mdx
@@ -1,6 +1,6 @@
 ---
 title: 빌링키 발급 응답 파라미터
-description: 빌링키 발급 응답 파라미터를 확인 할 수 있습니다.
+description: 빌링키 발급 응답 파라미터를 확인할 수 있습니다.
 ---
 
 ## 빌링키 발급 응답 파라미터 정의
diff --git a/src/content/docs/ko/v2-payment/v2-sdk/identity-verification-request.mdx b/src/content/docs/ko/v2-payment/v2-sdk/identity-verification-request.mdx
index 65a373d93..1e4765b4b 100644
--- a/src/content/docs/ko/v2-payment/v2-sdk/identity-verification-request.mdx
+++ b/src/content/docs/ko/v2-payment/v2-sdk/identity-verification-request.mdx
@@ -1,6 +1,6 @@
 ---
 title: 본인인증 요청 파라미터
-description: 본인인증 요청 파라미터를 확인 할 수 있습니다.
+description: 본인인증 요청 파라미터를 확인할 수 있습니다.
 ---
 
 ## 본인인증 요청 파라미터 정의
@@ -36,11 +36,9 @@ description: 본인인증 요청 파라미터를 확인 할 수 있습니다.
 > 가능한 PG사 코드는 아래를 참고해주세요.
 >
 > <details>
+>   <summary>PG사 코드</summary>
 >
-> <summary>PG사 코드</summary>
->
-> - `DANAL`
->
+>   - `DANAL`
 > </details>
 
 ### **`isTestChannel`** <mark style="color:orange;background-color:yellow;">**boolean**</mark>
@@ -95,260 +93,259 @@ description: 본인인증 요청 파라미터를 확인 할 수 있습니다.
 > > > **`country`** <mark style="color:purple;">**string**</mark>
 > > >
 > > > **국가**
-> > > <details>
 > > >
-> > > <summary>국가 코드 확인하기</summary>
-> > >
-> > > - AF(Afghanistan)
-> > > - AX(Åland Islands)
-> > > - AL(Albania)
-> > > - DZ(Algeria)
-> > > - AS(American Samoa)
-> > > - AD(Andorra)
-> > > - AO(Angola)
-> > > - AI(Anguilla)
-> > > - AQ(Antarctica)
-> > > - AG(Antigua and Barbuda)
-> > > - AR(Argentina)
-> > > - AM(Armenia)
-> > > - AW(Aruba)
-> > > - AU(Australia)
-> > > - AT(Austria)
-> > > - AZ(Azerbaijan)
-> > > - BH(Bahrain)
-> > > - BS(Bahamas)
-> > > - BD(Bangladesh)
-> > > - BB(Barbados)
-> > > - BY(Belarus)
-> > > - BE(Belgium)
-> > > - BZ(Belize)
-> > > - BJ(Benin)
-> > > - BM(Bermuda)
-> > > - BT(Bhutan)
-> > > - BO(Bolivia, Plurinational State of)
-> > > - BQ(Bonaire, Sint Eustatius and Saba)
-> > > - BA(Bosnia and Herzegovina)
-> > > - BW(Botswana)
-> > > - BV(Bouvet Island)
-> > > - BR(Brazil)
-> > > - IO(British Indian Ocean Territory)
-> > > - BN(Brunei Darussalam)
-> > > - BG(Bulgaria)
-> > > - BF(Burkina Faso)
-> > > - BI(Burundi)
-> > > - KH(Cambodia)
-> > > - CM(Cameroon)
-> > > - CA(Canada)
-> > > - CV(Cape Verde)
-> > > - KY(Cayman Islands)
-> > > - CF(Central African Republic)
-> > > - TD(Chad)
-> > > - CL(Chile)
-> > > - CN(China)
-> > > - CX(Christmas Island)
-> > > - CC(Cocos (Keeling) Islands)
-> > > - CO(Colombia)
-> > > - KM(Comoros)
-> > > - CG(Congo)
-> > > - CD(Congo, the Democratic Republic of the)
-> > > - CK(Cook Islands)
-> > > - CR(Costa Rica)
-> > > - CI(Côte d'Ivoire)
-> > > - HR(Croatia)
-> > > - CU(Cuba)
-> > > - CW(Curaçao)
-> > > - CY(Cyprus)
-> > > - CZ(Czech Republic)
-> > > - DK(Denmark)
-> > > - DJ(Djibouti)
-> > > - DM(Dominica)
-> > > - DO(Dominican Republic)
-> > > - EC(Ecuador)
-> > > - EG(Egypt)
-> > > - SV(El Salvador)
-> > > - GQ(Equatorial Guinea)
-> > > - ER(Eritrea)
-> > > - EE(Estonia)
-> > > - ET(Ethiopia)
-> > > - FK(Falkland Islands (Malvinas))
-> > > - FO(Faroe Islands)
-> > > - FJ(Fiji)
-> > > - FI(Finland)
-> > > - FR(France)
-> > > - GF(French Guiana)
-> > > - PF(French Polynesia)
-> > > - TF(French Southern Territories)
-> > > - GA(Gabon)
-> > > - GM(Gambia)
-> > > - GE(Georgia)
-> > > - DE(Germany)
-> > > - GH(Ghana)
-> > > - GI(Gibraltar)
-> > > - GR(Greece)
-> > > - GL(Greenland)
-> > > - GD(Grenada)
-> > > - GP(Guadeloupe)
-> > > - GU(Guam)
-> > > - GT(Guatemala)
-> > > - GG(Guernsey)
-> > > - GN(Guinea)
-> > > - GW(Guinea-Bissau)
-> > > - GY(Guyana)
-> > > - HT(Haiti)
-> > > - HM(Heard Island and McDonald Islands)
-> > > - VA(Holy See (Vatican City State))
-> > > - HN(Honduras)
-> > > - HK(Hong Kong)
-> > > - HU(Hungary)
-> > > - IS(Iceland)
-> > > - IN(India)
-> > > - ID(Indonesia)
-> > > - IR(Iran, Islamic Republic of)
-> > > - IQ(Iraq)
-> > > - IE(Ireland)
-> > > - IM(Isle of Man)
-> > > - IL(Israel)
-> > > - IT(Italy)
-> > > - JM(Jamaica)
-> > > - JP(Japan)
-> > > - JE(Jersey)
-> > > - JO(Jordan)
-> > > - KZ(Kazakhstan)
-> > > - KE(Kenya)
-> > > - KI(Kiribati)
-> > > - KP(Korea, Democratic People's Republic of)
-> > > - KR(Korea, Republic of)
-> > > - KW(Kuwait)
-> > > - KG(Kyrgyzstan)
-> > > - LA(Lao People's Democratic Republic)
-> > > - LV(Latvia)
-> > > - LB(Lebanon)
-> > > - LS(Lesotho)
-> > > - LR(Liberia)
-> > > - LY(Libya)
-> > > - LI(Liechtenstein)
-> > > - LT(Lithuania)
-> > > - LU(Luxembourg)
-> > > - MO(Macao)
-> > > - MK(Macedonia, the Former Yugoslav Republic of)
-> > > - MG(Madagascar)
-> > > - MW(Malawi)
-> > > - MY(Malaysia)
-> > > - MV(Maldives)
-> > > - ML(Mali)
-> > > - MT(Malta)
-> > > - MH(Marshall Islands)
-> > > - MQ(Martinique)
-> > > - MR(Mauritania)
-> > > - MU(Mauritius)
-> > > - YT(Mayotte)
-> > > - MX(Mexico)
-> > > - FM(Micronesia, Federated States of)
-> > > - MD(Moldova, Republic of)
-> > > - MC(Monaco)
-> > > - MN(Mongolia)
-> > > - ME(Montenegro)
-> > > - MS(Montserrat)
-> > > - MA(Morocco)
-> > > - MZ(Mozambique)
-> > > - MM(Myanmar)
-> > > - NA(Namibia)
-> > > - NR(Nauru)
-> > > - NP(Nepal)
-> > > - NL(Netherlands)
-> > > - NC(New Caledonia)
-> > > - NZ(New Zealand)
-> > > - NI(Nicaragua)
-> > > - NE(Niger)
-> > > - NG(Nigeria)
-> > > - NU(Niue)
-> > > - NF(Norfolk Island)
-> > > - MP(Northern Mariana Islands)
-> > > - NO(Norway)
-> > > - OM(Oman)
-> > > - PK(Pakistan)
-> > > - PW(Palau)
-> > > - PS(Palestine, State of)
-> > > - OA(Panama)
-> > > - PG(Papua New Guinea)
-> > > - PY(Paraguay)
-> > > - PE(Peru)
-> > > - PH(Philippines)
-> > > - PN(Pitcairn)
-> > > - PL(Poland)
-> > > - PT(Portugal)
-> > > - PR(Puerto Rico)
-> > > - QA(Qatar)
-> > > - RE(Réunion)
-> > > - RO(Romania)
-> > > - RU(Russian Federation)
-> > > - RW(Rwanda)
-> > > - BL(Saint Barthélemy)
-> > > - SH(Saint Helena, Ascension and Tristan da Cunha)
-> > > - KN(Saint Kitts and Nevis)
-> > > - LC(Saint Lucia)
-> > > - MF(Saint Martin (French part))
-> > > - PM(Saint Pierre and Miquelon)
-> > > - VC(Saint Vincent and the Grenadines)
-> > > - WS(Samoa)
-> > > - SM(San Marino)
-> > > - ST(Sao Tome and Principe)
-> > > - SA(Saudi Arabia)
-> > > - SN(Senegal)
-> > > - RS(Serbia)
-> > > - SC(Seychelles)
-> > > - SL(Sierra Leone)
-> > > - SG(Singapore)
-> > > - SX(Sint Maarten (Dutch part))
-> > > - SK(Slovakia)
-> > > - SI(Slovenia)
-> > > - SB(Solomon Islands)
-> > > - SO(Somalia)
-> > > - ZA(South Africa)
-> > > - GS(South Georgia and the South Sandwich Islands)
-> > > - SS(South Sudan)
-> > > - ES(Spain)
-> > > - LK(Sri Lanka)
-> > > - SD(Sudan)
-> > > - SR(Suriname)
-> > > - SJ(Svalbard and Jan Mayen)
-> > > - SZ(Swaziland)
-> > > - SE(Sweden)
-> > > - CH(Switzerland)
-> > > - SY(Syrian Arab Republic)
-> > > - TW(Taiwan, Province of China)
-> > > - TJ(Tajikistan)
-> > > - TZ(Tanzania, United Republic of)
-> > > - TH(Thailand)
-> > > - TL(Timor-Leste)
-> > > - TG(Togo)
-> > > - TK(Tokelau)
-> > > - TO(Tonga)
-> > > - TT(Trinidad and Tobago)
-> > > - TN(Tunisia)
-> > > - TR(Turkey)
-> > > - TM(Turkmenistan)
-> > > - TC(Turks and Caicos Islands)
-> > > - TV(Tuvalu)
-> > > - UG(Uganda)
-> > > - UA(Ukraine)
-> > > - AE(United Arab Emirates)
-> > > - GB(United Kingdom)
-> > > - US(United States)
-> > > - UM(United States Minor Outlying Islands)
-> > > - UY(Uruguay)
-> > > - UZ(Uzbekistan)
-> > > - VU(Vanuatu)
-> > > - VE(Venezuela, Bolivarian Republic of)
-> > > - VN(Viet Nam)
-> > > - VG(Virgin Islands, British)
-> > > - VI(Virgin Islands, U.S.)
-> > > - WF(Wallis and Futuna)
-> > > - EH(Western Sahara)
-> > > - YE(Yemen)
-> > > - ZM(Zambia)
-> > > - ZW(Zimbabwe)
+> > > <details>
+> > >   <summary>국가 코드 확인하기</summary>
 > > >
+> > >   - AF(Afghanistan)
+> > >   - AX(Åland Islands)
+> > >   - AL(Albania)
+> > >   - DZ(Algeria)
+> > >   - AS(American Samoa)
+> > >   - AD(Andorra)
+> > >   - AO(Angola)
+> > >   - AI(Anguilla)
+> > >   - AQ(Antarctica)
+> > >   - AG(Antigua and Barbuda)
+> > >   - AR(Argentina)
+> > >   - AM(Armenia)
+> > >   - AW(Aruba)
+> > >   - AU(Australia)
+> > >   - AT(Austria)
+> > >   - AZ(Azerbaijan)
+> > >   - BH(Bahrain)
+> > >   - BS(Bahamas)
+> > >   - BD(Bangladesh)
+> > >   - BB(Barbados)
+> > >   - BY(Belarus)
+> > >   - BE(Belgium)
+> > >   - BZ(Belize)
+> > >   - BJ(Benin)
+> > >   - BM(Bermuda)
+> > >   - BT(Bhutan)
+> > >   - BO(Bolivia, Plurinational State of)
+> > >   - BQ(Bonaire, Sint Eustatius and Saba)
+> > >   - BA(Bosnia and Herzegovina)
+> > >   - BW(Botswana)
+> > >   - BV(Bouvet Island)
+> > >   - BR(Brazil)
+> > >   - IO(British Indian Ocean Territory)
+> > >   - BN(Brunei Darussalam)
+> > >   - BG(Bulgaria)
+> > >   - BF(Burkina Faso)
+> > >   - BI(Burundi)
+> > >   - KH(Cambodia)
+> > >   - CM(Cameroon)
+> > >   - CA(Canada)
+> > >   - CV(Cape Verde)
+> > >   - KY(Cayman Islands)
+> > >   - CF(Central African Republic)
+> > >   - TD(Chad)
+> > >   - CL(Chile)
+> > >   - CN(China)
+> > >   - CX(Christmas Island)
+> > >   - CC(Cocos (Keeling) Islands)
+> > >   - CO(Colombia)
+> > >   - KM(Comoros)
+> > >   - CG(Congo)
+> > >   - CD(Congo, the Democratic Republic of the)
+> > >   - CK(Cook Islands)
+> > >   - CR(Costa Rica)
+> > >   - CI(Côte d'Ivoire)
+> > >   - HR(Croatia)
+> > >   - CU(Cuba)
+> > >   - CW(Curaçao)
+> > >   - CY(Cyprus)
+> > >   - CZ(Czech Republic)
+> > >   - DK(Denmark)
+> > >   - DJ(Djibouti)
+> > >   - DM(Dominica)
+> > >   - DO(Dominican Republic)
+> > >   - EC(Ecuador)
+> > >   - EG(Egypt)
+> > >   - SV(El Salvador)
+> > >   - GQ(Equatorial Guinea)
+> > >   - ER(Eritrea)
+> > >   - EE(Estonia)
+> > >   - ET(Ethiopia)
+> > >   - FK(Falkland Islands (Malvinas))
+> > >   - FO(Faroe Islands)
+> > >   - FJ(Fiji)
+> > >   - FI(Finland)
+> > >   - FR(France)
+> > >   - GF(French Guiana)
+> > >   - PF(French Polynesia)
+> > >   - TF(French Southern Territories)
+> > >   - GA(Gabon)
+> > >   - GM(Gambia)
+> > >   - GE(Georgia)
+> > >   - DE(Germany)
+> > >   - GH(Ghana)
+> > >   - GI(Gibraltar)
+> > >   - GR(Greece)
+> > >   - GL(Greenland)
+> > >   - GD(Grenada)
+> > >   - GP(Guadeloupe)
+> > >   - GU(Guam)
+> > >   - GT(Guatemala)
+> > >   - GG(Guernsey)
+> > >   - GN(Guinea)
+> > >   - GW(Guinea-Bissau)
+> > >   - GY(Guyana)
+> > >   - HT(Haiti)
+> > >   - HM(Heard Island and McDonald Islands)
+> > >   - VA(Holy See (Vatican City State))
+> > >   - HN(Honduras)
+> > >   - HK(Hong Kong)
+> > >   - HU(Hungary)
+> > >   - IS(Iceland)
+> > >   - IN(India)
+> > >   - ID(Indonesia)
+> > >   - IR(Iran, Islamic Republic of)
+> > >   - IQ(Iraq)
+> > >   - IE(Ireland)
+> > >   - IM(Isle of Man)
+> > >   - IL(Israel)
+> > >   - IT(Italy)
+> > >   - JM(Jamaica)
+> > >   - JP(Japan)
+> > >   - JE(Jersey)
+> > >   - JO(Jordan)
+> > >   - KZ(Kazakhstan)
+> > >   - KE(Kenya)
+> > >   - KI(Kiribati)
+> > >   - KP(Korea, Democratic People's Republic of)
+> > >   - KR(Korea, Republic of)
+> > >   - KW(Kuwait)
+> > >   - KG(Kyrgyzstan)
+> > >   - LA(Lao People's Democratic Republic)
+> > >   - LV(Latvia)
+> > >   - LB(Lebanon)
+> > >   - LS(Lesotho)
+> > >   - LR(Liberia)
+> > >   - LY(Libya)
+> > >   - LI(Liechtenstein)
+> > >   - LT(Lithuania)
+> > >   - LU(Luxembourg)
+> > >   - MO(Macao)
+> > >   - MK(Macedonia, the Former Yugoslav Republic of)
+> > >   - MG(Madagascar)
+> > >   - MW(Malawi)
+> > >   - MY(Malaysia)
+> > >   - MV(Maldives)
+> > >   - ML(Mali)
+> > >   - MT(Malta)
+> > >   - MH(Marshall Islands)
+> > >   - MQ(Martinique)
+> > >   - MR(Mauritania)
+> > >   - MU(Mauritius)
+> > >   - YT(Mayotte)
+> > >   - MX(Mexico)
+> > >   - FM(Micronesia, Federated States of)
+> > >   - MD(Moldova, Republic of)
+> > >   - MC(Monaco)
+> > >   - MN(Mongolia)
+> > >   - ME(Montenegro)
+> > >   - MS(Montserrat)
+> > >   - MA(Morocco)
+> > >   - MZ(Mozambique)
+> > >   - MM(Myanmar)
+> > >   - NA(Namibia)
+> > >   - NR(Nauru)
+> > >   - NP(Nepal)
+> > >   - NL(Netherlands)
+> > >   - NC(New Caledonia)
+> > >   - NZ(New Zealand)
+> > >   - NI(Nicaragua)
+> > >   - NE(Niger)
+> > >   - NG(Nigeria)
+> > >   - NU(Niue)
+> > >   - NF(Norfolk Island)
+> > >   - MP(Northern Mariana Islands)
+> > >   - NO(Norway)
+> > >   - OM(Oman)
+> > >   - PK(Pakistan)
+> > >   - PW(Palau)
+> > >   - PS(Palestine, State of)
+> > >   - OA(Panama)
+> > >   - PG(Papua New Guinea)
+> > >   - PY(Paraguay)
+> > >   - PE(Peru)
+> > >   - PH(Philippines)
+> > >   - PN(Pitcairn)
+> > >   - PL(Poland)
+> > >   - PT(Portugal)
+> > >   - PR(Puerto Rico)
+> > >   - QA(Qatar)
+> > >   - RE(Réunion)
+> > >   - RO(Romania)
+> > >   - RU(Russian Federation)
+> > >   - RW(Rwanda)
+> > >   - BL(Saint Barthélemy)
+> > >   - SH(Saint Helena, Ascension and Tristan da Cunha)
+> > >   - KN(Saint Kitts and Nevis)
+> > >   - LC(Saint Lucia)
+> > >   - MF(Saint Martin (French part))
+> > >   - PM(Saint Pierre and Miquelon)
+> > >   - VC(Saint Vincent and the Grenadines)
+> > >   - WS(Samoa)
+> > >   - SM(San Marino)
+> > >   - ST(Sao Tome and Principe)
+> > >   - SA(Saudi Arabia)
+> > >   - SN(Senegal)
+> > >   - RS(Serbia)
+> > >   - SC(Seychelles)
+> > >   - SL(Sierra Leone)
+> > >   - SG(Singapore)
+> > >   - SX(Sint Maarten (Dutch part))
+> > >   - SK(Slovakia)
+> > >   - SI(Slovenia)
+> > >   - SB(Solomon Islands)
+> > >   - SO(Somalia)
+> > >   - ZA(South Africa)
+> > >   - GS(South Georgia and the South Sandwich Islands)
+> > >   - SS(South Sudan)
+> > >   - ES(Spain)
+> > >   - LK(Sri Lanka)
+> > >   - SD(Sudan)
+> > >   - SR(Suriname)
+> > >   - SJ(Svalbard and Jan Mayen)
+> > >   - SZ(Swaziland)
+> > >   - SE(Sweden)
+> > >   - CH(Switzerland)
+> > >   - SY(Syrian Arab Republic)
+> > >   - TW(Taiwan, Province of China)
+> > >   - TJ(Tajikistan)
+> > >   - TZ(Tanzania, United Republic of)
+> > >   - TH(Thailand)
+> > >   - TL(Timor-Leste)
+> > >   - TG(Togo)
+> > >   - TK(Tokelau)
+> > >   - TO(Tonga)
+> > >   - TT(Trinidad and Tobago)
+> > >   - TN(Tunisia)
+> > >   - TR(Turkey)
+> > >   - TM(Turkmenistan)
+> > >   - TC(Turks and Caicos Islands)
+> > >   - TV(Tuvalu)
+> > >   - UG(Uganda)
+> > >   - UA(Ukraine)
+> > >   - AE(United Arab Emirates)
+> > >   - GB(United Kingdom)
+> > >   - US(United States)
+> > >   - UM(United States Minor Outlying Islands)
+> > >   - UY(Uruguay)
+> > >   - UZ(Uzbekistan)
+> > >   - VU(Vanuatu)
+> > >   - VE(Venezuela, Bolivarian Republic of)
+> > >   - VN(Viet Nam)
+> > >   - VG(Virgin Islands, British)
+> > >   - VI(Virgin Islands, U.S.)
+> > >   - WF(Wallis and Futuna)
+> > >   - EH(Western Sahara)
+> > >   - YE(Yemen)
+> > >   - ZM(Zambia)
+> > >   - ZW(Zimbabwe)
 > > > </details>
 > > >
 > > > **`addressLine1`** <mark style="color:red;">**\***</mark> <mark style="color:purple;">**string**</mark>
@@ -366,7 +363,6 @@ description: 본인인증 요청 파라미터를 확인 할 수 있습니다.
 > > > **`province`** <mark style="color:purple;">**string**</mark>
 > > >
 > > > **주, 도, 시**
-> > >
 > >
 > > **`zipcode`** <mark style="color:green;">**string**</mark>
 > >
@@ -403,6 +399,7 @@ description: 본인인증 요청 파라미터를 확인 할 수 있습니다.
 > - PG사에 따라 가능한 본인인증 창 유형이 다릅니다.
 > - 전달되지 않았을 때 결정되는 기본 본인인증 창이 다릅니다.
 > - 미입력 시, 해당 PG사의 기본 본인인증 창 방식을 따릅니다.
+
 > > **`pc`** <mark style="color:green;">**string**</mark>
 > >
 > > **PC에서의 본인인증 창 유형** `IFRAME`, `REDIRECTION`, `POPUP` 중 하나를 입력해주세요.
@@ -438,9 +435,8 @@ description: 본인인증 요청 파라미터를 확인 할 수 있습니다.
 > > > - 본인확인 기능을 앱에서만 사용하는 경우 서비스 홈 URL 입력. Ex) `m.login.MarketC.co.kr`
 > > > - 본인확인 기능을 사용하는 웹 페이지가 존재할 경우 해당 URL 입력. Ex) `www.MarketA.co.kr`
 > > > - 웹 서비스 URL 자체가 존재하지 않는 경우 서비스 이름 (app 이름) 입력. Ex) `마켓A`
-> > >
-> > > 해당 값을 넘기지 않을 경우 `포트원`으로 default 값을 채웁니다.
-> > >
+> > > - 해당 값을 넘기지 않을 경우 `포트원`으로 default 값을 채웁니다.
+
 > > > **`AGELIMIT`** <mark style="color:green;">**number**</mark>
 > > >
 > > > 본인인증을 진행할 수 있는 최소 나이
diff --git a/src/content/docs/ko/v2-payment/v2-sdk/identity-verification-response.mdx b/src/content/docs/ko/v2-payment/v2-sdk/identity-verification-response.mdx
index a96da845b..409696694 100644
--- a/src/content/docs/ko/v2-payment/v2-sdk/identity-verification-response.mdx
+++ b/src/content/docs/ko/v2-payment/v2-sdk/identity-verification-response.mdx
@@ -1,6 +1,6 @@
 ---
 title: 본인인증 응답 파라미터
-description: 본인인증 응답 파라미터를 확인 할 수 있습니다.
+description: 본인인증 응답 파라미터를 확인할 수 있습니다.
 ---
 
 ## 본인인증 응답 파라미터 정의
diff --git a/src/content/docs/ko/v2-payment/v2-sdk/payment-request.mdx b/src/content/docs/ko/v2-payment/v2-sdk/payment-request.mdx
index 7cee113e8..1553f7f2b 100644
--- a/src/content/docs/ko/v2-payment/v2-sdk/payment-request.mdx
+++ b/src/content/docs/ko/v2-payment/v2-sdk/payment-request.mdx
@@ -1,6 +1,6 @@
 ---
 title: 결제요청 파라미터
-description: 결제요청 파라미터를 확인 할 수 있습니다.
+description: 결제요청 파라미터를 확인할 수 있습니다.
 ---
 
 ## 결제요청 파라미터 정의
diff --git a/src/content/docs/ko/v2-payment/v2-sdk/payment-response.mdx b/src/content/docs/ko/v2-payment/v2-sdk/payment-response.mdx
index 74d3726c8..ff40c6e6b 100644
--- a/src/content/docs/ko/v2-payment/v2-sdk/payment-response.mdx
+++ b/src/content/docs/ko/v2-payment/v2-sdk/payment-response.mdx
@@ -1,6 +1,6 @@
 ---
 title: 결제응답 파라미터
-description: 결제응답 파라미터를 확인 할 수 있습니다.
+description: 결제응답 파라미터를 확인할 수 있습니다.
 ---
 
 ## 결제응답 파라미터 정의
diff --git a/src/content/docs/ko/v2-payment/v2-sdk/readme.mdx b/src/content/docs/ko/v2-payment/v2-sdk/readme.mdx
index 5aa49b3ba..56f4c5aca 100644
--- a/src/content/docs/ko/v2-payment/v2-sdk/readme.mdx
+++ b/src/content/docs/ko/v2-payment/v2-sdk/readme.mdx
@@ -1,40 +1,8 @@
 ---
-title: JavaScript SDK 연동하기
-description: 결제창 연동시 호출 및 응답 파라미터를 확인할 수 있습니다.
+title: JavaScript SDK 레퍼런스
+description: 결제창 연동시 사용되는 SDK에 대한 설명 문서입니다.
 ---
 
-import Hint from "~/components/Hint.astro";
-import Tab from "~/components/gitbook/tabs/Tab.astro";
-import Tabs from "~/components/gitbook/tabs/Tabs.astro";
+import SdkInstallation from '../_components/sdk-installation.mdx';
 
-<Hint style="info">
-이 문서는 V2 SDK 연동을 위한 문서로 [v2](../v2 "mention")을 먼저 읽으시길 권장드립니다.
-
-</Hint>
-
-고객사 프로젝트 설정에 따라 설치 방법을 선택할 수 있습니다.
-
-- NPM 의존성이 사용 가능한 경우 NPM으로 배포된 SDK를 설치하세요.
-- HTML `<script>` 태그를 이용하는 경우 결제창 연동을 진행할 주문 페이지에 SDK를 설치하세요.
-
-<Tabs>
-<Tab title="NPM 패키지로 추가">
-NPM 이나 yarn 패키지 매니저를 이용해 포트원 SDK를 설치할 수 있습니다.
-
-```shell
-npm i @portone/browser-sdk
-```
-
-```shell
-yarn add @portone/browser-sdk
-```
-
-</Tab>
-
-<Tab title="<script> 태그로 추가">
-```html
-<script src="https://cdn.portone.io/v2/browser-sdk.js"></script>
-```
-
-</Tab>
-</Tabs>
+<SdkInstallation />