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

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

@@ -140,13 +140,41 @@ IMP.request_pay(
   });
   ```
 
+- buyer\_tel?: string
+
+  **구매자 연락처**
+
+- buyer\_addr?: string
+
+  **구매자 주소**
+
+- buyer\_postcode?: string
+
+  **구매자 우편번호**
+
+- language?: string
+
+  **결제창 언어**
+
+- m\_redirect\_url?: string
+
+  **모바일 결제 후 리디렉션 될 URL**
+
+- notice\_url?: string | string\[]
+
+  **웹훅 수신 URL**
+
+- custom\_data?: object
+
+  **가맹점 커스텀 데이터**
+
 - bypass: object
 
   **페이먼트월 전용 파라미터**
 
   - widget\_code?: string
 
-    터미날3 인 경우 `t3_1`로 파라미터를 설정해야 합니다. 미설정시 Default(일반) 결제창이 활성화됩니다.
+    터미날3 인 경우 `t3_1`로 파라미터를 설정해야 합니다. 미설정시 Default(`pw_1`) 결제창이 활성화됩니다.
 
   - ps?: string
 
@@ -156,6 +184,22 @@ IMP.request_pay(
 
     지정된 국가에서 지원되는 결제수단이 위젯상에 노출됩니다. 다음 문서를 참고하여 해당하는 국가코드를 입력해야 합니다. [→ 국가코드 바로가기](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
 
+  - logo\_url?: string
+
+    **결제창 로고 URL**
+
+  - project\_name?: string
+
+    **프로젝트명**
+
+  - product\_price\_without\_tax?: number
+
+    **세전 가격** (PaymentWall 대시보드 표시용)
+
+  - sales\_tax?: number
+
+    **판매세** (PaymentWall 대시보드 표시용)
+
 </div>
 
 <div class="tabs-content" data-title="비 인증 결제">

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

@@ -9,7 +9,7 @@ targetVersions:
 
 페이팔 Express checkout 방식으로 신규 가입 및 연동이 불가합니다.
 페이팔 연동을 원하는 경우, [페이팔 일반 결제(Smart Payment Buttons) 연동 가이드](https://developers.portone.io/opi/ko/integration/pg/v1/spb/readme)
-또는 [페이팔 정기 결제(Reference Transaciton) 연동 가이드](https://developers.portone.io/opi/ko/integration/pg/v1/rt/readme)를 참고하여 진행해주세요.
+또는 [페이팔 정기 결제(Reference Transaction) 연동 가이드](https://developers.portone.io/opi/ko/integration/pg/v1/rt/readme)를 참고하여 진행해주세요.
 
 </div>
 
@@ -90,12 +90,36 @@ IMP.request_pay(
 
   매번 고유하게 채번되어야 합니다.
 
+- name: string
+
+  **주문명**
+
 - amount: number
 
   **결제금액**
 
   **string** 이 아닌점에 유의하세요
 
+- buyer\_name?: string
+
+  **구매자 이름**
+
+- buyer\_email?: string
+
+  **구매자 이메일**
+
+- buyer\_tel?: string
+
+  **구매자 연락처**
+
+- buyer\_addr?: string
+
+  **구매자 주소**
+
+- buyer\_postcode?: string
+
+  **구매자 우편번호**
+
 - currency: string
 
   **결제통화코드**
@@ -108,6 +132,18 @@ IMP.request_pay(
 
   PC환경 모바일 환경 모두 해당 값을 필수로 설정해야 결과를 받아볼수 있습니다.
 
+- notice\_url?: string | string\[]
+
+  **웹훅 수신 URL**
+
+- confirm\_url?: string
+
+  **Confirm process URL**
+
+- custom\_data?: object
+
+  **가맹점 커스텀 데이터**
+
 </div>
 
 </div>
@@ -141,7 +177,7 @@ IMP.request_pay({
 <div class="hint" data-style="info">
 
 STC API를 사용하기 위해서는 **Paypal과의 STC 데이터 협의**가 필요하며,
-**포트원 지원팀(<tech.support@portone.io>)을 통해 요청**해주시면 협의 프로세스를 안내해드리고 있습니다.
+판매자 보호 정책에 관한 자세한 내용 및 협의가 필요한 경우 페이팔에 직접 문의해 주세요.
 
 연동을 원하시는 경우 원활한 연동절차를 위해 요청 전 **아래 pdf의 Create REST API Application 섹션을 완료**해주세요.
 

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

@@ -14,7 +14,7 @@ versionVariants:
 
 [나이스정보통신 (신모듈)](https://developers.portone.io/opi/ko/integration/pg/v1/nice-v2/readme)
 
-[(구) 나이스정보통신](https://developers.portone.io/opi/ko/integration/pg/v1/nice)
+[나이스정보통신 (구모듈)](https://developers.portone.io/opi/ko/integration/pg/v1/nice)
 
 [NHN KCP](https://developers.portone.io/opi/ko/integration/pg/v1/nhn-kcp/readme)
 
@@ -34,14 +34,16 @@ versionVariants:
 
 [헥토파이낸셜](https://developers.portone.io/opi/ko/integration/pg/v1/settle/readme)
 
-[KG모빌리언스 (구모듈)](https://developers.portone.io/opi/ko/integration/pg/v1/kg)
+[KG파이낸셜 (구모듈)](https://developers.portone.io/opi/ko/integration/pg/v1/kg)
 
 [KSNET](https://developers.portone.io/opi/ko/integration/pg/v1/ksnet/readme)
 
-[이지페이(KICC)](https://developers.portone.io/opi/ko/integration/pg/v1/kicc)
+[이지페이(KICC) (구모듈)](https://developers.portone.io/opi/ko/integration/pg/v1/kicc)
 
 [웰컴페이먼츠](https://developers.portone.io/opi/ko/integration/pg/v1/welcome/readme)
 
+[갤럭시아머니트리](https://developers.portone.io/opi/ko/integration/pg/v1/galaxia)
+
 ## 국내 간편결제
 
 [네이버페이(결제형)](https://developers.portone.io/opi/ko/integration/pg/v1/naver)
@@ -71,3 +73,7 @@ versionVariants:
 [페이팔(Express Checkout)](https://developers.portone.io/opi/ko/integration/pg/v1/paypal)
 
 [페이레터 해외결제](https://developers.portone.io/opi/ko/integration/pg/v1/payletter-global)
+
+[이지페이(KICC) 해외결제](https://developers.portone.io/opi/ko/integration/pg/v1/kicc-v2)
+
+[KG이니시스 일본결제](https://developers.portone.io/opi/ko/integration/pg/v1/inicis-jp)

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

@@ -164,17 +164,55 @@ attribute가 `paypal-rt`인 elemente도 2개 이상인 경우, “동일한 data
 
 ## loadUI 요청 객체
 
-|파라미터          |데이터타입|필수여부    |의미                                                                                                                                                                                                                                                               |
-|------------------|----------|------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-|merchant\_uid     |string    |required    |주문 번호 (고객사에서 고유하게 채번하여 사용해야 합니다.)                                                                                                                                                                                                          |
-|name              |string    |optional    |제품명                                                                                                                                                                                                                                                             |
-|~~pg(deprecated)~~|~~string~~|~~required~~|~~결제대행사 구분 값 (코드 구분 값 : paypal\_v2)~~                                                                                                                                                                                                                 |
-|channelKey        |string    |required    |<p>paypal\_v2 채널의 채널 키 </p><p>(포트원 콘솔 내 \[결제 연동] - \[연동 정보] - \[채널 관리] 에서 확인 가능합니다.)</p>                                                                                                                                          |
-|pay\_method       |string    |required    |<p>결제수단 (코드 구분 값 : paypal)</p><p>(페이팔의 경우 결제수단은 paypal로 지정한 후 호출해야 합니다.)</p>                                                                                                                                                       |
-|customer\_uid     |string    |required    |<p>포트원 빌링키</p><p>(고객사에서 빌링키 발급 시 고유하게 채번하여 요청해야 합니다. 빌링키 결제 시 해당 값을 이용하여 결제를 요청해야 하기 때문에 고객사에서 별도로 저장하셔야 합니다.)</p>                                                                       |
-|customer\_id      |string    |optional    |<p>고객 식별 아이디</p><p>(고객사에서 구매자를 특정하기 위해 고유하게 채번하여 사용하는 아이디로 빌링키 발급시 필수 입력해야 합니다.)</p>                                                                                                                          |
-|notice\_url       |string    |optional    |<p>웹훅 수신 주소</p><p>(결제창에서 빌링키 발급 완료 후 발송되는 웹훅 수신 주소로 URL string 또는 string\[]로 N개 설정 가능합니다.</p><p>웹훅 발송 여부는 콘솔 내 \[결제 > 상세 내역 조회] 메뉴에서 해당 거래 건 클릭하여 웹훅 발송 내역을 확인할 수 있습니다.)</p>|
-|custom\_data      |object    |optional    |<p>사용자 정의 데이터</p><p>(빌링키 발급 정보와 함께 고객사에서 관리하고 싶은 데이터를 저장할 수 있으며 JSON 형식으로 요청해야합니다.)</p>                                                                                                                         |
+- channelKey: string
+
+  **채널키**
+
+  paypal\_v2 채널의 채널 키입니다. 포트원 콘솔 내 \[결제 연동] - \[연동 정보] - \[채널 관리] 에서 확인 가능합니다.
+
+- pg(deprecated)?: string
+
+  ~~`paypal_v2`로 지정합니다.~~
+
+- pay\_method: string
+
+  **결제수단 구분코드**
+
+  `paypal`로 지정합니다.
+
+- merchant\_uid: string
+
+  **주문 번호**
+
+  고객사에서 고유하게 채번하여 사용해야 합니다.
+
+- name?: string
+
+  **제품명**
+
+- customer\_uid: string
+
+  **포트원 빌링키**
+
+  고객사에서 빌링키 발급 시 고유하게 채번하여 요청해야 합니다. 빌링키 결제 시 해당 값을 이용하여 결제를 요청해야 하기 때문에 고객사에서 별도로 저장하셔야 합니다.
+
+- customer\_id?: string
+
+  **고객 식별 아이디**
+
+  고객사에서 구매자를 특정하기 위해 고유하게 채번하여 사용하는 아이디입니다.
+
+- notice\_url?: string | string\[]
+
+  **웹훅 수신 URL**
+
+  빌링키 발급 완료 후 웹훅이 발송됩니다.
+
+- custom\_data?: object
+
+  **사용자 정의 데이터**
+
+  빌링키 발급 정보와 함께 고객사에서 관리하고 싶은 데이터를 JSON 형식으로 저장할 수 있습니다.
 
 <div class="hint" data-style="warning">
 
@@ -378,7 +416,7 @@ IMP.loadUI(
           },
           {
             key: "sender_create_date", // 고객사 고객 계정이 생성된 날짜
-            value: "2023-10-10T23:59:59+09:00", // IOS8601 형식
+            value: "2023-10-10T23:59:59+09:00", // ISO 8601 형식
           },
         ],
       },
@@ -441,8 +479,8 @@ await fetch("https://api.iamport.kr/subscribe/payments/again", {
             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", // ISO 8601 형식
           },
         ],
       },
@@ -469,8 +507,6 @@ await fetch("https://api.iamport.kr/subscribe/payments/again", {
 
 고위험 산업에 해당하는 산업군들은 다음과 같습니다.
 
-각 산업별 STC에 필요한 요청 파라미터들이 달라, 고위험 산업에 해당하는 고객사 분들께는 페이팔 전자결제 신청 시 포트원 지원팀에서 안내가 될 예정입니다.
-
 1. 이벤트/티켓 판매 산업
 
 2. 연료 산업

package/assets/docs/opi/ko/integration/pg/v1/settle/mybank.md

@@ -89,63 +89,108 @@ IMP.request_pay(
 
   매번 고유하게 채번되어야 합니다.
 
+- buyer\_name?: string
+
+  **구매자 이름**
+
+- buyer\_email?: string
+
+  **구매자 이메일**
+
 - buyer\_tel: string
 
   **구매자 연락처**
 
   필수 파라미터 입니다.
 
+- buyer\_addr?: string
+
+  **구매자 주소**
+
+- buyer\_postcode?: string
+
+  **구매자 우편번호**
+
 - amount: integer
 
   **결제금액**
 
-- bypass?: oneof object
+- tax\_free?: number
+
+  **면세금액**
+
+- vat\_amount?: number
+
+  **부가세**
+
+- m\_redirect\_url?: string
+
+  **모바일 결제 후 리디렉션 될 URL**
+
+- notice\_url?: string | string\[]
+
+  **웹훅 수신 URL**
+
+- confirm\_url?: string
+
+  **Confirm process URL**
+
+- custom\_data?: object
+
+  **가맹점 커스텀 데이터**
+
+- bypass?: object
 
   **PG사 결제창 호출 시 PG사로 그대로 bypass할 값들의 모음**
 
-  - custCi: string
+  - settle?: object
+
+    - custCi?: string
+
+      **주문자 CI**
 
-    **주문자 CI**
+      고객사가 보유한 회원 CI를 설정하면 내통장 결제에 등록한 CI와 비교하여 동일인인지 자동검증되며 일치하지 않은 경우 결제가 중단됩니다.
 
-    <div class="hint" data-style="warning">
+      <div class="hint" data-style="warning">
 
-    본인인증 후 전달받은 CI 값을 AES-256-ECB 방식을 사용해 암호화하여 16진수로 인코딩한 결과를 입력해야합니다.
-    암호화 키(key)는 포트원 관리자콘솔 채널 등록 시 "암호화 키" 항목에 입력한 값을 사용합니다.
+      본인인증 후 전달받은 CI 값을 AES-256-ECB 방식을 사용해 암호화하여 16진수로 인코딩한 결과를 입력해야합니다.
+      암호화 키(key)는 포트원 관리자콘솔 채널 등록 시 "암호화 키" 항목에 입력한 값을 사용합니다.
 
-    ```pseudo
-    INPUT: ci (string), key (string)
-    OUTPUT: custCI (string)
+      ```pseudo
+      INPUT: ci (string), key (string)
+      OUTPUT: custCI (string)
 
-    BEGIN
-    # Step 1: CI 데이터를 AES-256-ECB 방식으로 암호화
-    binaryData ← AES256ECB(key, ci)
+      BEGIN
+      # Step 1: CI 데이터를 AES-256-ECB 방식으로 암호화
+      binaryData ← AES256ECB(key, ci)
 
-    # Step 2: 암호화된 데이터를 16진수 문자열로 변환
-    custCI ← ConvertToHex(binaryData)
+      # Step 2: 암호화된 데이터를 16진수 문자열로 변환
+      custCI ← ConvertToHex(binaryData)
 
-    # Step 3: 결과 반환
-    RETURN custCI
-    END
-    ```
+      # Step 3: 결과 반환
+      RETURN custCI
+      END
+      ```
 
-    </div>
+      </div>
 
-    고객사가 보유한 회원 CI를 설정하면 내통장 결제에 등록한 CI와 비교하여 동일인인지 자동검증되며
-    일치하지 않은 경우 결제가 중단됩니다.
+    - addDeductionYn?: string
 
-  - addDeductionYn?: string
+      **추가공제구분**
 
-    **추가공제구분**
+      대중교통: Y, 도서 및 공연비: C, 추가공제없음: N
 
-    대중교통: Y, 도서 및 공연비: C, 추가공제없음: N
+      계약 후 사용 가능합니다.
 
-    계약 후 사용 가능합니다.
+    - criPsblYn?: string
 
-  - criPsblYn?: string
+      **현금영수증 발행가능 여부**
 
-    **현금영수증 발행가능 여부**
+      Y or N or "", 빈문자열은 Y로 인식
 
-    Y or N or "", 빈문자열은 Y로 인식
+    - payLimitCd?: string
+
+      **결제 한도 코드**
 
 <div class="hint" data-style="info">
 
@@ -233,59 +278,96 @@ IMP.request_pay(
 
   등록 계좌정보와 1:1로 매칭될 빌링키를 지정합니다.
 
+- merchant\_uid: string
+
+  **주문번호**
+
+- name: string
+
+  **주문명**
+
 - amount?: integer
 
   **결제금액**
 
   0원으로 입력시 빌링키만 발급됩니다. 금액 설정시 결제와 동시에 빌링키가 발급됩니다.
 
-- bypass?: oneof object
+- buyer\_name?: string
+
+  **구매자 이름**
+
+- buyer\_email?: string
+
+  **구매자 이메일**
+
+- buyer\_tel?: string
+
+  **구매자 연락처**
+
+- m\_redirect\_url?: string
+
+  **모바일 결제 후 리디렉션 될 URL**
+
+- notice\_url?: string | string\[]
+
+  **웹훅 수신 URL**
+
+- custom\_data?: object
+
+  **가맹점 커스텀 데이터**
+
+- bypass?: object
 
   **PG사 결제창 호출 시 PG사로 그대로 bypass할 값들의 모음**
 
-  - custCi: string
+  - settle?: object
+
+    - custCi?: string
+
+      **주문자 CI**
+
+      고객사가 보유한 회원 CI를 설정하면 내통장 결제에 등록한 CI와 비교하여 동일인인지 자동검증되며 일치하지 않은 경우 결제가 중단됩니다.
 
-    **주문자 CI**
+      <div class="hint" data-style="warning">
 
-    <div class="hint" data-style="warning">
+      본인인증 후 전달받은 CI 값을 AES-256-ECB 방식을 사용해 암호화하여 16진수로 인코딩한 결과를 입력해야합니다.
+      암호화 키(key)는 포트원 관리자콘솔 채널 등록 시 "암호화 키" 항목에 입력한 값을 사용합니다.
 
-    본인인증 후 전달받은 CI 값을 AES-256-ECB 방식을 사용해 암호화하여 16진수로 인코딩한 결과를 입력해야합니다.
-    암호화 키(key)는 포트원 관리자콘솔 채널 등록 시 "암호화 키" 항목에 입력한 값을 사용합니다.
+      ```pseudo
+      INPUT: ci (string), key (string)
+      OUTPUT: custCI (string)
 
