@portone/mcp-server 0.15.0 → 0.16.0

package/assets/docs/opi/ko/integration/pg/v1/inicis-jp.md

@@ -30,7 +30,7 @@ targetVersions:
 ## SDK 결제 요청하기
 
 [JavaScript SDK (신규)](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/readme)의 `IMP.request_pay(param, callback)`을 호출하여
-KSNET 결제창을 호출할 수 있습니다. **결제결과**는 PC의 경우 `IMP.request_pay(param, callback)` 호출 후
+이니시스 일본결제 결제창을 호출할 수 있습니다. **결제결과**는 PC의 경우 `IMP.request_pay(param, callback)` 호출 후
 **callback**으로 수신되고 모바일의 경우 **m\_redirect\_url**로 리디렉션됩니다.
 
 <div class="hint" data-style="info">
@@ -94,10 +94,8 @@ IMP.request_pay(
         close: "23:00",
       },
     },
-    card: {
-      display: {
-        card_quota: [0, 3, 5, 6, 10, 12],
-      },
+    display: {
+      card_quota: [0, 3, 5, 6, 10, 12],
     },
     cvs: {
       payment_deadline: {
@@ -150,6 +148,8 @@ IMP.request_pay(
 
   고객사에서 매번 고유하게 채번되어야 합니다.
 
+  알파벳 대소문자, 숫자 및 일부 특수문자만 사용이 가능하여 사용에 유의가 필요합니다.
+
 - name: string
 
   **주문명**
@@ -174,7 +174,7 @@ IMP.request_pay(
 
   **결제창 팝업 여부**
 
-  이니시스 일본결제는 팝업 결제창만 지원합니다. (iframe 미지원)
+  이니시스 일본결제는 PC환경에서는 팝업 결제창만 지원합니다. (iframe 미지원)
 
 - buyer\_name: string
 
@@ -260,20 +260,17 @@ IMP.request_pay(
 
       HH:mm 포맷으로 입력해야하며 00:00\~23:59 범위의 값만 허용합니다.
 
-- card?: object
-
-  **카드 결제 시 파라미터**
+- display?: object
 
-  - display?: object
+  - card\_quota?: number\[]
 
-    - card\_quota?: number\[]
+    **카드 할부 개월수 리스트**
 
-      **카드 할부 개월수 리스트**
+    이니시스 일본결제의 경우 일시불, 3, 5, 6, 10, 12개월만 지정 가능합니다.
 
-      이니시스 일본결제의 경우 일시불, 3, 5, 6, 10, 12개월만 지정 가능합니다.
-
-      - `[]`: 할부개월 수로 일시불만 노출
-      - `[3, 5, 6]`: 할부개월 수로 일시불 및 3, 5, 6개월 노출
+    - `[0]`: 일시불만 노출
+    - `[3, 5, 6]`: 할부개월 수로 3, 5, 6개월 노출
+    - `[0, 3, 5, 6]`: 할부개월 수로 일시불 및 3, 5, 6개월 노출
 
 - cvs?: object
 
@@ -287,9 +284,9 @@ IMP.request_pay(
 
     - valid\_hours?: integer
 
-      **유효 시간**
+      **유효 시간 (시간 단위)**
 
-      이니시스 일본결제의 경우 일시불, 3, 5, 6, 10, 12개월만 지정 가능합니다.
+      편의점 결제의 지불기한을 시간 단위로 지정합니다. 현재 시간 기준으로 계산되며 최소 1일\~최대 30일 범위의 일수로 변환됩니다.
 
     - due\_date?: string
 
@@ -297,6 +294,18 @@ IMP.request_pay(
 
       시간은 ISO8601 형식으로 입력해야 합니다.
 
+- m\_redirect\_url?: string
+
+  **모바일 결제 후 리디렉션 될 URL**
+
+- notice\_url?: string | string\[]
+
+  **웹훅 수신 URL**
+
+- custom\_data?: object
+
+  **가맹점 커스텀 데이터**
+
 - bypass?: object
 
   - inicis\_jp?: object
@@ -348,12 +357,11 @@ IMP.request_pay(
     buyer_name: "Port One",
     buyer_email: "buyer@example.com",
     buyer_tel: "0216705176",
+    customer_id: "customer_portone",
     m_redirect_url: "https://helloworld.com/payments/result",
     notice_url: "https://helloworld.com/api/v1/payments/notice",
-    card: {
-      display: {
-        card_quota: [0, 3, 5, 6, 10, 12],
-      },
+    display: {
+      card_quota: [0, 3, 5, 6, 10, 12],
     },
     bypass: {
       inicis_jp: {
@@ -394,6 +402,8 @@ IMP.request_pay(
 
   고객사에서 매번 고유하게 채번되어야 합니다.
 
+  알파벳 대소문자, 숫자 및 일부 특수문자만 사용이 가능하여 사용에 유의가 필요합니다.
+
 - name: string
 
   **주문명**
@@ -418,7 +428,7 @@ IMP.request_pay(
 
   **결제창 팝업 여부**
 
-  이니시스 일본결제는 팝업 결제창만 지원합니다. (iframe 미지원)
+  이니시스 일본결제는 PC환경에서는 팝업 결제창만 지원합니다. (iframe 미지원)
 
 - buyer\_name: string
 
@@ -432,18 +442,35 @@ IMP.request_pay(
 
   **주문자 연락처**
 
-- card?: object
+- customer\_id: string
+
+  **구매자 ID**
+
+  CBT 유형이 SBPS인 경우 필수 입력이며 최대 30자로 설정해야합니다.
+
+- display?: object
+
+  - card\_quota?: number\[]
+
+    **카드 할부 개월수 리스트**
+
+    이니시스 일본결제의 경우 일시불, 3, 5, 6, 10, 12개월만 지정 가능합니다.
+
+    - `[0]`: 일시불만 노출
+    - `[3, 5, 6]`: 할부개월 수로 3, 5, 6개월 노출
+    - `[0, 3, 5, 6]`: 할부개월 수로 일시불 및 3, 5, 6개월 노출
+
+- m\_redirect\_url?: string
 
-  - display?: object
+  **모바일 결제 후 리디렉션 될 URL**
 
-    - card\_quota?: number\[]
+- notice\_url?: string | string\[]
 
-      **카드 할부 개월수 리스트**
+  **웹훅 수신 URL**
 
-      이니시스 일본결제의 경우 일시불, 3, 5, 6, 10, 12개월만 지정 가능합니다.
+- custom\_data?: object
 
-      - `[]`: 할부개월 수로 일시불만 노출
-      - `[3, 5, 6]`: 할부개월 수로 일시불 및 3, 5, 6개월 노출
+  **가맹점 커스텀 데이터**
 
 - bypass?: object
 

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

@@ -112,6 +112,7 @@ IMP.request_pay(
   - `phone` (휴대폰소액결제)
   - `cultureland` (컬쳐랜드 문화상품권)
   - `smartculture` (스마트문상)
+  - `happymoney` (해피머니 문화상품권)
   - `booknlife`(도서문화상품권)
 
   </details>
@@ -122,22 +123,93 @@ 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
 
   가상계좌 입금마감일시를 지정할수 있습니다.(미 지정시 Default 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
+
+  **가맹점 커스텀 데이터**
+
+  결제 정보와 함께 저장할 커스텀 데이터입니다. 결제 조회 시 반환됩니다.
+
+- customer\_id?: string
+
+  **구매자 고유 ID**
+
+- digital?: boolean
+
+  **디지털 컨텐츠 여부**
+
+  휴대폰 소액결제 시 디지털 컨텐츠(`true`)인지 실물 상품(`false`)인지 구분합니다.
+
+- language?: string
+
+  **결제창 언어**
+
+  - `ko`: 한국어 (기본값)
+  - `en`: 영어
+
 - period?: object
 
   고객이 구매하는 제품에 대한 제공기간을 명시합니다.
@@ -150,6 +222,58 @@ IMP.request_pay(
 
     **YYYYMMDD**
 
+- bypass?: object
+
+  **KG이니시스 전용 파라미터**
+
+  PC와 모바일에서 사용하는 파라미터가 다릅니다.
+
+  - acceptmethod?: string
+
+    **PC 전용 옵션** (콜론 `:` 구분자로 여러 값 연결)
+
+    - `noeasypay`: 간편결제 버튼을 통합결제창에서 제외
+    - `CARDPOINT`: 카드사 포인트 사용
+    - `no_receipt`: 현금영수증 미발행
+    - `SKIN(색상)`: 결제창 배경색상 변경. 색상표 값으로 설정 가능 (예: `SKIN(BLUE)`). 미설정 시 기본값 `#c1272c`
+    - `cardshowopt(카드코드-호출옵션)`: 신용카드 ACS 창에서 앱카드/안심클릭/간편결제 UI 표시 옵션. 카드코드와 호출옵션은 `-`로 구분 (예: `cardshowopt(04-6)`)
+    - `disablepoint`: 현대카드 M포인트 강제 미사용
+    - `usespcp`: 현대카드 M포인트 사용
+    - `cd_ps(카드코드-할부개월)`: 신한카드 제휴 옵션 (배송비 혜택)
+
+    예시: `"acceptmethod": "noeasypay:CARDPOINT:SKIN(BLUE)"`
+
+  - P\_RESERVED?: string
+
+    **모바일 전용 옵션** (`&` 구분자로 여러 값 연결)
+
+    - `noeasypay=Y`: 간편결제 버튼을 통합결제창에서 제외
+    - `cp_yn=Y`: 신용카드 포인트 사용
+    - `dcp_yn=Y`: 카드사 다이렉트 호출 시 카드 포인트 사용
+    - `vbank_receipt=Y`: 가상계좌 현금영수증 입력란 표시 (기본적으로 미표시)
+    - `bank_receipt=N`: 계좌이체 현금영수증 입력란 숨김 (기본적으로 표시)
+    - `twotrs_bank=Y`: 계좌이체 거래 시 필수 입력 값
+    - `apprun_check=Y`: 앱 호출 시 Intent 방식으로 호출 (Android 전용, `app_scheme`과 같이 사용 불가)
+    - `app_scheme=스키마명://`: 가맹점 앱 scheme 설정 (iOS 지원, ISP/뱅크월렛/은련카드/LPAY/페이코 등)
+    - `iosapp=Y`: iOS 앱에서 결제 시 설정
+    - `cardshowopt=카드코드:호출옵션`: 신용카드 ACS 창 표시 옵션
+
+    예시: `"P_RESERVED": "noeasypay=Y&twotrs_bank=Y&apprun_check=Y"`
+
+  - ini\_PAYSHOT\_KEY?: string
+
+    **현대카드 Payshot 고객 Key** (PC 전용)
+
+    현대카드 Payshot 사용 시 필수 입력합니다.
+    형식: `{가맹점구분}{YYYYMMDDHHMMSSmsec}{고객id}`
+
+  - P\_PAYSHOT\_KEY?: string
+
+    **현대카드 Payshot 고객 Key** (모바일 전용)
+
+    현대카드 Payshot 사용 시 필수 입력합니다.
+    형식: `{가맹점구분}{YYYYMMDDHHMMSSmsec}{고객id}`
+
 </div>
 
 <div class="tabs-content" data-title="비인증 결제창 요청">
@@ -218,12 +342,65 @@ IMP.request_pay(
 
   비 인증 결제창에서 고객이 입력한 카드정보와 1:1로 매칭될 빌링키를 지정합니다.
 
+- merchant\_uid: string
+
+  **주문번호**
+
+- name: string
+
+  **주문명**
+
 - amount: number
 
   **결제금액**
 
   결제창에 표시될 금액으로 실제 승인은 이루어지지 않습니다.(실 결제를 발생시키기 위해서는 **customer\_uid** 로 **REST API 를 이용하여 결제요청**을 해주셔야 합니다.)
 
+- buyer\_name?: string
+
+  **구매자 이름**
+
+- buyer\_email?: string
+
+  **구매자 이메일**
+
+- buyer\_tel?: string
+
+  **구매자 연락처**
+
+- m\_redirect\_url?: string
+
+  **모바일 결제 후 리디렉션 될 URL**
+
+- app\_scheme?: string
+
+  **모바일 앱 URL scheme** (모바일 전용)
+
+- notice\_url?: string | string\[]
+
+  **웹훅 수신 URL**
+
+- custom\_data?: object
+
+  **가맹점 커스텀 데이터**
+
+- customer\_id?: string
+
+  **구매자 고유 ID**
+
+- bypass?: object
+
+  **빌링키 발급 전용 파라미터**
+
+  - inicis?: object
+
+    - authtype?: string
+
+      **빌링키 발급 결제창 표시 구분** (모바일 전용)
+
+      - `01`: 카드번호, 유효기간, 생일 입력 부분만 표시
+      - 미전달: 카드번호, 유효기간, 주민번호, 비밀번호 입력 부분 표시
+
 **빌링키(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/kakaopay.md

@@ -86,12 +86,98 @@ 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
+
+  **면세금액**
+
+- m\_redirect\_url?: string
+
+  **모바일 결제 후 리디렉션 될 URL**
+
+- app\_scheme?: string
+
+  **모바일 앱 URL scheme** (모바일 전용, iOS만 지원)
+
+  카카오페이 정책에 따라 iOS에서만 사용 가능합니다.
+
+- notice\_url?: string | string\[]
+
+  **웹훅 수신 URL**
+
+- confirm\_url?: string
+
+  **Confirm process URL**
+
+- custom\_data?: object
+
+  **가맹점 커스텀 데이터**
+
+- customer\_id?: string
+
+  **구매자 고유 ID**
+
+- display?: object
+
+  **카드 할부 설정**
+
+  - card\_quota?: number\[]
+
+    **할부 개월수**
+
+    단일 값만 지정 가능합니다. 지정 시 해당 개월수로 고정됩니다.
+
+- card?: object
+
+  **카드 필터링**
+
+  - detail?: object\[]
+
+    **사용 가능한 카드사 목록**
+
+    - card\_code?: string
+
+      **카드사 코드**
+
+    - enabled?: boolean
+
+      **활성화 여부**
+
+- kakaopayMobileAsPC?: boolean
+
+  **모바일에서 PC URL 사용 여부** (모바일 전용)
+
+  `true` 설정 시 모바일 환경에서 PC용 결제 URL을 사용합니다.
+
 - bypass?: object
 
   **PG사 전용 파라미터**
@@ -109,6 +195,10 @@ IMP.request_pay(
 
       미입력 시 사용 가능한 전체 결제수단 허용
 
+    - custom\_message?: string
+
+      **카카오페이 결제 UI에 표시되는 커스텀 메시지**
+
 </div>
 
 <div class="tabs-content" data-title="정기결제창 요청">
@@ -180,6 +270,14 @@ IMP.request_pay(
 
   비 인증 결제창에서 고객이 입력한 카드정보와 1:1로 매칭될 빌링키를 지정합니다.
 
+- merchant\_uid: string
+
+  **주문번호**
+
+- name: string
+
+  **주문명**
+
 - amount: number
 
   **결제금액**
@@ -188,6 +286,34 @@ IMP.request_pay(
 
   (실 결제를 원하지 않은 경우 amount 금액을 0원으로 설정합니다.)
 
+- buyer\_name?: string
+
+  **구매자 이름**
+
+- buyer\_email?: string
+
+  **구매자 이메일**
+
+- buyer\_tel?: string
+
+  **구매자 연락처**
+
+- m\_redirect\_url?: string
+
+  **모바일 결제 후 리디렉션 될 URL**
+
+- 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)를 호출하시면 결제를 발생시킬 수 있습니다.
@@ -206,9 +332,9 @@ curl -H "Content-Type: application/json" \
 
 <details>
 
-<summary> 부가세 지정 미지원</summary>
+<summary> 부가세(`vat_amount`) 지정 미지원</summary>
 
-- 카카오페이 결제 시 부가세 지정은 지원하지 않습니다.
+- 카카오페이 결제 시 `vat_amount`(부가세) 직접 지정은 지원하지 않습니다. `tax_free`(면세금액)는 지원됩니다.
 - 카카오페이 결제 취소 시 부가세 지정은 지원하지 않습니다.
 
 </details>