@portone/mcp-server 0.14.0 → 0.15.0-alpha.0

package/assets/docs/sdk/ko/v1-sdk/javascript-sdk/payrq.md

@@ -44,7 +44,7 @@ versionVariants:
   - `kicc`(이지페이(한국정보통신) 결제창 일반/정기결제)
   - `ksnet`(KSNET 결제창 일반결제 및 API 수기/정기결제)
   - `mobilians`(모빌리언스 결제창 일반/정기결제)
-  - `nice`(나이스페이먼츠(구모듈) 결제창 일반결제 및 API 수기/정기결제)
+  - `nice`(나이스정보통신(구모듈) 결제창 일반결제 및 API 수기/정기결제)
   - `nice_v2`(나이스페이(신모듈) 결제창 일반결제 및 API 수기/정기결제)
   - `settle`(헥토파이낸셜 결제창 일반결제 및 API 수기/정기결제)
   - `settle_acc` (헥토파이낸셜 내통장결제)
@@ -213,7 +213,7 @@ versionVariants:
 
   <summary>지원되는 PG사</summary>
 
-  - 나이스페이먼츠
+  - 나이스정보통신
   - (신) 토스페이
 
   </details>
@@ -289,7 +289,7 @@ versionVariants:
 
   [**confirm\_process**](https://developers.portone.io/opi/ko/extra/confirm-process/readme-v1) **에 사용할 고객사 endpoint URL**
 
-  - 사용 시 기술지원 메일로 별도 요청이 필요합니다. (<support@portone.io>)
+  - 사용 시 기술지원 메일로 별도 요청이 필요합니다. (<tech.support@portone.io>)
 
 - notice\_url?: string
 

package/assets/docs/sdk/ko/v1-sdk/javascript-sdk/payrt.md

@@ -21,7 +21,7 @@ PG사 또는 결제수단에 따라서 반환되는 속성들이 상이합니다
 <script src="https://cdn.iamport.kr/v1/iamport.js"></script>
 ```
 
-위 JS SDK 버전을 사용하면서 (신) 토스페이먼츠, (신) 스마트로, (신) 나이스페이먼츠, (신) 페이팔, KSNET, 웰컴페이먼츠 연동시에는
+위 JS SDK 버전을 사용하면서 (신) 토스페이먼츠, (신) 스마트로, (신) 나이스정보통신, (신) 페이팔, KSNET, 웰컴페이먼츠 연동시에는
 `imp_uid`, `merchant_uid`, `error_code`, `error_msg`만 제공됩니다.
 
 결제 실패 사유와 코드 확인을 위해서는 `error_code`, `error_msg` 파라미터를 참고해주세요.
@@ -132,7 +132,7 @@ PG사 또는 결제수단에 따라서 반환되는 속성들이 상이합니다
   - `kcp`(NHN KCP)
   - `kcp_billing`(NHN KCP 정기결제)
   - `uplus`((구) 토스페이먼츠(구 LG U+))
-  - `nice`((구) 나이스페이먼츠)
+  - `nice`((구) 나이스정보통신)
   - `kicc`(한국정보통신)
   - `kakaopay`(카카오페이)
   - `danal`(다날 휴대폰 소액결제)
@@ -153,7 +153,7 @@ PG사 또는 결제수단에 따라서 반환되는 속성들이 상이합니다
   - `daou`(키움페이 (구. 페이조아))
   - `tosspayments` ((신) 토스페이먼츠)
   - `paypal_v2`((신) 페이팔)
-  - `nice_v2`((신) 나이스페이먼츠)
+  - `nice_v2`((신) 나이스정보통신)
   - `smartro_v2`((신) 스마트로)
   - `toss_brandpay`(토스페이먼츠 브랜드페이)
   - `welcome` (웰컴페이먼츠)

package/assets/docs/sdk/ko/v2-sdk/_components/sdk-installation.md

@@ -0,0 +1,71 @@
+---
+title: V2 JavaScript SDK 설치하기
+description: 웹 브라우저에서 결제창 연동 시 사용되는 SDK 설치 방법을 안내합니다.
+targetVersions:
+  - v2
+---
+
+포트원 V2 SDK는 npm 레지스트리와 CDN을 통해 배포되고 있습니다.
+
+- npm, yarn 등 패키지 매니저를 사용한다면 의존
+  대상으로 [@portone/browser-sdk](https://www.npmjs.com/package/@portone/browser-sdk)를 추가하세요.
+
+- 패키지 매니저를 사용하지 않는다면 `<script>` 요소를 이용하여 CDN에서 SDK를 직접 불러오세요.
+
+- CDN에서 ESM 모듈 형태로도 SDK를 제공하고 있습니다.
+
+<div class="tabs-container">
+
+<div class="tabs-content" data-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";
+```
+
+</div>
+
+<div class="tabs-content" data-title="<script> 요소로 추가">
+
+```html
+<script src="https://cdn.portone.io/v2/browser-sdk.js"></script>
+```
+
+`<script>` 요소로 SDK를 불러온 경우 전역 객체 `window`에 `PortOne` 객체가 추가됩니다.
+
+</div>
+
+<div class="tabs-content" data-title="ESM 모듈로 추가">
+
+ESM 모듈을 사용하는 경우 URL에서 `PortOne` 객체를 직접 import할 수 있습니다.
+
+```javascript
+import * as PortOne from "https://cdn.portone.io/v2/browser-sdk.esm.js";
+```
+
+</div>
+
+</div>
+
+<div class="hint" data-style="info">
+
+**타입스크립트 지원**
+
+포트원 V2 SDK는 타입스크립트 선언 파일(`.d.ts`)의 형식으로 타입 정보를 제공하고 있습니다. npm 레지스트리를 이용하는 경우 각종 개발 환경에서 별도 설정 없이 사용 가능합니다.
+
+</div>

package/assets/docs/sdk/ko/v2-server-sdk/jvm.md

@@ -10,7 +10,9 @@ targetVersions:
 JVM 서버 환경에서 포트원 V2 결제 시스템에 연동하기 위한 SDK입니다. 코틀린,
 스칼라, 자바 등의 언어에서 사용할 수 있습니다.
 
-[API 색인](https://javadoc.io/doc/io.portone/server-sdk/latest/index.html)
+[API 색인]
+
+[API 색인]: https://javadoc.io/doc/io.portone/server-sdk/latest/index.html
 
 ## 의존성
 
@@ -32,7 +34,7 @@ classifier을 적용하여 shading 버전을 사용합니다.
 ```Gradle Kotlin DSL
 dependencies {
     implementation("io.portone:server-sdk:x.y.z")
-    
+
     // shading 버전의 경우
     implementation("io.portone:server-sdk:x.y.z:all")
 }
@@ -139,12 +141,17 @@ val webhook = webhookVerifier.verify(
 )
 ```
 
-`WebhookVerifier.verify` 메서드는 body를 Webhook 타입으로 변환하여 반환합니다.
+`WebhookVerifier.verify` 메서드는 body를 `Webhook` 타입으로 변환하여 반환합니다.
+
+수신한 웹훅이 어떤 이벤트에 대한 것인지는 타입을 체크하여 확인할 수 있습니다.
+가능한 타입의 목록은 [API 색인]에서 확인할 수 있습니다.
 
 ```kotlin
 println(webhook.data.paymentId) // Error: Unresolved reference 'data'.
-if (webhook is WebhookTransaction) {
-    println(webhook.data.paymentId)
+when (webhook) {
+    is WebhookTransaction -> println(webhook.data.paymentId)
+    is WebhookBillingKey -> println(webhook.data.billingKey)
+    else -> /* ... */
 }
 ```
 

package/assets/docs/sdk/ko/v2-server-sdk/python.md

@@ -9,7 +9,9 @@ targetVersions:
 
 Python 서버 환경에서 포트원 V2 결제 시스템에 연동하기 위한 SDK입니다.
 
-[API 색인](https://portone-io.github.io/server-sdk/py/)
+[API 색인]
+
+[API 색인]: https://portone-io.github.io/server-sdk/py/
 
 ## 의존성
 
@@ -111,13 +113,20 @@ headers = {
 webhook = portone.webhook.verify(PORTONE_WEBHOOK_SECRET, payload, headers)
 ```
 
-`webhook.verify` 함수는 웹훅 내용을 Webhook 타입으로 변환하여 반환합니다. 웹훅도
+`webhook.verify` 함수는 웹훅 내용을 `Webhook` 타입으로 변환하여 반환합니다. 웹훅도
 현재 SDK 버전에서 지원하지 않는 응답을 받을 수 있으며, 이 경우에는 웹훅을 그대로
 JSON 형식으로 파싱한 `dict` 값을 반환합니다.
 
+수신한 웹훅이 어떤 이벤트에 대한 것인지는 타입을 체크하여 확인할 수 있습니다.
+가능한 타입의 목록은 [API 색인]에서 확인할 수 있습니다.
+
 ```python
+# Transaction.Paid 웹훅인 경우
 if isinstance(webhook, portone.webhook.WebhookTransactionPaid):
-    print(webhook.data.paymentId)
+    print(f'Paid: {webhook.data.payment_id}')
+# BillingKey.Issued 웹훅인 경우
+if isinstance(webhook, portone.webhook.WebhookBillingKeyIssued):
+    print(f'Issued: {webhook.data.billing_key}')
 ```
 
 ## 버전