@portone/mcp-server 0.15.0-alpha.5 → 0.16.0

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

@@ -156,6 +156,9 @@ IMP.request_pay(
   - ssgpay\_bank (SSGPAY 은행계좌)
   - lpay (LPAY)
   - applepay (애플페이)
+  - tosspay\_card (토스페이 - 카드)
+  - tosspay\_money (토스페이 - 머니)
+  - alipay (알리페이)
 
 - merchant\_uid: string
 
@@ -181,20 +184,89 @@ IMP.request_pay(
 
   소수점 두번째 자리까지 허용합니다.
 
+- buyer\_name?: string
+
+  **구매자 이름**
+
+- buyer\_email?: string
+
+  **구매자 이메일**
+
 - buyer\_tel: string
 
   **구매자 전화번호**
 
+- buyer\_addr?: string
+
+  **구매자 주소**
+
+- buyer\_postcode?: string
+
+  **구매자 우편번호**
+
+- tax\_free?: number
+
+  **면세금액**
+
+- vat\_amount?: number
+
+  **부가세**
+
 - vbank\_due: string
 
-  **가상계좌 입금기한 (YYYY-MM-DD)**
+  **가상계좌 입금기한**
 
-  (신) 나이스정보통신의 경우 필수 입력이며 날짜는 무조건 23:59:59로 설정 됨
+  `YYYY-MM-DD` 또는 `YYYY-MM-DD HH:mm:ss` 형식으로 지정합니다. (신) 나이스정보통신의 경우 필수 입력입니다.
 
 - escrow: boolean
 
   **에스크로 결제 여부**
 
+- digital?: boolean
+
+  **디지털 컨텐츠 여부**
+
+  휴대폰 소액결제 시 필수 입력합니다. 디지털 컨텐츠(`true`), 실물 상품(`false`)
+
+- language?: string
+
+  **결제창 언어**
+
+  - `ko`: 한국어 (기본값)
+  - `en`: 영어
+  - `zh`: 중국어
+
+- currency?: string
+
+  **결제 통화 (기본값: KRW)**
+
+  - KRW (한국 원)
+  - USD (미국 달러)
+
+- m\_redirect\_url?: string
+
+  **모바일 결제 후 리디렉션 될 URL**
+
+- app\_scheme?: string
+
+  **모바일 앱 URL scheme** (모바일 전용)
+
+- notice\_url?: string | string\[]
+
+  **웹훅 수신 URL**
+
+  포트원 관리자 콘솔에 설정한 웹훅 URL 대신 사용할 URL을 지정합니다.
+
+- confirm\_url?: string
+
+  **Confirm process URL**
+
+- custom\_data?: object
+
+  **가맹점 커스텀 데이터**
+
+  결제 정보와 함께 저장할 커스텀 데이터입니다. 결제 조회 시 반환됩니다.
+
 - period?: object
 
   **서비스 제공 기간**
@@ -209,6 +281,82 @@ IMP.request_pay(
 
     **YYYYMMDD**
 
+- bypass?: object
+
+  **나이스정보통신(신모듈) 전용 파라미터**
+
+  - nice\_v2?: object
+
+    - LogoImage?: string
+
+      **로고 이미지 URL** (full URL)
+
+    - NPDisableScroll?: string
+
+      **결제창 스크롤 미사용 여부** (PC 전용)
+
+      - `Y`: 미사용 (기본값)
+      - `N`: 사용
+
+    - SkinType?: string
+
+      **결제창 스킨 색상**
+
+      - `red`, `green`, `purple`, `gray`, `dark`
+
+    - UserCI?: string
+
+      **문화상품권 결제 시 사용자 CI 정보**
+
+      아이디/비밀번호 외 추가로 CI 인증이 필요한 경우 사용합니다. 사전 협의 필요.
+
+    - MallUserID?: string
+
+      **상점 사용자 아이디**
+
+      문화상품권 결제 시 필수 입력합니다.
+
+    - DirectCouponYN?: string
+
+      **신용카드 쿠폰 자동 적용 여부**
+
+      - `Y`: 사전 등록된 선 할인 쿠폰 자동 적용
+      - `N`: 쿠폰 미적용 (기본값)
+
+    - DirectShowOpt?: string
+
+      **다이렉트 호출 결제 수단**
+
+      - `BANK`: 계좌이체 다이렉트 호출
+      - `CELLPHONE`: 휴대폰 소액결제 다이렉트 호출
+
+    - CardShowOpt?: string
+
+      **카드사별 호출 방식**
+
+      형식: `카드코드:노출유형|카드코드:노출유형`
+
+      노출 유형: `1`(안심클릭), `2`(간편결제), `3`(앱카드 직접 호출)
+
+      예시: `"08:3|02:3"` (롯데카드, 국민카드 앱카드 직접 호출)
+
+    - PaycoClientId?: string
+
+      **페이코 자동 로그인용 ClientId**
+
+      페이코에서 가맹점에 발급한 ClientId입니다. 사전 협의 필요.
+
+    - PaycoAccessToken?: string
+
+      **페이코 자동 로그인용 접속 토큰**
+
+    - SamPayMallType?: string
+
+      **삼성페이 가맹점 유형**
+
+      - `01`: 삼성페이 내 쇼핑
+      - `99`: 기타 (기본값)
+
 </details>
 
 <details>
@@ -234,6 +382,9 @@ IMP.request_pay(
 - ssgpay\_bank
 - lpay
 - applepay
+- tosspay\_card
+- tosspay\_money
+- alipay
 
 </details>
 
@@ -324,10 +475,26 @@ JS SDK를 가장 최신 버전으로 업그레이드 후 `channelKey` 파라미
   - 사용 불가 : **% & | $ - + = \[ ]**
   - 사용 가능하나 권장하지 않음 : **( )**
 
+- buyer\_name?: string
+
+  **구매자 이름**
+
+- buyer\_email?: string
+
+  **구매자 이메일**
+
 - buyer\_tel: string
 
   **구매자 전화번호**
 
+- buyer\_addr?: string
+
+  **구매자 주소**
+
+- buyer\_postcode?: string
+
+  **구매자 우편번호**
+
 - customer\_uid: string
 
   **빌링키 발급을 위한 결제 수단을 특정하는 고유 번호**
@@ -346,6 +513,14 @@ JS SDK를 가장 최신 버전으로 업그레이드 후 `channelKey` 파라미
 
   리다이렉트 방식으로 진행할 경우, 트랜잭션 종료 이후 302 리디렉션 될 고객사 URL
 
+- notice\_url?: string | string\[]
+
+  **웹훅 수신 URL**
+
+- custom\_data?: object
+
+  **가맹점 커스텀 데이터**
+
 </details>
 
 </div>

package/assets/docs/opi/ko/integration/pg/v1/nice.md

@@ -1,6 +1,6 @@
 ---
-title: (구) 나이스정보통신
-description: (구) 나이스정보통신 결제창 연동 가이드를 안내합니다.
+title: 나이스정보통신 (구모듈)
+description: 나이스정보통신 (구모듈) 결제창 연동 가이드를 안내합니다.
 targetVersions:
   - v1
 ---
@@ -98,12 +98,76 @@ IMP.request_pay(
 
   매번 고유하게 채번되어야 합니다.
 
+- name: string
+
+  **주문명**
+
 - amount: number
 
   **결제금액**
 
   **string** 이 아닌점에 유의하세요
 
+- buyer\_name?: string
+
+  **구매자 이름**
+
+- buyer\_email?: string
+
+  **구매자 이메일**
+
+- buyer\_tel?: string
+
+  **구매자 연락처**
+
+- buyer\_addr?: string
+
+  **구매자 주소**
+
+- buyer\_postcode?: string
+
+  **구매자 우편번호**
+
+- tax\_free?: number
+
+  **면세금액**
+
+- vat\_amount?: number
+
+  **부가세**
+
+- vbank\_due?: string
+
+  **가상계좌 입금마감일시**
+
+  `YYYYMMDD` 또는 `YYYYMMDDHHmm` 형식으로 지정합니다. 미지정 시 기본 30일입니다.
+
+- m\_redirect\_url?: string
+
+  **모바일 결제 후 리디렉션 될 URL**
+
+- app\_scheme?: string
+
+  **모바일 앱 URL scheme** (모바일 전용)
+
+  모바일 앱에서 결제 시 ISP/앱카드 등에서 결제 완료 후 가맹점 앱으로 돌아올 때 사용됩니다.
+
+- notice\_url?: string | string\[]
+
+  **웹훅 수신 URL**
+
+  포트원 관리자 콘솔에 설정한 웹훅 URL 대신 사용할 URL을 지정합니다.
+
+- confirm\_url?: string
+
+  **Confirm process URL**
+
+- custom\_data?: object
+
+  **가맹점 커스텀 데이터**
+
+  결제 정보와 함께 저장할 커스텀 데이터입니다. 결제 조회 시 반환됩니다.
+
 - niceMobileV2?: boolean
 
   나이스 모바일 신규버전 적용 여부(기본 값: `false`)
@@ -112,12 +176,65 @@ IMP.request_pay(
 
   **에스크로 설정여부**
 
+- digital?: boolean
+
+  **디지털 컨텐츠 여부**
+
+  휴대폰 소액결제 시 디지털 컨텐츠(`true`)인지 실물 상품(`false`)인지 구분합니다.
+
+- language?: string
+
+  **결제창 언어**
+
+  - `ko`: 한국어 (기본값)
+  - `en`: 영어
+  - `zh`: 중국어
+
 - currency?: string
 
   **결제 통화(기본 값: KRW)**
 
   - KRW(한국 원)
-  - USD(미국 달러)(모바일의 경우 `niceMobileV2` 파라미터가 `true`일 경우에만 사용 가능)
+  - USD(미국 달러)
+
+- period?: object
+
+  **서비스 제공기간**
+
+  고객이 구매하는 제품에 대한 제공기간을 명시합니다.
+
+  - from?: string
+
+    **시작일 (YYYYMMDD)**
+
+  - to?: string
+
+    **종료일 (YYYYMMDD)**
+
+  - interval?: string
+
+    **정기결제 간격**
+
+    `from`/`to` 대신 사용할 수 있습니다.
+
+    - `month`: 월간
+    - `year`: 연간
+
+- appCard?: boolean
+
+  **앱카드 전용 모드**
+
+  `true` 설정 시 앱카드 결제만 활성화됩니다.
+
+- bypass?: object
+
+  **나이스정보통신(구모듈) 전용 파라미터**
+
+  - CardShowOpt?: string
+
+    **카드사별 호출 방식** (모바일 전용, `niceMobileV2: true` 시에만 동작)
+
+    형식: `카드코드:노출유형|카드코드:노출유형`
 
 </div>
 
@@ -217,8 +334,10 @@ curl -H "Content-Type: application/json" \
     예시
 
     - `[]`: 일시불만 결제 가능
-    - `2,3,4,5,6`: 일시불을 포함한 2, 3, 4, 5, 6개월까지 할부개월 선택 가능
-    - `3`: 일시불을 포함한 2,3개월까지 할부개월 선택 가능
+    - `[2, 3, 4, 5, 6]`: 일시불을 포함한 2, 3, 4, 5, 6개월 할부 선택 가능
+    - `[3]`: 일시불과 3개월 할부만 선택 가능
+
+    배열에 포함된 개월수만 개별적으로 활성화됩니다.
 
 <div class="hint" data-style="info">
 

package/assets/docs/opi/ko/integration/pg/v1/payco.md

@@ -88,17 +88,73 @@ IMP.request_pay(
 
   매번 고유하게 채번되어야 합니다.
 
+- name: string
+
+  **주문명**
+
+- amount: number
+
+  **결제금액**
+
+  **string** 이 아닌점에 유의하세요
+
+- buyer\_name?: string
+
+  **구매자 이름**
+
+- buyer\_email?: string
+
+  **구매자 이메일**
+
 - buyer\_tel: string
 
   **구매자 연락처**
 
   필수 파라미터 입니다.
 
-- amount: number
+- buyer\_addr?: string
 
-  **결제금액**
+  **구매자 주소**
 
-  **string** 이 아닌점에 유의하세요
+- buyer\_postcode?: string
+
+  **구매자 우편번호**
+
+- tax\_free?: number
+
+  **면세금액**
+
+- vbank\_due?: string
+
+  **가상계좌 입금마감일시**
+
+- language?: string
+
+  **결제창 언어**
+
+- m\_redirect\_url?: string
+
+  **모바일 결제 후 리디렉션 될 URL**
+
+- app\_scheme?: string
+
+  **모바일 앱 URL scheme** (모바일 전용)
+
+- notice\_url?: string | string\[]
+
+  **웹훅 수신 URL**
+
+- confirm\_url?: string
+
+  **Confirm process URL**
+
+- custom\_data?: object
+
+  **가맹점 커스텀 데이터**
+
+- customer\_id?: string
+
+  **구매자 고유 ID**
 
 </div>
 
@@ -174,12 +230,40 @@ IMP.request_pay(
 
   비 인증 결제창에서 고객이 입력한 카드정보와 1:1로 매칭될 빌링키를 지정합니다.
 
+- merchant\_uid: string
+
+  **주문번호**
+
+- name: string
+
+  **주문명**
+
 - amount: number
 
   **결제금액**
 
   금액이 설정되어도 실 결제는 발생되지 않습니다.
 
+- buyer\_name?: string
+
+  **구매자 이름**
+
+- buyer\_email?: string
+
+  **구매자 이메일**
+
+- buyer\_tel?: string
+
+  **구매자 연락처**
+
+- notice\_url?: string | string\[]
+
+  **웹훅 수신 URL**
+
+- custom\_data?: object
+
+  **가맹점 커스텀 데이터**
+
 **빌링키(`customer_uid`)로 결제 요청하기**
 
 빌링키 발급이 성공하면 실 빌링키는 `customer_uid` 와 1:1 매칭되어 **포트원 서버에 저장**됩니다. `customer_uid`를 고객사 내부서버에 저장하시고 [**비 인증 결제요청 REST API**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)를 호출하시면 결제를 발생시킬 수 있습니다.

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

@@ -31,6 +31,83 @@ targetVersions:
 
 결제 요청 시에는 [JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/readme) `IMP.request_pay(param, callback)`을 호출해야 합니다.
 
+### 주요 파라미터 설명
+
+- channelKey: string
+
+  **채널키**
+
+  결제를 진행할 채널을 지정합니다.
+
+  포트원 콘솔 내 \[결제 연동] - \[연동 정보] - \[채널 관리] 에서 확인 가능합니다.
+
+- merchant\_uid: string
+
+  **주문번호**
+
+  매번 고유하게 채번되어야 합니다. 영문, 숫자만 입력 가능합니다.
+
+- name: string
+
+  **주문명**
+
+- amount: number
+
+  **결제금액**
+
+- currency: string
+
+  **결제 통화**
+
+  카드: `KRW`, `USD`, `JPY` / Alipay: `USD`, `CNY` / WeChatPay: `KRW`, `USD`, `CNY`
+
+- buyer\_email: string
+
+  **구매자 이메일** (필수)
+
+- buyer\_name?: string
+
+  **구매자 이름**
+
+- buyer\_tel?: string
+
+  **구매자 연락처**
+
+- m\_redirect\_url?: string
+
+  **모바일 결제 후 리디렉션 될 URL**
+
+- notice\_url?: string | string\[]
+
+  **웹훅 수신 URL**
+
+- custom\_data?: object
+
+  **가맹점 커스텀 데이터**
+
+- bypass?: object
+
+  - payletter\_global?: object
+
+    - pginfo?: string
+
+      **결제 수단 지정**
+
+      특정 결제 수단만 결제창에 노출하고 싶은 경우 설정합니다.
+
+      - `PLCreditCard`: 해외카드 비인증
+      - `PLCreditCardMpi`: 해외카드 인증(3DS)
+      - `PLUnionPay_HC`: 유니온페이
+      - `WeChatPayQRCodePayment`: 위챗페이 PC결제
+      - `WeChatPayH5Payment`: 위챗페이 모바일결제
+      - `ICBAlipay`: 알리페이
+
+    - servicename?: string
+
+      **서비스명**
+
+      WeChatPay, Alipay 결제 시 필수 입력합니다.
+
 ## 가능한 빌링키 발급 및 결제 수단
 
 - **빌링키 발급 및 결제**
@@ -51,13 +128,77 @@ targetVersions:
 
 빌링키 발급 및 결제 요청 시에는 `customer_uid` 파라미터를 포함하여 [JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/readme) `IMP.request_pay(param, callback)`을 호출해야 합니다.
 
+### 주요 파라미터 설명
+
+- channelKey: string
+
+  **채널키**
+
+- merchant\_uid: string
+
+  **주문번호**
+
+- name: string
+
+  **주문명**
+
+- amount: number
+
+  **결제금액**
+
+- currency: string
+
+  **결제 통화**
+
+- customer\_uid: string
+
+  **빌링키**
+
+  빌링키 발급 시 필수 입력입니다.
+
+- buyer\_email: string
+
+  **구매자 이메일** (필수)
+
+- buyer\_name?: string
+
+  **구매자 이름**
+
+- buyer\_tel?: string
+
+  **구매자 연락처**
+
+- m\_redirect\_url?: string
+
+  **모바일 결제 후 리디렉션 될 URL**
+
+- notice\_url?: string | string\[]
+
+  **웹훅 수신 URL**
+
+- custom\_data?: object
+
+  **가맹점 커스텀 데이터**
+
+- bypass?: object
+
+  - payletter\_global?: object
+
+    - pginfo?: string
+
+      **결제 수단 지정**
+
+      - `PLCreditCard`: 해외카드 비인증
+      - `PLCreditCardMpi`: 해외카드 인증(3DS)
+      - `PLUnionPay_HC`: 유니온페이
+
 <div class="hint" data-style="warning">
 
 페이레터 해외결제는 **SDK 1.3.0 부터 사용 가능**합니다.
 
 SDK 스크립트의 주소가 `https://cdn.iamport.kr/v1/iamport.js` 인지 확인해주세요.
 
-위 JS SDK 를 이용하여 페이팔 정기결제 연동시 callback Data는 아래와 같이 두가지 형태로만 내려갑니다.
+위 JS SDK 를 이용하여 페이레터 해외결제 연동시 callback Data는 아래와 같이 두가지 형태로만 내려갑니다.
 
 - `imp_uid`
 - `merchant_uid`