-    ```pseudo
-    INPUT: ci (string), key (string)
-    OUTPUT: custCI (string)
+      BEGIN
+      # Step 1: CI 데이터를 AES-256-ECB 방식으로 암호화
+      binaryData ← AES256ECB(key, ci)
 
-    BEGIN
-    # Step 1: CI 데이터를 AES-256-ECB 방식으로 암호화
-    binaryData ← AES256ECB(key, ci)
+      # Step 2: 암호화된 데이터를 16진수 문자열로 변환
+      custCI ← ConvertToHex(binaryData)
 
-    # Step 2: 암호화된 데이터를 16진수 문자열로 변환
-    custCI ← ConvertToHex(binaryData)
+      # Step 3: 결과 반환
+      RETURN custCI
+      END
+      ```
 
-    # Step 3: 결과 반환
-    RETURN custCI
-    END
-    ```
+      </div>
 
-    </div>
+    - addDeductionYn?: string
 
-    고객사가 보유한 회원 CI를 설정하면 내통장 결제에 등록한 CI와 비교하여 동일인인지 자동검증되며
-    일치하지 않은 경우 결제가 중단됩니다.
+      **추가공제구분**
 
-  - addDeductionYn?: string
+      대중교통: Y, 도서 및 공연비: C, 추가공제없음: N
 
-    **추가공제구분**
+      계약 후 사용 가능합니다.
 
-    대중교통: Y, 도서 및 공연비: C, 추가공제없음: N
+    - criPsblYn?: string
 
-    계약 후 사용 가능합니다.
+      **현금영수증 발행가능 여부**
 
-  - criPsblYn?: string
+      Y or N or "", 빈문자열은 Y로 인식
 
-    **현금영수증 발행가능 여부**
+    - payLimitCd?: string
 
-    Y or N or "", 빈문자열은 Y로 인식
+      **결제 한도 코드**
 
 #### 빌링키(customer\_uid)로 결제 요청하기
 

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

@@ -110,12 +110,62 @@ IMP.request_pay(
 
   **휴대폰, 가상계좌** 결제 요청인 경우 필수 파라미터
 
+- buyer\_name?: string
+
+  **구매자 이름**
+
+- buyer\_email?: string
+
+  **구매자 이메일**
+
+- buyer\_addr?: string
+
+  **구매자 주소**
+
+- buyer\_postcode?: string
+
+  **구매자 우편번호**
+
 - company\_en?: string
 
   **회사명(영문)**
 
   **휴대폰** 결제 요청인 경우 필수 파라미터
 
+- vbank\_due?: string
+
+  **가상계좌 입금마감일시**
+
+  `YYYYMMDD` 형식으로 지정합니다.
+
+- m\_redirect\_url?: string
+
+  **모바일 결제 후 리디렉션 될 URL**
+
+- app\_scheme?: string
+
+  **모바일 앱 URL scheme** (모바일 전용)
+
+- notice\_url?: string | string\[]
+
+  **웹훅 수신 URL**
+
+- custom\_data?: object
+
+  **가맹점 커스텀 데이터**
+
+- bypass?: object
+
+  **헥토파이낸셜 전용 파라미터**
+
+  - settle?: object
+
+    - vbank010?: boolean
+
+      **010 가상계좌 사용 여부**
+
+      `true`로 설정 시 010 가상계좌 전용 플로우로 진행됩니다. 사전에 헥토파이낸셜과 계약이 필요합니다.
+
 </div>
 
 <div class="tabs-content" data-title="비인증 결제창 요청">