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

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

@@ -82,12 +82,48 @@ IMP.request_pay(
 
   고객사에서 매번 고유하게 채번되어야 합니다.
 
+- name: string
+
+  **주문명**
+
 - amount: number
 
   **결제금액**
 
   지정하지 않은 경우 0원입니다.
 
+- buyer\_name?: string
+
+  **구매자 이름**
+
+- buyer\_email?: string
+
+  **구매자 이메일**
+
+- buyer\_tel?: string
+
+  **구매자 연락처**
+
+- buyer\_addr?: string
+
+  **구매자 주소**
+
+- buyer\_postcode?: string
+
+  **구매자 우편번호**
+
+- notice\_url?: string | string\[]
+
+  **웹훅 수신 URL**
+
+- confirm\_url?: string
+
+  **Confirm process URL**
+
+- custom\_data?: object
+
+  **가맹점 커스텀 데이터**
+
 </div>
 
 <div class="tabs-content" data-title="비 인증결제">

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

@@ -74,10 +74,10 @@ IMP.request_pay(
 
   - card (신용카드)
   - trans (실시간 계좌이체)
-  - vbank(가상계좌)
-  - phone(휴대폰 소액결제) : 휴대폰 결제인 경우 pg 파라미터는 **`danal`** 로 지정하면 됩니다.
+  - vbank (가상계좌)
+  - phone (휴대폰 소액결제) : 휴대폰 결제인 경우 pg 파라미터는 **`danal`** 로 지정하면 됩니다.
   - cultureland (컬쳐랜드 문화상품권)
-  - booknlife (도서문화상품권)
+  - happymoney (해피머니 문화상품권)
 
 - merchant\_uid: string
 
@@ -85,28 +85,106 @@ IMP.request_pay(
 
   고객사에서 매번 고유하게 채번되어야 합니다.
 
+- name: string
+
+  **주문명**
+
+- buyer\_name?: string
+
+  **구매자 이름**
+
+- buyer\_email?: string
+
+  **구매자 이메일**
+
 - buyer\_tel: string
 
   **주문자 연락처**
 
   미 설정 시 다날 결제창에서 오류 발생 가능
 
+- buyer\_addr?: string
+
+  **구매자 주소**
+
+- buyer\_postcode?: string
+
+  **구매자 우편번호**
+
 - amount: number
 
   **결제금액**
 
   지정하지 않은 경우 0원입니다.
 
+- tax\_free?: number
+
+  **면세금액** (휴대폰 결제 외)
+
 - biz\_num?: string
 
   **사업자등록번호**
 
   가상계좌 결제창 호출 시 `사업자등록번호 10자리` 필수 입력 (미설정 시 다날 결제창에서 오류 발생 가능)
 
+- vbank\_due?: string
+
+  **가상계좌 입금마감일시**
+
 - company?: string
 
   휴대폰 결제시 결제창에 표시될 표시될 상호명. 입력하지 않으면 포트원 대표상점명으로 표시됩니다.
 
+- appCard?: boolean
+
+  **앱카드 전용 모드** (휴대폰 결제 외)
+
+- auth\_mode?: string
+
+  **인증 방식** (휴대폰 결제 외)
+
+  - `key-in`: 키인 결제 모드로 결제창을 호출합니다.
+
+- 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**
+
+- bypass?: object
+
+  **다날 전용 파라미터** (휴대폰 결제 외)
+
+  - danal?: object
+
+    - COLOR?: string
+
+      **결제창 색상**
+
+    - ISCASHRECEIPTUI?: string
+
+      **현금영수증 발급 UI 표시 여부** (계좌이체/가상계좌)
+
+      - `N`: 현금영수증 발급 UI를 숨깁니다.
+
 </div>
 
 <div class="tabs-content" data-title="비인증 결제(결제창 방식)">
@@ -184,12 +262,40 @@ IMP.request_pay(
 
   비 인증 결제창에서 고객이 입력한 카드정보와 1:1로 매칭될 빌링키를 지정합니다.
 
-- amount: Integer
+- merchant\_uid: string
+
+  **고객사 채번 주문 고유번호**
+
+- name: string
+
+  **주문명**
+
+- amount: integer
 
   **결제금액**
 
   0원으로 설정시 빌링키만 발급되며 **0원 이상 설정시 실결제와 빌링키 발급이 동시**에 이루어 집니다.
 
+- buyer\_name?: string
+
+  **구매자 이름**
+
+- buyer\_email?: string
+
+  **구매자 이메일**
+
+- buyer\_tel?: string
+
+  **구매자 연락처**
+
+- buyer\_addr?: string
+
+  **구매자 주소**
+
+- buyer\_postcode?: string
+
+  **구매자 우편번호**
+
 - period?: object
 
   정기결제시 고객이 구매하는 제품에 대한 제공기간을 명시합니다. 해당 일자가 다날 결제창에 표기 됩니다.
@@ -202,6 +308,30 @@ IMP.request_pay(
 
     **YYYYMMDD**
 
+  - text?: string
+
+    **결제창 표기용 제공기간 문구** (휴대폰 빌링키 발급 시 사용)
+
+- m\_redirect\_url?: string
+
+  **모바일 결제 후 리디렉션 될 URL**
+
+- app\_scheme?: string
+
+  **모바일 앱 URL scheme** (모바일 전용, 휴대폰 결제 외)
+
+- notice\_url?: string | string\[]
+
+  **웹훅 수신 URL**
+
+- custom\_data?: object
+
+  **가맹점 커스텀 데이터**
+
+- customer\_id?: string
+
+  **구매자 고유 ID**
+
 ### 빌링키(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/daou/readme.md

@@ -15,12 +15,6 @@ targetVersions:
 
 [JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk-old/readme) `IMP.request_pay(param, callback)`을 호출하여 키움페이 결제창을 호출할 수 있습니다. **결제 결과**는 PC의 경우 `IMP.request_pay(param, callback)` 호출 후 **callback**으로 수신되고 모바일의 경우 **m\_redirect\_url**로 리디렉션됩니다.
 
-<div class="hint" data-style="warning">
-
-**키움페이 결제창 연동을 위해서는 ****JS SDK Version 1.2.0**** 이상을 사용하셔야 합니다.**
-
-</div>
-
 <div class="tabs-container">
 
 <div class="tabs-content" data-title="인증결제창 요청">
@@ -96,6 +90,7 @@ IMP.request_pay(
   - cultureland (컬쳐랜드 문화상품권)
   - smartculture (스마트문화상품권)
   - booknlife (도서문화상품권)
+  - phone (휴대폰결제)
 
 - merchant\_uid: string
 
@@ -103,49 +98,130 @@ IMP.request_pay(
 
   매번 고유하게 채번되어야 합니다.
 
-- digital: string
+- name: string
+
+  **주문명**
+
+- amount: number
+
+  **결제금액**
+
+  **string** 이 아닌 점에 유의하세요.
+
+- buyer\_name?: string
+
+  **구매자 이름**
+
+- buyer\_email?: string
+
+  **구매자 이메일**
+
+- buyer\_tel?: string
+
+  **구매자 연락처**
+
+- buyer\_addr?: string
+
+  **구매자 주소**
+
+- buyer\_postcode?: string
+
+  **구매자 우편번호**
+
+- digital: boolean
 
   **디지털 컨텐츠 여부**
 
   고객사 <-> 키움페이간 계약 상태에 따라 정해진 올바른 값을 넣어야 함. 그렇지 않은 경우 결제 진행 불가
 
-- bypass.daou.PRODUCTCODE?: string
+- tax\_free?: number
 
-  **결제 상품 고유 번호**
+  **면세금액**
 
-  값에 대해 정해진 규격이 없고 보내지 않을 경우 포트원에서 기본값(iamport)을 설정해 키움페이 측으로 전달
+- vbank\_due?: string
 
-- bypass.daou.CASHRECEIPTFLAG?: number
+  **가상계좌 입금마감일시**
 
-  **현금영수증 발급 구분코드**
+- m\_redirect\_url?: string
 
-  실시간 계좌이체, 가상계좌, 카카오페이 거래 시 키움페이에서 현금영수증 자동발급 여부 구분코드
+  **모바일 결제 후 리디렉션 될 URL**
 
-  - 실시간 계좌이체, 가상계좌인 경우
-    - `1`: 허용
-    - `0`: 차단
+- notice\_url?: string | string\[]
 
-  - 카카오페이인 경우
-    - `Y`: 허용
-    - `N`: 차단
+  **웹훅 수신 URL**
 
-- bypass.daou.DIRECT\_YN?: string
+- custom\_data?: object
 
-  **카드, 간편결제 다이렉트 호출 시 키움페이 페이지 노출여부**
+  **가맹점 커스텀 데이터**
 
-  'Y'로 입력하는 경우 키움페이 화면이 노출되지 않고 바로 카드사, 간편결제 결제창이 호출됩니다.
+- bypass?: object
 
-- app\_scheme?: string
+  **키움페이 전용 파라미터**
 
-  **모바일 앱 URL Scheme**
+  - daou?: object
 
-  모바일 앱 환경에서 결제시 필수 파라미터
+    - PRODUCTCODE?: string
 
-- amount: number
+      **결제 상품 고유 번호**
 
-  **결제금액**
+      값에 대해 정해진 규격이 없고 보내지 않을 경우 포트원에서 기본값(iamport)을 설정해 키움페이 측으로 전달
 
-  **string** 이 아닌 점에 유의하세요.
+    - CASHRECEIPTFLAG?: number | string
+
+      **현금영수증 발급 구분코드**
+
+      실시간 계좌이체, 가상계좌, 카카오페이 거래 시 키움페이에서 현금영수증 자동발급 여부 구분코드
+
+      - 실시간 계좌이체, 가상계좌인 경우
+        - `1`: 허용
+        - `0`: 차단
+
+      - 카카오페이인 경우
+        - `Y`: 허용
+        - `N`: 차단
+
+    - DIRECT\_YN?: string
+
+      **간편결제 다이렉트 호출 시 키움페이 페이지 노출여부**
+
+      `Y`로 입력하는 경우 키움페이 화면이 노출되지 않고 바로 간편결제 결제창이 호출됩니다.
+
+    - CARDQUOTA?: string
+
+      **카드사별 할부개월 수 설정**
+
+      `^` 로 구분된 다수의 카드 할부 설정 그룹으로 구성되며, 각 그룹은 `{키움페이_카드사_코드}-{할부_개월수_옵션1}:{할부_개월수_옵션2}:...` 형식으로 구성하여 카드사별 할부 개월 수를 지정합니다.
+
+      예시로 `CCBC-0:2:3:4:5:6^CCNH-0:2:3^CCKM-0:2:3:4` 를 입력하는 경우 BC카드는 일시불, 2, 3, 4, 5, 6개월, 농협카드는 일시불, 2, 3개월, 국민카드는 일시불, 2, 3, 4개월 할부가 선택 가능하도록 표시됩니다.
+
+      카드사 코드
+
+      |카드사 명   |코드|
+      |------------|----|
+      |비씨카드    |CCBC|
+      |국민카드    |CCKM|
+      |제주은행    |CCCJ|
+      |신한카드    |CCLG|
+      |씨티은행    |CCCT|
+      |롯데카드    |CCLO|
+      |신협카드    |CCCU|
+      |새마을금고  |CCMG|
+      |현대카드    |CCDI|
+      |NH카드      |CCNH|
+      |현대증권    |CCHD|
+      |우리카드    |CCPH|
+      |하나SK카드  |CCHN|
+      |우체국카드  |CCPO|
+      |전북은행    |CCJB|
+      |저축은행카드|CCSB|
+      |카카오뱅크  |CCKA|
+      |삼성카드    |CCSS|
+      |산은카드    |CCKD|
+      |수협        |CCSU|
+      |하나은행    |CCKE|
+      |토스뱅크    |CCTS|
+      |광주은행    |CCKJ|
+      |K뱅크       |CKBK|
 
 - escrow?: boolean
 
@@ -153,6 +229,12 @@ IMP.request_pay(
 
   계좌이체,가상계좌만 지원됩니다.
 
+- app\_scheme?: string
+
+  **모바일 앱 URL Scheme**
+
+  모바일 앱 환경에서 결제시 필수 파라미터
+
 </div>
 
 <div class="tabs-content" data-title="비 인증 API 요청">
@@ -311,4 +393,97 @@ curl -H "Content-Type: application/json" \
 
 </div>
 
+<div class="tabs-content" data-title="통신사 노출 제어">
+
+```json title="모든 통신사 노출"
+{
+  "phone": {
+    "detail": [
+      {
+        "carrier": "*", // 모두 활성화
+        "enabled": true
+      }
+    ]
+  }
+}
+```
+
+```json title="특정 통신사만 노출"
+{
+  "phone": {
+    "detail": [
+      {
+        "carrier": "SKT", // SKT만 활성화
+        "enabled": true
+      }
+    ]
+  }
+}
+```
+
+```json title="2개 이상 통신사 노출"
+{
+  "phone": {
+    "detail": [
+      {
+        "carrier": "SKT",
+        "enabled": true
+      },
+      {
+        "carrier": "KTF",
+        "enabled": true
+      },
+      {
+        "carrier": "LGT",
+        "enabled": false
+      },
+      {
+        "carrier": "CJH",
+        "enabled": false
+      }
+    ]
+  }
+}
+// SKT, KTF 을 제외한 나머지 통신사는 비활성화 됩니다.
+```
+
+```json title="특정 통신사만 비노출"
+{
+  "phone": {
+    "detail": [
+      {
+        "carrier": "SKT",
+        "enabled": false
+      }
+    ]
+  }
+}
+```
+
+<div class="hint" data-style="info">
+
+`phone 파라미터 미 설정시`(기본값) 모든 통신사 노출됨
+
+</div>
+
+</div>
+
+<div class="tabs-content" data-title="휴대폰 번호 고정">
+
+```json
+{
+  "prefill": {
+    "phoneNumber": "휴대폰번호" // 휴대폰번호 입력(하이픈 제거)
+  }
+}
+```
+
+<div class="hint" data-style="info">
+
+휴대폰 결제시 해당 파라미터를 설정하면 휴대폰번호를 고정시킬수 있습니다.
+
+</div>
+
+</div>
+
 </div>

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

@@ -88,14 +88,34 @@ IMP.request_pay(
 
   매번 고유하게 채번되어야 합니다.
 
-- buyer: string
+- name: string
+
+  **주문명**
+
+- buyer\_name: string
 
   **구매자명**
 
+- buyer\_email?: string
+
+  **구매자 이메일**
+
 - buyer\_tel: string
 
   **구매자 연락처**
 
+- buyer\_addr?: string
+
+  **구매자 주소**
+
+  `bypass.shipTo_street1`의 기본값으로 사용됩니다.
+
+- buyer\_postcode?: string
+
+  **구매자 우편번호**
+
+  `bypass.shipTo_postalCode`의 기본값으로 사용됩니다.
+
 - amount: number
 
   **결제금액**
@@ -104,26 +124,104 @@ IMP.request_pay(
 
 - currency?: string
 
-  **결제통화코드**
+  **결제통화코드** (기본값: USD)
 
-  - KRW
-  - USD
-  - EUR
-  - GBP
-  - JPY
-  - THB
-  - SGD
-  - RUB
-  - HKD
-  - CAD
-  - AUD
+  KRW, USD, EUR, GBP, JPY, THB, SGD, RUB, HKD, CAD, AUD
 
 - language?: string
 
-  - 한국어 : ko
-  - 영어 : en
-  - 중국어 : zh
-  - 일본어 : jp
+  **결제창 언어**
+
+  - `ko`: 한국어
+  - `en`: 영어
+  - `zh`: 중국어
+  - `jp`: 일본어
+
+- popup?: boolean
+
+  **팝업창 활성화 여부**
+
+- m\_redirect\_url?: string
+
+  **모바일 결제 후 리디렉션 될 URL**
+
+- notice\_url?: string | string\[]
+
+  **웹훅 수신 URL**
+
+- custom\_data?: object
+
+  **가맹점 커스텀 데이터**
+
+- bypass?: object
+
+  **엑심베이 전용 파라미터**
+
+  - eximbay?: object
+
+    - issuercountry?: string
+
+      **국내 결제창 호출 시 `KR`로 설정**
+
+    - shipTo\_city?: string
+
+      **배송지 도시**
+
+    - shipTo\_country?: string
+
+      **배송지 국가코드**
+
+    - shipTo\_firstName?: string
+
+      **수취인 이름**
+
+    - shipTo\_lastName?: string
+
+      **수취인 성**
+
+    - shipTo\_phoneNumber?: string
+
+      **수취인 연락처**
+
+    - shipTo\_state?: string
+
+      **배송지 주/도**
+
+    - billTo\_city?: string
+
+      **청구지 도시**
+
+    - billTo\_country?: string
+
+      **청구지 국가코드**
+
+    - billTo\_firstName?: string
+
+      **청구인 이름**
+
+    - billTo\_lastName?: string
+
+      **청구인 성**
+
+    - billTo\_phoneNumber?: string
+
+      **청구인 연락처**
+
+    - billTo\_postalCode?: string
+
+      **청구지 우편번호**
+
+    - billTo\_state?: string
+
+      **청구지 주/도**
+
+    - billTo\_street1?: string
+
+      **청구지 주소**
+
+    - siteforeigncur?: string
+
+      **외화 표시 통화**
 
 </div>
 
@@ -181,7 +279,9 @@ IMP.request_pay(
 ```json
 {
   "bypass": {
-    "issuercountry": "KR"
+    "eximbay": {
+      "issuercountry": "KR"
+    }
   }
 }
 ```
@@ -218,7 +318,9 @@ IMP.request_pay({
   buyer_postcode: "123-456",
   popup: false,
   bypass: {
-    issuercountry: "KR",
+    eximbay: {
+      issuercountry: "KR",
+    },
   },
 });
 ```