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

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

@@ -127,12 +127,32 @@ IMP.request_pay(
 
   소수점 두번째 자리까지 허용합니다.
 
+- buyer\_name?: string
+
+  **구매자 이름**
+
+- buyer\_email?: string
+
+  **구매자 이메일**
+
 - buyer\_tel: string
 
   **구매자 전화번호**
 
   주의: 스마트로 일반 결제시 필수 입력
 
+- buyer\_addr?: string
+
+  **구매자 주소**
+
+- buyer\_postcode?: string
+
+  **구매자 우편번호**
+
+- tax\_free?: number
+
+  **면세금액**
+
 - vbank\_due: string
 
   **가상계좌 입금기한 (YYYY-MM-DD)**
@@ -143,6 +163,12 @@ IMP.request_pay(
 
   **에스크로 결제 여부**
 
+- digital?: boolean
+
+  **디지털 컨텐츠 여부**
+
+  휴대폰 소액결제 시 필수 입력합니다.
+
 - period?: object
 
   **서비스 제공 기간**
@@ -157,6 +183,63 @@ IMP.request_pay(
 
     **YYYYMMDD**
 
+- m\_redirect\_url?: string
+
+  **모바일 결제 후 리디렉션 될 URL**
+
+- app\_scheme?: string
+
+  **모바일 앱 URL scheme** (모바일 전용)
+
+- notice\_url?: string | string\[]
+
+  **웹훅 수신 URL**
+
+- confirm\_url?: string
+
+  **Confirm process URL**
+
+- custom\_data?: object
+
+  **가맹점 커스텀 데이터**
+
+- bypass?: object
+
+  - cashReceiptType?: string
+
+    **현금영수증 발급 유형** (계좌이체/가상계좌 전용)
+
+    - anonymous (미발행, 자진발급)
+    - personal (소득공제)
+    - corporate (지출증빙)
+
+  - customerIdentifier?: string
+
+    **현금영수증 발급 식별번호** (계좌이체/가상계좌 전용)
+
+    휴대폰번호, 사업자등록번호, 현금영수증 카드번호를 입력할 수 있습니다.
+
+  - smartro\_v2?: object
+
+    **스마트로 전용 파라미터**
+
+    - GoodsCnt?: number
+
+      **결제 상품 품목 개수**
+
+    - SkinColor?: string
+
+      **UI 스타일**
+
+      - `RED` (기본값), `GREEN`, `BLUE`, `PURPLE`
+
+    - OpenType?: string
+
+      **결제창 언어**
+
+      - `KR`: 국내 (기본값)
+      - `EN`: 영문 (해외카드 전용 결제창)
+
 </details>
 
 <details>
@@ -253,6 +336,10 @@ IMP.request_pay(
 
   주의: 스마트로 일반결제시 주문 번호에 특수문자 사용 불가
 
+- name: string
+
+  **주문명**
+
 - customer\_uid: string
 
   **빌링키 발급을 위한 결제 수단을 특정하는 고유 번호**
@@ -265,6 +352,18 @@ IMP.request_pay(
 
   주의: 스마트로 빌링키 발급시 필수 입력으로 입력 길이는 **20자**로 제한됩니다.
 
+- buyer\_name?: string
+
+  **구매자 이름**
+
+- buyer\_email?: string
+
+  **구매자 이메일**
+
+- buyer\_tel?: string
+
+  **구매자 연락처**
+
 - m\_redirect\_url: string
 
   **리다이렉트 URL**
@@ -273,6 +372,33 @@ IMP.request_pay(
 
   스마트로의 경우 모바일 환경에서 **리디렉션 방식으로 빌링키 발급창이 렌더링 되기 때문에 필수입력입니다.**
 
+- notice\_url?: string | string\[]
+
+  **웹훅 수신 URL**
+
+- custom\_data?: object
+
+  **가맹점 커스텀 데이터**
+
+- bypass?: object
+
+  - smartro\_v2?: object
+
+    **스마트로 빌링키 발급 전용 파라미터**
+
+    - SkinColor?: string
+
+      **UI 스타일**
+
+      - `RED` (기본값), `GREEN`, `BLUE`, `PURPLE`
+
+    - IsPwdPass?: string
+
+      **결제 비밀번호 등록 Skip 여부**
+
+      - `Y`: 비밀번호 설정 미사용
+      - `N`: 비밀번호 설정 사용 (기본값)
+
 </details>
 
 </div>

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

@@ -93,12 +93,90 @@ IMP.request_pay(
 
   매번 고유하게 채번되어야 합니다.
 
+- name: string
+
+  **주문명**
+
 - amount: number
 
   **결제금액**
 
   **string** 이 아닌점에 유의하세요
 
+- buyer\_name?: string
+
+  **구매자 이름**
+
+- buyer\_email?: string
+
+  **구매자 이메일**
+
+- buyer\_tel?: string
+
+  **구매자 연락처**
+
+- buyer\_addr?: string
+
+  **구매자 주소**
+
+- buyer\_postcode?: string
+
+  **구매자 우편번호**
+
+- escrow?: boolean
+
+  **에스크로 설정여부**
+
+- digital?: boolean
+
+  **디지털 컨텐츠 여부**
+
+  - `true`: 컨텐츠
+  - `false`: 실물 상품
+
+- language?: string
+
+  **결제창 언어**
+
+  - `ko`: 한국어 (기본값)
+  - `en`: 영어
+
+- vbank\_due?: string
+
+  **가상계좌 입금마감일시**
+
+- period?: object
+
+  **서비스 제공기간**
+
+  - from?: string
+
+    **시작일 (YYYYMMDD)**
+
+  - to?: string
+
+    **종료일 (YYYYMMDD)**
+
+- m\_redirect\_url?: string
+
+  **모바일 결제 후 리디렉션 될 URL**
+
+- app\_scheme?: string
+
+  **모바일 앱 URL scheme** (모바일 전용)
+
+- notice\_url?: string | string\[]
+
+  **웹훅 수신 URL**
+
+- confirm\_url?: string
+
+  **Confirm process URL**
+
+- custom\_data?: object
+
+  **가맹점 커스텀 데이터**
+
 </div>
 
 </div>

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

@@ -80,17 +80,63 @@ 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
+
+  **면세금액**
+
+- m\_redirect\_url?: string
+
+  **모바일 결제 후 리디렉션 될 URL**
+
+- app\_scheme?: string
+
+  **모바일 앱 URL scheme** (모바일 전용)
+
+  모바일 앱에서 결제 시 설정하면 결제 완료 후 해당 앱으로 돌아옵니다.
+
+- notice\_url?: string | string\[]
+
+  **웹훅 수신 URL**
+
+- confirm\_url?: string
+
+  **Confirm process URL**
+
+- custom\_data?: object
+
+  **가맹점 커스텀 데이터**
 
 </div>
 

package/assets/docs/opi/ko/integration/pg/v1/spb/readme.md

@@ -80,6 +80,14 @@ SDK 스크립트의 주소가 `https://cdn.iamport.kr/v1/iamport.js 인지 확
 </script>
 ```
 
+<div class="hint" data-style="warning">
+
+페이지 내에 `id="paypal"`인 HTML 요소를 사용하지 마세요.
+
+페이팔 SDK가 내부적으로 동일한 id를 사용하기 때문에 충돌이 발생하여 결제 오류가 발생할 수 있습니다.
+
+</div>
+
 <div class="hint" data-style="info">
 
 ### 페이팔 일반결제 버튼이 보이지 않을 때
@@ -120,7 +128,7 @@ attribute가 `paypal-spb`인 elemente도 2개 이상인 경우, “동일한 dat
   <!-- ...중략 -->
   <label for="amount">결제 금액</label>
   <!-- 4. 구매자가 쿠폰을 적용해 결제 요청 금액이 변경(예) 1000 -> 2000)되었습니다. -->
-  <input id="amount" name="amount" value="1000" onchnage="onChangeAmount()" />
+  <input id="amount" name="amount" value="1000" onchange="onChangeAmount()" />
 </form>
 
 <!--
@@ -169,30 +177,93 @@ attribute가 `paypal-spb`인 elemente도 2개 이상인 경우, “동일한 dat
 
 ## loadUI 요청 객체
 
-|파라미터                                                                                              |데이터타입|필수여부    |의미                                                                                                                                                                                                                                                                                                                                                                                                                              |
-|------------------------------------------------------------------------------------------------------|----------|------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-|merchant\_uid                                                                                         |string    |required    |고객사 채번 주문 고유 번호                                                                                                                                                                                                                                                                                                                                                                                                        |
-|name                                                                                                  |string    |optional    |제품명                                                                                                                                                                                                                                                                                                                                                                                                                            |
-|amount                                                                                                |number    |required    |금액                                                                                                                                                                                                                                                                                                                                                                                                                              |
-|\~\~pg(deprecated)\`\`                                                                                |~~string~~|~~required~~|~~paypal\_v2~~                                                                                                                                                                                                                                                                                                                                                                                                                    |
-|channelKey                                                                                            |string    |required    |<p>paypal\_v2 채널의 채널 키 </p><p>(포트원 콘솔 내 \[결제 연동] - \[연동 정보] - \[채널 관리] 에서 확인 가능합니다.)</p>                                                                                                                                                                                                                                                                                                         |
-|pay\_method                                                                                           |string    |required    |paypal (결제수단)                                                                                                                                                                                                                                                                                                                                                                                                                 |
-|[country](http://chaifinance.notion.site/country-29b79aaa067846cea251a7875b0f6ed4)                    |string    |optional    |<p>국가 코드</p><p>주의: 페이팔 일반결제 테스트 모드시에만 유효</p>                                                                                                                                                                                                                                                                                                                                                               |
-|customer\_id                                                                                          |string    |optional    |고객사가 구매자를 특정하기 위해 채번한 고유 번호                                                                                                                                                                                                                                                                                                                                                                                  |
-|buyer\_name                                                                                           |string    |optional    |구매자 전체 이름                                                                                                                                                                                                                                                                                                                                                                                                                  |
-|[buyer\_first\_name](http://chaifinance.notion.site/buyer_first_name-b40318cbf8e2489385a58cc59ae7ab7e)|string    |optional    |구매자 이름 주의: 페이팔에서만 유효하며 buyer\_name이 아닌 buyer\_first\_name과 buyer\_last\_name 입력을 권장                                                                                                                                                                                                                                                                                                                     |
-|[buyer\_last\_name](http://chaifinance.notion.site/buyer_last_name-0571c7432cf44c0ab6f3fddf34238666)  |string    |optional    |구매자 성 주의: 페이팔에서만 유효하며 buyer\_name이 아닌 buyer\_first\_name과 buyer\_last\_name 입력을 권장                                                                                                                                                                                                                                                                                                                       |
-|buyer\_tel                                                                                            |string    |optional    |구매자 전화번호                                                                                                                                                                                                                                                                                                                                                                                                                   |
-|buyer\_email                                                                                          |string    |optional    |구매자 이메일 주소                                                                                                                                                                                                                                                                                                                                                                                                                |
-|notice\_url                                                                                           |string    |optional    |<p>결제 창에서 결제 승인 완료 또는 가상계좌 발급 완료시 고객사에게 노티 될 웹훅 URL string 또는 string\[]로 N개 설정 가능</p><p>웹훅이 잘 발송 됐는지는 결제 승인 내역에서 아임포트 번호를 눌러봤을때 웹훅 발송 내역을 보고 확인할 수 있음</p>                                                                                                                                                                                    |
-|confirm\_url                                                                                          |string    |optional    |<p>결제창이 호출되고 구매자가 최종 결제 승인을 하기까지 수량 소진 등 모종의 사유로 더이상 결제가 불가능 하게 되는 상황을 대비해, 최종 결제 승인 직전 최종 결제 승인 여부를 질의할 고객사 웹서버 endpoint</p><p>아임포트가 해당 endpoint로 최종 결제 승인 질의시, 200 외의 응답을 받으면 최종 결제 승인을 시키지 않고 결제 실패 상태로 기록함</p><p /><p>
-
-<strong>주의: 아임포트 CS팀으로 해당 기능 사용 신청을 해야 함</strong>
-
-</p>|
-|[products](http://chaifinance.notion.site/products-9107dec19480457bbfeb06e9244eb31c)                  |array     |optional    |결제 상품 정보                                                                                                                                                                                                                                                                                                                                                                                                                    |
-|[currency](http://chaifinance.notion.site/currency-196b9c5e6a8543df9059ff20199028fc)                  |string    |optional    |결제 통화 (기본값: USD)                                                                                                                                                                                                                                                                                                                                                                                                           |
-|custom\_data                                                                                          |object    |optional    |결제 정보와 함께 관리하고 싶은 고객사 커스텀 JSON 데이터                                                                                                                                                                                                                                                                                                                                                                          |
+- channelKey: string
+
+  **채널키**
+
+  paypal\_v2 채널의 채널 키입니다. 포트원 콘솔 내 \[결제 연동] - \[연동 정보] - \[채널 관리] 에서 확인 가능합니다.
+
+- pg(deprecated)?: string
+
+  ~~`paypal_v2`로 지정합니다.~~
+
+- pay\_method: string
+
+  **결제수단 구분코드**
+
+  `paypal`로 지정합니다.
+
+- merchant\_uid: string
+
+  **고객사 채번 주문 고유 번호**
+
+- name?: string
+
+  **제품명**
+
+- amount: number
+
+  **금액**
+
+- currency?: string
+
+  **결제 통화** (기본값: USD)
+
+- country?: string
+
+  **국가 코드**
+
+  주의: 페이팔 일반결제 **테스트 모드시에만** 유효합니다.
+
+- customer\_id?: string
+
+  **구매자 고유 ID**
+
+  고객사가 구매자를 특정하기 위해 채번한 고유 번호
+
+- buyer\_name?: string
+
+  **구매자 전체 이름**
+
+- buyer\_first\_name?: string
+
+  **구매자 이름**
+
+  페이팔에서만 유효하며 `buyer_name`이 아닌 `buyer_first_name`과 `buyer_last_name` 입력을 권장합니다.
+
+- buyer\_last\_name?: string
+
+  **구매자 성**
+
+  페이팔에서만 유효하며 `buyer_name`이 아닌 `buyer_first_name`과 `buyer_last_name` 입력을 권장합니다.
+
+- buyer\_tel?: string
+
+  **구매자 전화번호**
+
+- buyer\_email?: string
+
+  **구매자 이메일 주소**
+
+- notice\_url?: string | string\[]
+
+  **웹훅 수신 URL**
+
+  결제 승인 완료 시 고객사에게 웹훅이 발송됩니다.
+
+- confirm\_url?: string
+
+  **Confirm process URL**
+
+  최종 결제 승인 직전 승인 여부를 질의할 고객사 서버 URL입니다. 200 외의 응답을 받으면 결제가 중단됩니다.
+
+- products?: array
+
+  **결제 상품 정보**
+
+- custom\_data?: object
+
+  **가맹점 커스텀 데이터**
 
 <div class="hint" data-style="warning">
 

package/assets/docs/opi/ko/integration/pg/v1/toss-brandpay/module.md

@@ -67,7 +67,7 @@ await IMP.loadModule(
   브랜드페이의 모듈 로딩에 필요한 추가 파라미터입니다.
   `moduleType`을 `toss-brandpay`로 설정하는 경우 필요합니다.
 
-- loadBrandpayOptions.customer\_id: string
+- customerKey: string
 
   **구매자 ID**
 

package/assets/docs/opi/ko/integration/pg/v1/toss-brandpay/readme.md

@@ -131,10 +131,42 @@ IMP.request_pay(
 
   브랜드페이는 원화 결제만 지원합니다. KRW 기준으로 금액을 입력해주세요.
 
+- buyer\_name?: string
+
+  **구매자 이름**
+
 - buyer\_email?: string
 
   **구매자 email 주소**
 
+- buyer\_tel?: string
+
+  **구매자 연락처**
+
+- buyer\_addr?: string
+
+  **구매자 주소**
+
+- buyer\_postcode?: string
+
+  **구매자 우편번호**
+
+- tax\_free?: number
+
+  **면세금액**
+
+- notice\_url?: string | string\[]
+
+  **웹훅 수신 URL**
+
+- confirm\_url?: string
+
+  **Confirm process URL**
+
+- custom\_data?: object
+
+  **가맹점 커스텀 데이터**
+
 - customer\_id: string
 
   **구매자 ID**
@@ -144,7 +176,7 @@ IMP.request_pay(
 
 - bypass?: object
 
-  - isCulturalExpense: string
+  - isCulturalExpense?: boolean
 
     **도서 문화비 결제 여부**
 
@@ -298,7 +330,7 @@ IMP.request_pay(
 
 아래 파라미터는 브랜드페이 위젯에서는 사용할 수 없습니다.
 
-- **`display.card_quot`**
+- **`display.card_quota`**
 - **`useCardPoint`**
 - **`bypass.cashReceiptType`**
 - **`bypass.customerIdentifier`**

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

@@ -84,9 +84,12 @@ IMP.request_pay(
   **결제수단 구분코드**
 
   - card(신용카드)
-  - transfer(퀵계좌이체)
+  - trans(실시간 계좌이체)
   - vbank(가상계좌)
   - phone(휴대폰소액결제)
+  - cultureland(컬쳐랜드 문화상품권)
+  - smartculture(스마트문상)
+  - booknlife(도서문화상품권)
   - applepay(애플페이)
   - tosspay(토스페이)
   - naverpay(네이버페이)
@@ -101,12 +104,122 @@ IMP.request_pay(
 
   매번 고유하게 채번되어야 합니다.
 
+- name: string
+
+  **주문명**
+
 - amount: number
 
   **결제금액**
 
   **string** 이 아닌점에 유의하세요
 
+- buyer\_name?: string
+
+  **구매자 이름**
+
+- buyer\_email?: string
+
+  **구매자 이메일**
+
+- buyer\_tel?: string
+
+  **구매자 연락처**
+
+- buyer\_addr?: string
+
+  **구매자 주소**
+
+- buyer\_postcode?: string
+
+  **구매자 우편번호**
+
 - escrow?: boolean
 
   **에스크로 설정여부**
+
+- tax\_free?: number
+
+  **면세금액**
+
+- vbank\_due?: string
+
+  **가상계좌 입금마감일시**
+
+  `YYYYMMDD` 또는 `YYYYMMDDHHmmss` 형식으로 지정합니다.
+
+- language?: string
+
+  **결제창 언어**
+
+  - `ko`: 한국어 (기본값)
+  - `en`: 영어
+
+- appCard?: boolean
+
+  **앱카드 전용 모드**
+
+  `true` 설정 시 신용카드 결제모듈에서 앱카드 결제만 활성화됩니다.
+
+- m\_redirect\_url?: string
+
+  **모바일 결제 후 리디렉션 될 URL**
+
+- app\_scheme?: string
+
+  **모바일 앱 URL scheme** (모바일 전용)
+
+- notice\_url?: string | string\[]
+
+  **웹훅 수신 URL**
+
+- confirm\_url?: string
+
+  **Confirm process URL**
+
+- custom\_data?: object
+
+  **가맹점 커스텀 데이터**
+
+- display?: object
+
+  **결제창에 렌더링될 카드 할부 개월수 리스트 설정값**
+
+  - card\_quota?: number\[]
+
+    **할부 개월수**
+
+    예시
+
+    - `[]`: 일시불만 결제 가능
+    - `[2,3,4,5,6]`: 일시불을 포함한 2, 3, 4, 5, 6개월까지 할부개월 선택 가능
+
+- card?: object
+
+  **카드 결제 옵션**
+
+  - direct?: object
+
+    **카드사 다이렉트 호출 정보**
+
+    - code?: string
+
+      **카드사 금융결제원 표준 코드**
+
+      [카드사 코드](https://developers.portone.io/opi/ko/support/code-info/card-code) 참조
+
+    - quota?: number
+
+      **할부 개월 수**
+
+      일시불일 시 0으로 설정합니다.
+
+- bypass?: object
+
+  **토스페이먼츠 구모듈 전용 파라미터**
+
+  - uplus?: object
+
+    - LGD\_AUTO\_DISCOUNT?: string
+
+      **카드 프로모션 자동 적용 여부**