@portone/mcp-server 0.13.0 → 0.15.0-alpha.0

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

@@ -275,33 +275,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에 등록 된 국가 코드
+      "key": "sender_country_code", // 구매자 국가 코드
       "value": "KR" // ISO 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 형식
     }
   ]
 }
@@ -397,7 +398,7 @@ STC 기능을 사용하시기 위해 다음 정보를 확인하셔야 합니다.
 
 ### Alternative Methods
 
-페이팔은 간편 결제를 Alternative Methods라고 부르고 있습니다. Alternative Methods도 Pay Later 처럼 결제가 가능한 국가와 통화는 매우 제한적입니다.
+페이팔은 간편 결제를 Alternative Methods라고 부르고 있습니다. Alternative Methods도 Pay Later처럼 결제가 가능한 국가와 화폐는 매우 제한적입니다.
 
 - Bancontact
   - 구매자: BE / EUR

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

@@ -101,6 +101,7 @@ IMP.request_pay(
   - kakaopay (카카오페이)
   - payco (페이코)
   - tosspay (토스페이)
+  - naverpay (네이버페이)
 
 - merchant\_uid: string
 
@@ -296,18 +297,19 @@ IMP.request_pay(
       - 엘페이: LPAY
       - 페이코: PAYCO
       - 토스페이: TOSSPAY
+      - 네이버페이: NPAY
 
     - acceptmethod?: string\[]
 
       **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 /> - 네이버페이: `naverpay`|
+      |SLIMQUOTA(슬림 할부 설정)        |부분 무이자 설정. 슬림 할부 <br /> - 형식) SLIMQUOTA(코드-개월:개월^코드-개월:개월 <br /> - 예시) SLIMQUOTA(11-2:3^34-2:3)                                                                                                                                         |
 
       **PC - 휴대폰 소액 결제 전용 파라미터**
 
@@ -383,6 +385,7 @@ IMP.request_pay(
 - kakaopay
 - payco
 - tosspay
+- naverpay
 
 </details>
 

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

@@ -17,19 +17,13 @@ targetVersions:
 
 ## 가능한 결제수단
 
-- **결제창 일반결제**
+엑심베이의 경우 포트원의 결제수단 구분과 상관없이 MID에 설정된 여러 결제수단을 표시할 수 있습니다.
+`payMethod`를 생략하고, 특정 결제수단만을 노출할 경우 `bypass.eximbay_v2`를 사용해야 합니다.
 
-  엑심베이의 경우 포트원의 결제수단 구분과 상관없이 여러 결제수단을 표시할 수 있습니다.
-  `payMethod`를 생략하고, 특정 결제수단만을 노출할 경우 `bypass.eximbay_v2`를 사용해야 합니다.
-
-  - MID에 설정된 기본 결제수단을 전부 표시하려면 `bypass.eximbay_v2.payment`를 생략해야 합니다.
-  - 특정 결제수단을 단독으로 표시하려면 `bypass.eximbay_v2.payment.payment_method`를 설정합니다.
-  - 일부 결제수단만을 표시하려면 `bypass.eximbay_v2.payment.multi_payment_method`에 결제수단 목록을 전달합니다.
-  - 엑심베이의 결제수단 코드는 포트원 코드와 상이하므로, [EXIMBAY Docs](https://developer.eximbay.com/eximbay/api_sdk/code-organization.html#paymentCode)에서 확인 후 입력해야 합니다.
-
-- **결제창 빌링키 발급 및 결제**
-
-  현재 신용카드 결제만 지원하며, `billingKeyAndPayMethod` 파라미터를 `CARD`로 설정해야 합니다.
+- MID에 설정된 기본 결제수단을 전부 표시하려면 `bypass.eximbay_v2.payment`를 생략해야 합니다.
+- 특정 결제수단을 단독으로 표시하려면 `bypass.eximbay_v2.payment.payment_method`를 설정합니다.
+- 일부 결제수단만을 표시하려면 `bypass.eximbay_v2.payment.multi_payment_method`에 결제수단 목록을 전달합니다.
+- 엑심베이의 결제수단 코드는 포트원 코드와 상이하므로, [EXIMBAY Docs](https://developer.eximbay.com/eximbay/api_sdk/code-organization.html#paymentCode)에서 확인 후 입력해야 합니다.
 
 ## SDK 결제 요청하기
 
@@ -154,6 +148,35 @@ function requestPayment() {
 
     결제 완료 메일이 발송됩니다.
 
+- products?: object\[]
+
+  **구매 상품 정보**
+
+  - 해외카드 결제를 제외하고 필수 입력입니다.
+  - 해외카드의 경우에도 위험 거래 관리가 필요한 경우 요구될 수 있습니다.
+
+  * id: string
+
+    **상품 ID**
+
+  * name: string
+
+    **상품명**
+
+  * amount: number
+
+    **상품 단위 가격**
+
+    결제 금액과 동일하게 scale factor가 적용된 값을 입력합니다.
+
+  * quantity: number
+
+    **상품 수량**
+
+  * link: string
+
+    **상품 판매 URL**
+
 - bypass?: oneof object
 
   - eximbay\_v2?: object
@@ -317,7 +340,6 @@ function issueBillingKeyAndPay() {
     orderName: "PortOne Recurring Payment",
     totalAmount: 100, // 1 USD
     currency: "USD",
-    billingKeyAndPayMethod: "CARD",
     customer: {
       fullName: "PortOne",
       email: "test@example.com",
@@ -370,12 +392,6 @@ function issueBillingKeyAndPay() {
   - ISO 4217 통화 코드
   - [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217)
 
-- billingKeyAndPayMethod: string
-
-  **빌링키 발급 및 결제 방법**
-
-  - `CARD`: 신용카드 결제
-
 - locale?: Locale
 
   **결제창 언어**
@@ -427,12 +443,55 @@ function issueBillingKeyAndPay() {
 
     결제 완료 메일이 발송됩니다.
 
+- products?: object\[]
+
+  **구매 상품 정보**
+
+  - 해외카드 결제를 제외하고 필수 입력입니다.
+  - 해외카드의 경우에도 위험 거래 관리가 필요한 경우 요구될 수 있습니다.
+
+  * id: string
+
+    **상품 ID**
+
+  * name: string
+
+    **상품명**
+
+  * amount: number
+
+    **상품 단위 가격**
+
+    결제 금액과 동일하게 scale factor가 적용된 값을 입력합니다.
+
+  * quantity: number
+
+    **상품 수량**
+
+  * link: string
+
+    **상품 판매 URL**
+
 - bypass?: oneof object
 
   - eximbay\_v2?: object
 
     **엑심베이 특수 파라미터**
 
+    - payment?: object
+
+      - payment\_method?: string
+
+        **결제수단 단독 노출**
+
+        엑심베이의 결제수단 코드는 포트원 코드와 상이하므로, [EXIMBAY Docs](https://developer.eximbay.com/eximbay/api_sdk/code-organization.html#paymentCode)에서 확인 후 입력해야 합니다.
+
+      - multi\_payment\_method?: string\[]
+
+        **결제수단 노출 목록**
+
+        여러 결제수단을 노출합니다.
+
     - merchant?: object
 
       - shop?: string
@@ -630,6 +689,35 @@ const response = await axios({
 
     **구매자 이메일**
 
+- products?: object\[]
+
+  **구매 상품 정보**
+
+  - 해외카드 결제를 제외하고 필수 입력입니다.
+  - 해외카드의 경우에도 위험 거래 관리가 필요한 경우 요구될 수 있습니다.
+
+  * id: string
+
+    **상품 ID**
+
+  * name: string
+
+    **상품명**
+
+  * amount: number
+
+    **상품 단위 가격**
+
+    결제 금액과 동일하게 scale factor가 적용된 값을 입력합니다.
+
+  * quantity: number
+
+    **상품 수량**
+
+  * link: string
+
+    **상품 판매 URL**
+
 - bypass?: oneof object
 
   - eximbayV2?: object
@@ -840,6 +928,35 @@ const response = await axios({
 
       **구매자 이메일**
 
+  - products?: object\[]
+
+    **구매 상품 정보**
+
+    - 해외카드 결제를 제외하고 필수 입력입니다.
+    - 해외카드의 경우에도 위험 거래 관리가 필요한 경우 요구될 수 있습니다.
+
+    * id: string
+
+      **상품 ID**
+
+    * name: string
+
+      **상품명**
+
+    * amount: number
+
+      **상품 단위 가격**
+
+      결제 금액과 동일하게 scale factor가 적용된 값을 입력합니다.
+
+    * quantity: number
+
+      **상품 수량**
+
+    * link: string
+
+      **상품 판매 URL**
+
   - bypass?: oneof object
 
     - eximbayV2?: object
@@ -945,9 +1062,10 @@ const response = await axios({
 ### 공통
 
 - `customer.name` 및 `customer.email`은 필수 입력 항목입니다.
+- 해외카드 결제를 제외하고 `products`를 필수로 입력해야 합니다. 해외카드의 경우에도 위험 거래 관리가 필요한 경우 요구될 수 있습니다.
 - `products` 입력 시 `link`를 필수로 입력해야 합니다.
 
-### SDK 결제 요청
+### SDK 결제 / 빌링키 발급 및 결제 요청
 
 - 네이버페이 포인트로 결제할 경우에는 `bypass.eximbay_v2.tax` 내용을 모두 입력해야 합니다.
 
@@ -955,8 +1073,6 @@ const response = await axios({
 
 - `bypass.eximbay_v2.payment_method`에 일본 편의점 결제를 지정할 경우 `customer.phoneNumber`을 필수로 입력해야 합니다.
 
-- 간편결제 사용 시 `products`를 필수로 입력해야 합니다.
-
 - 아래 결제수단의 경우 사용이 제한되므로 결제 연동 시 유의해 주시기 바랍니다.
   - 가상계좌(`P305`) : 호환성 이슈로 추후 지원 예정
   - Klarna(`P197`) : 엑심베이 정책에 따라 신규 결제 사용 불가

package/assets/docs/opi/ko/integration/pg/v2/inicis-unified-identity-verification.md

@@ -65,7 +65,6 @@ PortOne.requestIdentityVerification({
 
 <summary>인증 업체 코드 확인하기</summary>
 
-- PAYCO(페이코)
 - PASS(패스 (통신사))
 - TOSS(토스)
 - KFTC(금융결제원)

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

@@ -209,7 +209,7 @@ function requestPayment() {
             "Ini_SSGPAY_MDN": "01012341234",
             "acceptmethod": ["SKIN(#C1272C)", "below1000", "ocb"],
             "P_CARD_OPTION": "selcode=14",
-            "P_NMANE": "포트원",
+            "P_MNAME": "포트원",
             "P_RESERVED": ["below1000=Y", "noeasypay=Y"]
           }
         }
@@ -338,6 +338,18 @@ function requestPayment() {
 
 <details>
 
+<summary>계약 사항에 따라 결제 정보에서 카드 정보가 누락될 수 있습니다.</summary>
+
+KG이니시스와의 계약에서 결제 결과에 카드번호를 전송하지 않도록 설정된 경우, 결제 조회 시 다음 카드 관련 필드들이 누락될 수 있습니다.
+
+- `card.issuer`: 카드 발급사
+- `card.publisher`: 카드 발행사
+- `card.name`: 카드명
+
+</details>
+
+<details>
+
 <summary>PC와 모바일에서 파라미터 필수 여부가 상이합니다.</summary>
 
 위의 주요 파라미터 설명에도 안내되어 있듯이, PC 결제와 모바일 결제에서 필수 여부가 상이한 파라미터가 존재합니다. 아래 필드들은 PC 결제에서는 필수이지만, 모바일 결제에서는 선택입니다.

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

@@ -4,7 +4,7 @@ description: NHN KCP 연동 방법을 안내합니다.
 targetVersions:
   - v2
 versionVariants:
-  v1: /opi/ko/integration/pg/v1/nhn-kcp
+  v1: /opi/ko/integration/pg/v1/nhn-kcp/readme
 ---
 
 ## 채널 설정하기
@@ -203,8 +203,10 @@ function requestPayment() {
 
     - shop\_user\_id?: string
 
-      **기관에 따라 리스크 관리 조치를 위한 쇼핑몰 관리 ID**
+      **리스크 관리 조치를 위한 고객사 회원 ID**
 
+      - KCP에서 부정거래를 신속하게 탐지하기 위한 파라미터입니다.
+      - 고객사에서 관리하는 구매자의 회원 ID를 입력합니다.
       - 상품권, 휴대폰 결제 시 필수로 입력해야 합니다.
 
     - site\_name?: string

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

@@ -139,7 +139,7 @@ versionVariants:
 - `easyPay.availableCards`
   - 네이버페이는 지원하지 않습니다.
 
-### 빌링키 발급 (`requestBillingKeyIssue`)
+### 빌링키 발급 (`requestIssueBillingKey`)
 
 - `billingKeyMethod`
   - `EASY_PAY` 로 설정해야 합니다