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

package/assets/docs/opi/ko/integration/pg/v2/payletter-global.md

@@ -23,9 +23,16 @@ targetVersions:
     - 해외카드 비인증 : `PLCreditCard`
     - 해외카드 인증(3DS) : `PLCreditCardMpi`
     - 유니온페이 : `PLUnionPay_HC`
-    - 위챗페이 PC결제: `WeChatPayQRCodePayment`
+    - 위챗페이 PC결제 : `WeChatPayQRCodePayment`
     - 위챗페이 모바일결제 : `WeChatPayH5Payment`
     - 알리페이 : `ICBAlipay`
+    - 알리페이 HK (알리페이+) : `AlipayPlusAlipayHK`
+    - BPI (알리페이+) : `AlipayPlusBPI`
+    - Dana (알리페이+) : `AlipayPlusDana`
+    - GCash (알리페이+) : `AlipayPlusGcash`
+    - Rabbit LINE Pay (알리페이+) : `AlipayPlusRabbitLinePay`
+    - Touch 'n Go (알리페이+) : `AlipayPlusTNG`
+    - TrueMoney (알리페이+) : `AlipayPlusTrueMoney`
 
 ## SDK 결제 요청하기
 
@@ -54,9 +61,16 @@ targetVersions:
 빌링키 발급 및 결제 요청 시에는 [requestIssueBillingKeyAndPay](https://developers.portone.io/sdk/ko/v2-sdk/billing-key-and-pay-request?v=v2) 함수를 호출해야 합니다.
 `channelKey` 파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여 페이레터 해외결제 채널 사용을 명시해주세요.
 
+## 결제수단별 승인 가능 통화
+
+- 카드: `KRW`, `USD`, `JPY`
+- Alipay: `USD`, `CNY`
+- Alipay+: `USD`
+- WeChatPay: `KRW`, `USD`, `CNY`
+
 ## 유의사항
 
 - `paymentId` 에는 영문, 숫자만으로 이루어진 문자열만 입력할 수 있습니다.
 - 페이레터의 경우 구매자 이메일을 필수로 받고있어,`customer.email`을 필수로 입력하셔야 합니다.
-- 해외결제시 카드는 `KRW`, `USD`, `JPY`, 알리페이⋅위챗페이는 `CNY`를 지원합니다.
-- WeChatPay, Alipay 결제 시 `bypass.payletter_global.servicename` 파라미터를 필수로 입력하셔야 합니다.
+- WeChatPay, Alipay, Alipay+ 결제 시 `bypass.payletter_global.servicename` 파라미터를 필수로 입력하셔야 합니다.
+- 페이레터의 경우 결제창을 닫은 이후에 결제가 성공 처리될 수 있습니다. 웹훅을 연동하여 결제 실패 상태에서 결제 성공 상태로 바뀌는 경우를 처리해야 합니다.

package/assets/docs/opi/ko/integration/pg/v2/paypal-v2.md

@@ -289,33 +289,34 @@ STC 기능을 사용하기 위해 다음 정보를 확인해 주세요.
 // 해당 파라미터들은 예시로 산업군에 따라 추가 또는 제외 가능한 파라미터들이 있습니다.
 _({
   additional_data: [
+    // 상점의 구매자 계정 기준으로 정보 입력
     {
-      key: "sender_account_id", // 고객사 account ID(merchant-id)
+      key: "sender_account_id", // 구매자 계정 ID
       value: "A12345N343",
     },
     {
-      key: "sender_first_name", // 고객사의 account에 등록된 구매자의 이름
+      key: "sender_first_name", // 구매자 이름
       value: "John",
     },
     {
-      key: "sender_last_name", // 고객사의 account에 등록된 구매자의 이름
+      key: "sender_last_name", // 구매자 성
       value: "Doe",
     },
     {
-      key: "sender_email", // 고객사의 account에 등록된 구매자의 이메일 주소
+      key: "sender_email", // 구매자 이메일 주소
       value: "example@example.com",
     },
     {
-      key: "sender_phone", // 고객사의 account에 등록된 구매자의 연락처
+      key: "sender_phone", // 구매자 휴대전화 번호
       value: "(02)16705176",
     },
     {
-      key: "sender_country_code", // 고객사의 account에 등록된 국가 코드
-      value: "KR", // ISO Alpha-2 형식 국가 코드
+      key: "sender_country_code", // 구매자 국가 코드
+      value: "KR", // ISO 3166-2 alpha-2 코드
     },
     {
-      key: "sender_create_date", // 고객사의 account에 등록된 국가 코드
-      value: "2023-10-10T23:59:59+09:00", // IOS8601 형식
+      key: "sender_create_date", // 구매자 계정 생성 시각
+      value: "2023-10-10T23:59:59+09:00", // RFC 3339 형식
     },
   ],
 });
@@ -1759,7 +1760,7 @@ Pay Later(할부) 기능을 여러 국가에 제공하기 위해서는 **페이
 페이팔은 이상 거래를 줄이기 위해 Risk Data Acquisition 정책을 시행하고 있습니다.
 일반적으로 페이팔 창에서 진행되는 결제나 빌링키 발급은 페이팔이 구매자 접속 정보를 직접 확인하여 이상 거래를 판단합니다.
 
-하지만 발급된 빌링키로 브라우저에서 재결제하는 경우 \[고객사 브라우저]에서 \[포트원 API]를 통해 \[페이팔 API]가 호출되는 구조로 페이팔이 구매자 접속 정보를 직접 확인할 수 없어 이상거래를 판단하기 어렵습니다.
+하지만 발급된 빌링키로 브라우저에서 결제하는 경우 \[고객사 브라우저]에서 \[포트원 API]를 통해 \[페이팔 API]가 호출되는 구조로 페이팔이 구매자 접속 정보를 직접 확인할 수 없어 이상거래를 판단하기 어렵습니다.
 따라서 구매자의 브라우저/디바이스 접속 정보를 페이팔에 전달해야 합니다.
 때문에 브라우저에서 발급된 빌링키를 이용하여 결제를 호출하는 경우 **고객사 클라이언트 페이지에 페이팔 Fraudnet 스크립트/Magnes SDK를 반드시 추가해야** 합니다.
 
@@ -1824,7 +1825,7 @@ Pay Later(할부) 기능을 여러 국가에 제공하기 위해서는 **페이
 
 - 안드로이드
 
-  [**Android Integration of Magnes**](http://developer.paypal.com/limited-release/magnes/integrate/android/) 가이드 문서에 따라 아래와 같이 collectAndSubmit 메소드 호출을 통해 페이팔로 디바이스 정보를 보내야 합니다. 이때 두 번째 파라미터(`paypalClientMetaDataId`)로는 주문번호(`paymentId`)를 전달해야 합니다.
+  [**Android Integration of Magnes**](http://developer.paypal.com/limited-release/magnes/integrate/android/) 가이드 문서에 따라 아래와 같이 collectAndSubmit 메서드 호출을 통해 페이팔로 디바이스 정보를 보내야 합니다. 이때 두 번째 파라미터(`paypalClientMetaDataId`)로는 주문번호(`paymentId`)를 전달해야 합니다.
 
   ```java title="코드 예시"
   MagnesResult magnesResult = MagnesSDK.getInstance()
@@ -1837,7 +1838,7 @@ Pay Later(할부) 기능을 여러 국가에 제공하기 위해서는 **페이
 
 - iOS Switft
 
-  [**iOS Swift SDK Integration**](http://developer.paypal.com/limited-release/magnes/integrate/ios-swift/) 가이드 문서에 따라 아래와 같이 collectAndSubmit 메소드 호출을 통해 페이팔로 디바이스 정보를 보내야합니다. 이때 첫번째 파라미터(withPayPalClientMetadataId)로는 주문번호(paymentId)를 전달해야 합니다.
+  [**iOS Swift SDK Integration**](http://developer.paypal.com/limited-release/magnes/integrate/ios-swift/) 가이드 문서에 따라 아래와 같이 collectAndSubmit 메서드 호출을 통해 페이팔로 디바이스 정보를 보내야합니다. 이때 첫번째 파라미터(withPayPalClientMetadataId)로는 주문번호(paymentId)를 전달해야 합니다.
 
   ```swift title="코드 예시"
   let magnesResult: MagnesResult =
@@ -1849,7 +1850,7 @@ Pay Later(할부) 기능을 여러 국가에 제공하기 위해서는 **페이
 
 - iOS Objective-C
 
-  [**iOS Objective-C SDK Integration of Magnes**](http://developer.paypal.com/limited-release/magnes/integrate/ios-objective-c/) 가이드 문서에 따라 아래와 같이 collectAndSubmitWithPayPalClientMetadataId 메소드 호출을 통해 페이팔로 디바이스 정보를 보내야합니다. 이때 첫번째 파라미터(YOUR-PAYPAL-CLIENT-METADATA-ID)로는 주문번호(paymentId)를 전달해주시면 됩니다.
+  [**iOS Objective-C SDK Integration of Magnes**](http://developer.paypal.com/limited-release/magnes/integrate/ios-objective-c/) 가이드 문서에 따라 아래와 같이 collectAndSubmitWithPayPalClientMetadataId 메서드 호출을 통해 페이팔로 디바이스 정보를 보내야 합니다. 이때 첫번째 파라미터(YOUR-PAYPAL-CLIENT-METADATA-ID)로는 주문번호(paymentId)를 전달해주시면 됩니다.
 
   ```objc title="코드 예시"
   //PPRMOCMagnesSDK *magnesSDK = [PPRMOCMagnesSDK shared];

package/assets/docs/opi/ko/integration/pg/v2/readme.md

@@ -49,7 +49,7 @@ versionVariants:
     - 결제창/API 정기결제 : 카드
     - 간편결제 허브형 : 카카오페이 / 네이버페이 / 페이코 / LPay / 핀페이
 
-- **나이스페이먼츠**
+- **나이스정보통신**
 
   - 연동 기능: 인증결제(결제창) / 비인증결제(API) / 정기결제(API) / 간편결제(결제창/다이렉트 호출)
 
@@ -138,14 +138,6 @@ versionVariants:
 
     - 간편결제 : 토스페이
 
-- **하이픈**
-
-  - 연동 기능 : 간편결제(결제창)
-
-  - 결제 수단
-
-    - 간편결제 : 바로계좌결제
-
 #### 해외결제
 
 - **페이팔**

package/assets/docs/opi/ko/integration/pg/v2/smartro-v2.md

@@ -207,7 +207,7 @@ function requestPayment() {
 
 ## SDK 빌링키 발급 요청하기
 
-빌링키 발급 요청 시에는 `requestBillingKeyIssue` 함수를 호출해야 합니다.
+빌링키 발급 요청 시에는 `requestIssueBillingKey` 함수를 호출해야 합니다.
 `channelKey`파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여 스마트로 채널 사용을 명시해주세요.
 
 스마트로 기준으로 작성한 예시 코드는 아래와 같습니다.

package/assets/docs/opi/ko/integration/pg/v2/tosspayments.md

@@ -218,7 +218,7 @@ async function schedulePayment() {
   - 상품권 결제 요청 시, 사용하고자 하는 상품권 종류에 따라 아래 목록을 참고하여 `giftCertificateType` 파라미터를 입력해야 합니다.
     - 도서문화상품권 : `BOOKNLIFE`
     - 스마트문상 ((구)게임문화상품권) : `SMART_MUNSANG`
-    - 문화상품권 : `CULTURELAND`
+    - 컬쳐랜드 문화상품권 : `CULTURELAND`
 
 - `paymentId`
   - 토스페이먼츠를 사용하는 경우 영문 대소문자, 숫자, 특수문자(-,\_)만 허용되며, 6자 이상 64자 이하만 가능합니다.

package/assets/docs/opi/ko/integration/pg/v2/welcome.md

@@ -221,13 +221,13 @@ function requestPayment() {
 
         **PC - 카드 결제 전용 파라미터**
 
-        |형식                             |설명                                                                                                                                                                                                                               |
-        |---------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-        |SKIN(색상코드)                   |결제 창의 배경 색상 <br /> - 기본값 : #c1272c <br /> - 예시: SKIN(#fc6b2d)                                                                                                                                                         |
-        |below1000                        |1,000원 미만 결제 허용 여부 <br /> - 기본값: 허용하지 않음                                                                                                                                                                         |
-        |paypopup                         |안심클릭을 팝업 형태로 렌더링 시킬지 여부 <br /> - 기본값: 레이어                                                                                                                                                                  |
-        |onlyeasypaycode(간편 결제 리스트)|카드 결제창 내 렌더링 될 간편 결제 리스트 <br /> 예) 카카오페이, 엘페이, 페이코만 렌더링 → ”kakaopay:lpay:payco” 전달 <br /> - 카카오페이: `kakaopay` <br /> - 엘페이: `lpay` <br /> - 페이코: `payco` <br /> - 토스페이: `tosspay`|
-        |SLIMQUOTA(슬림 할부 설정)        |부분 무이자 설정. 슬림 할부 <br /> - 형식) SLIMQUOTA(코드-개월:개월^코드-개월:개월 <br /> - 예시) SLIMQUOTA(11-2:3^34-2:3)                                                                                                         |
+        |형식                             |설명                                                                                                                                                                                                                                                           |
+        |---------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+        |SKIN(색상코드)                   |결제 창의 배경 색상 <br /> - 기본값 : #c1272c <br /> - 예시: SKIN(#fc6b2d)                                                                                                                                                                                     |
+        |below1000                        |1,000원 미만 결제 허용 여부 <br /> - 기본값: 허용하지 않음                                                                                                                                                                                                     |
+        |paypopup                         |안심클릭을 팝업 형태로 렌더링 시킬지 여부 <br /> - 기본값: 레이어                                                                                                                                                                                              |
+        |onlyeasypaycode(간편 결제 리스트)|카드 결제창 내 렌더링 될 간편 결제 리스트 <br /> 예) 카카오페이, 엘페이, 페이코만 렌더링 → ”kakaopay:lpay:payco” 전달 <br /> - 카카오페이: `kakaopay` <br /> - 엘페이: `lpay` <br /> - 페이코: `payco` <br /> - 토스페이: `tosspay` <br /> - 네이버페이: `npay`|
+        |SLIMQUOTA(슬림 할부 설정)        |부분 무이자 설정. 슬림 할부 <br /> - 형식) SLIMQUOTA(코드-개월:개월^코드-개월:개월 <br /> - 예시) SLIMQUOTA(11-2:3^34-2:3)                                                                                                                                     |
 
         **PC - 휴대폰 소액 결제 전용 파라미터**
 
@@ -398,6 +398,7 @@ SDK를 통한 결제 요청 파라미터에는 부가세를 지정할 수 있는
 - lpay: `LPAY`
 - 토스페이: `TOSSPAY`
 - 페이코: `PAYCO`
+- 네이버페이: `NAVERPAY`
 
 </details>
 

package/assets/docs/opi/ko/integration/ready/readme.md

@@ -132,7 +132,7 @@ targetVersions:
 
 <details>
 
-<summary>나이스페이먼츠</summary>
+<summary>나이스정보통신</summary>
 
 <div class="hint" data-style="info">
 
@@ -140,16 +140,16 @@ targetVersions:
 
 </div>
 
-1. [나이스페이먼츠 가맹점 관리자](http://npg.nicepay.co.kr/merchant/mkeyMngForm.do) 접속 후 로그인을 합니다.
+1. [나이스정보통신 가맹점 관리자](http://npg.nicepay.co.kr/merchant/mkeyMngForm.do) 접속 후 로그인을 합니다.
 2. \[가맹점정보]→\[KEY관리]를 클릭합니다.
 3. MID 및 Key 값을 확인할 수 있습니다.
 
-(이미지 첨부: 나이스페이먼츠 가맹점 관리자 내 KEY 조회 화면)
+(이미지 첨부: 나이스정보통신 가맹점 관리자 내 KEY 조회 화면)
 
 4. \[가맹점정보]→\[비밀번호관리]→\[거래취소비밀번호]를 클릭합니다.
 5. 비밀번호를 설정합니다. 비밀번호는 최대 10자리까지 가능합니다.
 
-(이미지 첨부: 나이스페이먼츠 가맹점 관리자 내 거래취소비밀번호 설정 화면)
+(이미지 첨부: 나이스정보통신 가맹점 관리자 내 거래취소비밀번호 설정 화면)
 
 6. 포트원 콘솔에서 채널 추가 시 \[MID], \[Key], \[결제취소 비밀번호]를 입력한 후 `저장`을 클릭합니다.
 
@@ -468,7 +468,17 @@ targetVersions:
 
 <div class="tabs-content" data-title="통합 본인인증">
 
-포트원 콘솔에서 채널 추가 시 계약 완료 후 KG이니시스로부터 전달받은 \[MID]와\[apikey]를 입력한 후 `저장`을 클릭합니다.
+1. [KG이니시스 가맹점관리자](https://iniweb.inicis.com/security/login.do) 접속 후 로그인을 합니다.
+2. \[상점정보]→\[계약정보]→\[KEY 정보]를 클릭합니다.
+3. \[부가서비스 연동 Key 정보]→\[통합인증 서비스] 항목에서 \[도메인 등록] 버튼을 클릭 후 아래 3개의 도메인을 등록합니다.
+
+- 본인인증 서비스를 이용하는 고객사 서비스 도메인
+- iamport.co
+- iamport.kr
+
+(이미지 첨부: KG이니시스 가맹점관리자 내 도메인 등록화면)
+
+4. 포트원 콘솔에서 채널 추가 시 계약 완료 후 KG이니시스로부터 전달받은 \[MID]와 \[apikey]를 입력한 후 `저장`을 클릭합니다.
 
 </div>
 
@@ -564,7 +574,17 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
 
 <div class="tabs-content" data-title="통합 본인인증">
 
-포트원 콘솔에서 채널 추가 시 계약 완료 후 KG이니시스로부터 전달받은 \[MID]와 \[apikey]를 입력한 후 `저장`을 클릭합니다.
+1. [KG이니시스 가맹점관리자](https://iniweb.inicis.com/security/login.do) 접속 후 로그인을 합니다.
+2. \[상점정보]→\[계약정보]→\[KEY 정보]를 클릭합니다.
+3. \[부가서비스 연동 Key 정보]→\[통합인증 서비스] 항목에서 \[도메인 등록] 버튼을 클릭 후 아래 3개의 도메인을 등록합니다.
+
+- 본인인증 서비스를 이용하는 고객사 서비스 도메인
+- iamport.co
+- iamport.kr
+
+(이미지 첨부: KG이니시스 가맹점관리자 내 도메인 등록화면)
+
+4. 포트원 콘솔에서 채널 추가 시 계약 완료 후 KG이니시스로부터 전달받은 \[MID]와 \[apikey]를 입력한 후 `저장`을 클릭합니다.
 
 </div>
 
@@ -820,38 +840,6 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
 
 <!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
 
-<!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
-
-<details>
-
-<summary>하이픈</summary>
-
-1. [HYPHEN PAY & 바로계좌결제 운영 백오피스](http://payadmin.hyphen.im/) 접속 후 **바로계좌결제** 선택 후
-   로그인을 합니다.
-
-   (이미지 첨부: HYPHEN 백오피스 로그인 화면)
-
-2. \[상점관리]→\[바로계좌결제 상점정보관리]를 클릭합니다.
-
-3. 상점명을 클릭합니다.
-
-   (이미지 첨부: HYPHEN \[상점관리] - \[상점정보관리] 예시 화면)
-
-4. \[상점 기본정보]에서 \[상점번호]를 확인합니다.
-
-   (이미지 첨부: HYPHEN \[상점 기본정보] 예시 화면)
-
-5. \[암호화 키, 토큰]에서 \[암호화 키]와 \[암호화 토큰]을 확인합니다.
-
-   (이미지 첨부: HYPHEN \[암호화 키, 토큰] 예시 화면)
-
-6. 포트원 콘솔에서 채널 추가 시 \[PG상점아이디(상점 번호)], \[암호화 키], \[암호화 토큰]을
-   입력한 후 \[저장]을 클릭합니다.
-
-</details>
-
-<!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
-
 #### 해외 결제대행사
 
 <details>
@@ -889,6 +877,24 @@ PG 거래대사 메뉴를 사용하시는 경우 \[대사 시크릿 키] 항목
 
 3. 포트원 콘솔에서 채널 추가 시 \[Project Key], \[Secret Key]를 입력한 후 `저장`을 클릭합니다.
 
+#### 핑백(Pingback) URL 설정하기
+
+페이먼트월에서 포트원으로 결제 결과를 전달받기 위해 핑백 URL을 설정해야 합니다.
+
+1. [페이먼트월](https://api.paymentwall.com/developers/applications) 페이지에서 \[My Projects]를 클릭합니다.
+
+(이미지 첨부: 페이먼트월 My Projects 메뉴)
+
+2. 사용할 프로젝트의 \[Settings] 탭을 클릭합니다.
+
+(이미지 첨부: 페이먼트월 프로젝트 setting 탭)
+
+3. \[Pingback type]을 `URL`로 선택합니다.
+4. \[Pingback URL]에 `https://service.iamport.kr/paymentwall/webhook`를 입력합니다.
+5. \[Pingback signature version]을 `3`으로 설정합니다.
+
+(이미지 첨부: 페이먼트월 Pingback 설정 화면)
+
 </details>
 
 <!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
@@ -994,8 +1000,6 @@ PG 거래대사 메뉴를 사용하시는 경우 \[대사 시크릿 키] 항목
 
 </details>
 
-<!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
-
 <details>
 
 <summary>페이레터 해외결제</summary>
@@ -1005,8 +1009,6 @@ PG 거래대사 메뉴를 사용하시는 경우 \[대사 시크릿 키] 항목
 
 </details>
 
-<!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
-
 ## <span id="integration-identifiers">4. 포트원 연동정보 확인하기</span>
 
 포트원을 이용한 결제 연동 시 필요한 연동정보를 확인합니다.

package/assets/docs/opi/ko/integration/start/v1/non-auth.md

@@ -38,7 +38,7 @@ targetVersions:
 - **지원 결제대행사**
   - KG이니시스
   - NHN KCP
-  - 나이스페이먼츠 (구모듈, 신모듈)
+  - 나이스정보통신 (구모듈, 신모듈)
   - 토스페이먼츠 (신모듈)
   - 키움페이
   - KSNET
@@ -106,7 +106,7 @@ const onetimeResponse = await fetch(
 - **지원 결제대행사**
   - KG이니시스
   - NHN KCP
-  - 나이스페이먼츠 (구모듈, 신모듈)
+  - 나이스정보통신 (구모듈, 신모듈)
   - 토스페이먼츠 (신모듈)
   - 키움페이
   - KSNET
@@ -369,8 +369,6 @@ app.post("/iamport-callback/schedule", async (req, res) => {
 포트원 서버에 결제 예약 요청을 하고 예약한 시간에 결제가 시도되면 지정된 웹훅 URL을 통해서
 서버에 알리는 과정을 반복적으로 수행하여 반복 결제를 구현할 수 있습니다.
 
-(관련 이미지 첨부)
-
 예약된 결제가 시도되었을 때 발생하는 webhook 이벤트를 처리하는 로직에서 예약된 결제가 정상적으로 완료되고 결제 내역이 저장되면 다음 결제를 예약하는 예제입니다.
 
 ```ts title="server-side"

package/assets/docs/opi/ko/integration/start/v2/billing/issue.md

@@ -39,7 +39,7 @@ versionVariants:
 브라우저에서 포트원 SDK를 호출하여 빌링키를 발급하고, 서버로 빌링키를 전달합니다.
 
 ```ts
-const issueResponse = PortOne.requestIssueBillingKey({
+const issueResponse = await PortOne.requestIssueBillingKey({
   storeId: "store-9bf6076d-beef-4729-9521-ae66c14e0569",
   channelKey: "channel-key-3b37819a-1c72-4deb-a245-8c810af5403d",
   billingKeyMethod: "CARD",

package/assets/docs/opi/ko/integration/start/v2/checkout.md

@@ -158,7 +158,8 @@ async function requestPayment() {
 }
 ```
 
-결과값에 들어 있는 필드는 다음과 같습니다.
+결과값에 들어 있는 주요 필드는 다음과 같습니다.
+전체 필드 목록은 [requestPayment 응답 형식](https://developers.portone.io/sdk/ko/v2-sdk/payment-response)을 참조해 주시기 바랍니다.
 
 |필드명   |설명               |비고                        |
 |---------|-------------------|----------------------------|
@@ -181,7 +182,8 @@ PortOne.requestPayment({
 });
 ```
 
-쿼리 문자열로 전달되는 내용은 다음과 같습니다.
+쿼리 문자열로 전달되는 주요 필드는 다음과 같습니다.
+전체 필드 목록은 [requestPayment 응답 형식](https://developers.portone.io/sdk/ko/v2-sdk/payment-response)을 참조해 주시기 바랍니다.
 
 |키       |설명               |비고                        |
 |---------|-------------------|----------------------------|

package/assets/docs/opi/ko/integration/start/v2/readme.md

@@ -78,7 +78,7 @@ V2는 모든 데이터를 수집하고 기록합니다. [Event Sourcing](https:/
 
 ### 기능 확장: 신속한 업데이트와 혁신
 
-V2는 최신 결제 기능을 가장 빠르게 제공합니다. 곧 출시될 스마트라우팅은 V2 인프라를 이용 중인 고객사에게 우선하여 제공됩니다.
+V2는 최신 결제 기능을 가장 빠르게 제공합니다.
 최신 기능을 통해 결제 프로세스를 혁신하고, 고객의 결제 경험을 향상시킬 수 있습니다.
 
 ## 사용 가능한 PG사
@@ -92,13 +92,12 @@ V2는 최신 결제 기능을 가장 빠르게 제공합니다. 곧 출시될
 - **카카오페이**
 - **네이버페이**
 - **스마트로**
-- **나이스페이먼츠**
+- **나이스정보통신**
 - **페이팔**
 - **KG이니시스**
 - **한국결제네트웍스(KPN)**
 - **NHN KCP**
 - **토스페이**
-- **하이픈 바로계좌결제**
 
 ### 본인인증
 

package/assets/docs/opi/ko/integration/using-ai-tools.md

@@ -13,78 +13,54 @@ targetVersions:
 포트원 MCP 서버는 개발자센터 문서 내용을 AI에게 제공하여,
 AI가 보다 정확하고 구체적인 정보를 바탕으로 사용자의 연동 및 질의를 돕도록 합니다.
 
-### 1. MCP 서버 등록하기
+이외에도 포트원 콘솔에서 제공하는 기능 중 일부를 수행할 수 있습니다.
+아래 기능을 AI에게 요청하면 MCP 서버가 브라우저를 열어 포트원 콘솔 로그인을 요청하며, 로그인 후 기능이 수행됩니다.
 
-포트원 MCP 서버를 사용하기 위해서는 먼저 사용하는 AI 도구에 서버를 등록해야 합니다.
+- 채널 목록 조회
+- 테스트 채널 추가
+- 하위 상점 조회
+- 결제 내역 조회
 
-Cursor, Windsurf, Claude Code, Claude for Desktop 등 다양한 AI 도구의 설정 파일에서 아래 내용을 추가하여 MCP 서버를 등록할 수 있습니다.
+### DXT를 이용한 설치
 
-```json
-{
-  // ...
+[DXT (Desktop Extensions)](https://github.com/anthropics/dxt)를 이용해 MCP 서버를 원클릭으로 설치할 수 있습니다.
 
-  "mcpServers": {
-    // ...
+1. [GitHub Releases](https://github.com/portone-io/mcp-server/releases)에서 최신 `portone-mcp-server.dxt` 파일을 다운로드합니다.
+2. 지원하는 AI 도구(Claude Desktop 등)에서 다운로드한 `.dxt` 파일을 드래그 앤 드롭하거나 열기를 통해 설치합니다.
+3. 설치 후 도구를 재시작하여 MCP 서버가 정상적으로 등록되었는지 확인합니다.
 
-    "portone-mcp-server": {
-      "command": "uvx",
-      "args": ["portone-mcp-server@latest"]
-    }
-  }
-}
-```
-
-<div class="hint" data-style="info">
-
-사용 환경에 [uv](https://docs.astral.sh/uv/getting-started/installation/)가 설치되어 있어야 합니다.
-
-</div>
-
-설정 파일 수정이 완료된 후 AI 도구를 재시작하면 MCP 서버가 적용됩니다.
-
-#### 포트원 기능 사용하기
-
-MCP 서버에 포트원 기능을 연동하면, AI가 아래와 같은 작업을 수행할 수 있습니다.
-
-- 결제 내역 단건/다건 조회
-- 본인인증 내역 단건/다건 조회
+<div class="hint" data-style="warning">
 
-연동을 활성화하려면, MCP 설정 파일의 env 블록에 포트원 관리자 콘솔에서 발급받은 API\_SECRET을 추가합니다.
+**Claude Desktop에서 DXT 파일 사용 시 주의사항**
 
-```json
-{
-  // ...
+현재 [알려진 이슈](https://github.com/anthropics/dxt/issues/45)로 인해 Claude Desktop에서 DXT 설치 후 MCP 서버가 정상적으로 작동하지 않을 수 있습니다.
 
-  "mcpServers": {
-    // ...
+이 경우 Node.js 22.6.0 이상을 설치하고 Claude Desktop 설정에서 **"MCP용 내장 Node.js 사용"** 옵션을 비활성화한 후 재시작하면 정상적으로 작동합니다.
 
-    "portone-mcp-server": {
-      "command": "uvx",
-      "args": ["portone-mcp-server@latest"],
-      // 아래 env 블록을 추가하여 API 시크릿을 설정합니다.
-      "env": {
-        "API_SECRET": "<YOUR_PORTONE_API_SECRET>"
-      }
-    }
-  }
-}
-```
+</div>
 
-<div class="hint" data-style="warning">
+### MCP 서버 등록하기
 
-**API 시크릿은 MCP 서버에서 제공하는 기능 외에도 포트원 REST API의 모든 권한을 가집니다.**
+1. Node.js 22.6.0 이상이 설치되어 있어야 합니다.
 
-내부의 인가된 인원만이 MCP 서버를 사용할 수 있도록 통제해야 합니다.
+2. 사용하는 AI 도구의 MCP 설정에서 아래 내용을 추가합니다. (Cursor, Windsurf, Claude Desktop, etc...)
 
-</div>
+   ```jsonc
+   "mcpServers": {
 
-<div class="hint" data-style="warning">
-
-**MCP 서버는 포트원의 공개된 API 기능만을 사용하며, 인증을 위해 사용자가 제공한 API 시크릿을 활용합니다.**
+     // 기존 설정
 
-이 인증 과정은 전적으로 MCP 서버 내부에서 일어나므로, 언어 모델의 문제로 인해 비인가 사용자에게 기밀 정보가 유출되지는 않습니다.
+     "portone-mcp-server": {
+       "command": "npx",
+       "args": [
+         "-y",
+         "@portone/mcp-server@latest"
+       ]
+     }
+   }
+   ```
 
-</div>
+3. 도구를 재시작해 portone-mcp-server 및 해당 서버가 제공하는 도구들이 잘 등록되었는지 확인합니다.
 
 <div class="hint" data-style="warning">
 
@@ -95,7 +71,7 @@ MCP 서버는 API 응답에 포함된 개인정보가 외부로 전달되지 않
 
 </div>
 
-### 2. MCP 서버 활용하기
+### MCP 서버 활용하기
 
 사용 중인 AI 도구에 포트원 MCP 서버가 적용되었다면, 아래 예시들과 같이 질의하여 사용할 수 있습니다.
 

package/assets/docs/opi/ko/integration/virtual-account/readme.md

@@ -21,8 +21,8 @@ targetVersions:
 |키움페이              |daou                |<ul><li>발행 통지 URL: [https://service.iamport.kr/daou\_payments/result](http://service.iamport.kr/daou_payments/result)</li> <li>결과 통지 URL: [https://service.iamport.kr/daou\_payments/notice\_vbank](http://service.iamport.kr/daou_payments/notice_vbank)</li></ul>|
 |토스페이먼츠(신모듈)  |tosspayments        |[https://tx-gateway-service.prod.iamport.co/virtual-account/webhook-event/tosspayments](http://tx-gateway-service.prod.iamport.co/virtual-account/webhook-event/tosspayments)                                                                                              |
 |스마트로(신모듈)      |smartro\_v2         |입금 통보, 환불이체 URL 동일: [https://tx-gateway-service.prod.iamport.co/smartro-v2](http://tx-gateway-service.prod.iamport.co/smartro-v2)                                                                                                                                |
-|나이스페이먼츠(구모듈)|nice                |[https://service.iamport.kr/nice\_payments/notice\_vbank](http://service.iamport.kr/nice_payments/notice_vbank)                                                                                                                                                            |
-|나이스페이먼츠(신모듈)|nice\_v2            |[https://tx-gateway-service.prod.iamport.co/nicepay-v2](http://tx-gateway-service.prod.iamport.co/nicepay-v2)                                                                                                                                                              |
+|나이스정보통신(구모듈)|nice                |[https://service.iamport.kr/nice\_payments/notice\_vbank](http://service.iamport.kr/nice_payments/notice_vbank)                                                                                                                                                            |
+|나이스정보통신(신모듈)|nice\_v2            |[https://tx-gateway-service.prod.iamport.co/nicepay-v2](http://tx-gateway-service.prod.iamport.co/nicepay-v2)                                                                                                                                                              |
 |웰컴페이먼츠          |welcome             |[https://tx-gateway-service.prod.iamport.co/welcome](http://tx-gateway-service.prod.iamport.co/welcome)                                                                                                                                                                    |
 
 <!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
@@ -33,7 +33,7 @@ targetVersions:
 |----------------|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-|
 |토스페이먼츠    |tosspayments        |[https://tx-gateway-service.prod.iamport.co/virtual-account/webhook-event/tosspayments](http://tx-gateway-service.prod.iamport.co/virtual-account/webhook-event/tosspayments)| |
 |스마트로        |smartro\_v2         |입금 통보, 환불이체 URL 동일: [https://tx-gateway-service.prod.iamport.co/smartro-v2](http://tx-gateway-service.prod.iamport.co/smartro-v2)                                  | |
-|나이스페이먼츠  |nice\_v2            |[https://tx-gateway-service.prod.iamport.co/nicepay-v2](http://tx-gateway-service.prod.iamport.co/nicepay-v2)                                                                | |
+|나이스정보통신  |nice\_v2            |[https://tx-gateway-service.prod.iamport.co/nicepay-v2](http://tx-gateway-service.prod.iamport.co/nicepay-v2)                                                                | |
 |KG이니시스      |inicis\_v2          |[https://tx-gateway-service.prod.iamport.co/inicis-v2](http://tx-gateway-service.prod.iamport.co/inicis-v2)                                                                  | |
 |한국결제네트웍스|kpn                 |[https://tx-gateway-service.prod.iamport.co/kpn/virtual-account](http://tx-gateway-service.prod.iamport.co/kpn/virtual-account)                                              | |
 |NHN KCP         |kcp\_v2             |[https://tx-gateway-service.prod.iamport.co/kcp-v2](http://tx-gateway-service.prod.iamport.co/kcp-v2)                                                                        | |
@@ -74,9 +74,9 @@ targetVersions:
 
 <details>
 
-<summary>나이스페이먼츠(구모듈) 설정 방법</summary>
+<summary>나이스정보통신(구모듈) 설정 방법</summary>
 
-1. [나이스페이먼츠 가맹점 관리자](http://npg.nicepay.co.kr/merchant/mkeyMngForm.do) 접속 후 로그인을 합니다.
+1. [나이스정보통신 가맹점 관리자](http://npg.nicepay.co.kr/merchant/mkeyMngForm.do) 접속 후 로그인을 합니다.
 2. \[가맹점정보]→\[기본정보]를 클릭합니다.
 3. \[결제데이터통보] 항목에서 **가상계좌**의 \[URL/IP]를 `https://service.iamport.kr/nice_payments/notice_vbank` 로 설정해주세요.
 4. \[재전송 간격]은 1분, \[재전송 횟수]는 3회로 설정해주세요.
@@ -86,7 +86,7 @@ targetVersions:
 - 재전송 간격: 최소 1분 \~ 최대 10분까지만 입력 가능합니다.
 - 재전송 횟수: 최소 1회 \~ 최대 10회까지 재전송 가능합니다.(전송 실패 건에 대해 자동 재전송)
 
-(이미지 첨부: 나이스페이먼츠 가맹점 관리자 내 입금통보 URL 설정 화면)
+(이미지 첨부: 나이스정보통신 가맹점 관리자 내 입금통보 URL 설정 화면)
 
 </details>
 
@@ -179,9 +179,9 @@ KSNET은 포트원을 통해 발급된 MID에 대해 자동으로 입금통보 U
 
 <details>
 
-<summary>나이스페이먼츠(신모듈) 설정 방법</summary>
+<summary>나이스정보통신(신모듈) 설정 방법</summary>
 
-1. [나이스페이먼츠 가맹점 관리자](http://npg.nicepay.co.kr/merchant/mkeyMngForm.do) 접속 후 로그인을 합니다.
+1. [나이스정보통신 가맹점 관리자](http://npg.nicepay.co.kr/merchant/mkeyMngForm.do) 접속 후 로그인을 합니다.
 2. \[가맹점정보]→\[기본정보]를 클릭합니다.
 3. \[결제데이터통보] 항목에서 **가상계좌**의 \[URL/IP]를 `https://tx-gateway-service.prod.iamport.co/nicepay-v2` 로 설정해주세요.
 4. \[재전송 간격]은 1분, \[재전송 횟수]는 3회로 설정해주세요.
@@ -191,7 +191,7 @@ KSNET은 포트원을 통해 발급된 MID에 대해 자동으로 입금통보 U
 - 재전송 간격: 최소 1분 \~ 최대 10분까지만 입력 가능합니다.
 - 재전송 횟수: 최소 1회 \~ 최대 10회까지 재전송 가능합니다.(전송 실패 건에 대해 자동 재전송)
 
-(이미지 첨부: 나이스페이먼츠 가맹점 관리자 내 입금통보 URL 설정 화면 )
+(이미지 첨부: 나이스정보통신 가맹점 관리자 내 입금통보 URL 설정 화면 )
 
 </details>