@portone/mcp-server 0.15.0 → 0.16.0

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

@@ -63,8 +63,10 @@ IMP.request_pay(
       useInstallment: false,
     },
     bypass: {
-      expiredTime: "2023-12-02 11:00:00", //결제 만료시간
-      cashReceiptTradeOption: "CULTURE", //현금영수증 발급타입
+      tosspay_v2: {
+        expiredTime: "2023-12-02 11:00:00", //결제 만료시간
+        cashReceiptTradeOption: "CULTURE", //현금영수증 발급타입
+      },
     },
   },
   function (rsp) {
@@ -119,35 +121,75 @@ IMP.request_pay(
 
   매번 고유하게 채번되어야 합니다.
 
+- name: string
+
+  **주문명**
+
 - amount: number
 
   **결제금액**
 
   string 이 아닌점에 유의하세요
 
+- buyer\_name?: string
+
+  **구매자 이름**
+
+- buyer\_email?: string
+
+  **구매자 이메일**
+
+- buyer\_tel?: string
+
+  **구매자 연락처**
+
+- m\_redirect\_url?: string
+
+  **모바일 결제 후 리디렉션 될 URL**
+
+- app\_scheme?: string
+
+  **모바일 앱 URL scheme** (모바일 전용)
+
+- notice\_url?: string | string\[]
+
+  **웹훅 수신 URL**
+
+- confirm\_url?: string
+
+  **Confirm process URL**
+
+- custom\_data?: object
+
+  **가맹점 커스텀 데이터**
+
 - card.useInstallment: boolean
 
   **할부 사용 가능 여부**
 
 - bypass?: object
 
-  - expiredTime: string
+  - tosspay\_v2?: object
+
+    **(신) 토스페이 전용 파라미터**
 
-    **결제 만료 기한**
+    - expiredTime?: string
 
-    `yyyy-MM-dd HH:mm:ss` 의 형식입니다.
+      **결제 만료 기한**
 
-    입력하지 않을 경우, 기본값인 15분으로 설정됩니다. 최대 60분까지 설정할 수 있습니다.
+      `yyyy-MM-dd HH:mm:ss` 의 형식입니다.
 
-  - cashReceiptTradeOption: string
+      입력하지 않을 경우, 기본값인 15분으로 설정됩니다. 최대 60분까지 설정할 수 있습니다.
+
+    - cashReceiptTradeOption?: string
 
-    **현금영수증 발급 대상 타입**
+      **현금영수증 발급 대상 타입**
 
-    전달하지 않을경우, 기본값은 `GENERAL` 입니다.
+      전달하지 않을경우, 기본값은 `GENERAL` 입니다.
 
-    - `GENERAL`: 일반 (default)
-    - `CULTURE`: 문화비
-    - `PUBLIC_TP`: 교통비
+      - `GENERAL`: 일반 (default)
+      - `CULTURE`: 문화비
+      - `PUBLIC_TP`: 교통비
 
 </details>
 
@@ -249,6 +291,16 @@ IMP.request_pay(
 
   빌링키 발급이 완료됐을 때 웹훅이 전달될 URL입니다. 해당 파라미터가 전달되지 않은 경우 콘솔에 등록한 웹훅 주소로 웹훅이 발송됩니다. **(신) 토스페이의 경우 SDK 콜백만으로 빌링키 발급여부를 체크하는 경우 정보 유실 가능성이 있기 때문에, 반드시 웹훅으로 빌링키 발급여부를 체크하길 권장합니다**.
 
+- bypass?: object
+
+  - tosspay\_v2?: object
+
+    - encryptedUserCi?: string
+
+      **암호화된 사용자 CI**
+
+      빌링키 발급 시 사용자 CI를 암호화하여 전달할 수 있습니다.
+
 </details>
 
 </div>
@@ -271,10 +323,11 @@ await fetch("https://api.iamport.kr/subscribe/payments/again", {
     merchant_uid: "merchant_uid", // [필수 입력] 주문 번호
     amount: 1000, // [필수 입력] 결제 금액
     name: "주문명", // 주문명
-    cash_recipt_type: "person", // 현금영수증 발급 타입
+    cash_receipt_type: "person", // 현금영수증 발급 타입
     bypass: {
       tosspay_v2: {
-        cashReceiptTradeType: "GENERAL", // 현금영수증 발급 대상 타입
+        cashReceipt: true, // 현금영수증 발급 여부 (default: true)
+        cashReceiptTradeOption: "GENERAL", // 현금영수증 발급 대상 타입
         sendFailPush: false, // 결제 실패 시 토스페이앱 푸시알람 발송 여부
       },
     },
@@ -288,6 +341,12 @@ await fetch("https://api.iamport.kr/subscribe/payments/again", {
 
   - tosspay\_v2?: object
 
+    - cashReceipt?: boolean
+
+      **현금영수증 발급 여부**
+
+      기본값은 `true`입니다.
+
     - cashReceiptTradeOption?: string
 
       **현금영수증 발급 대상 타입**
@@ -296,7 +355,7 @@ await fetch("https://api.iamport.kr/subscribe/payments/again", {
       - `CULTURE`: 문화비
       - `PUBLIC_TP`: 교통비
 
-    - tosspay\_v2.cashReceiptTradeOption?: boolean
+    - sendFailPush?: boolean
 
       **결제실패 푸시알람 사용 여부**
 

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

@@ -81,7 +81,7 @@ IMP.request_pay(
 
   **결제수단 구분코드**
 
-  신용카드 : `card` | 계좌이체 : `trans`
+  입력값은 `card` 만 지원합니다. 단, 결제창 호출 이후에는 토스페이 머니 결제와 카드 결제 중 선택하여 진행할 수 있습니다.
 
 - name: string
 
@@ -99,6 +99,46 @@ IMP.request_pay(
 
   **string** 이 아닌점에 유의하세요
 
+- buyer\_name?: string
+
+  **구매자 이름**
+
+- buyer\_email?: string
+
+  **구매자 이메일**
+
+- buyer\_tel?: string
+
+  **구매자 연락처**
+
+- buyer\_addr?: string
+
+  **구매자 주소**
+
+- buyer\_postcode?: string
+
+  **구매자 우편번호**
+
+- tax\_free?: number
+
+  **면세금액**
+
+- m\_redirect\_url?: string
+
+  **모바일 결제 후 리디렉션 될 URL**
+
+- notice\_url?: string | string\[]
+
+  **웹훅 수신 URL**
+
+- confirm\_url?: string
+
+  **Confirm process URL**
+
+- custom\_data?: object
+
+  **가맹점 커스텀 데이터**
+
 </div>
 
 </div>

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

@@ -143,12 +143,24 @@ IMP.request_pay(
 
   **구매자 이메일 주소**
 
+- buyer\_addr?: string
+
+  **구매자 주소**
+
+- buyer\_postcode?: string
+
+  **구매자 우편번호**
+
 - m\_redirect\_url?: string
 
   **모바일 환경에서 트랜잭션 종료 후 302 리디렉션 될 URL**
 
   주의: 웰컴페이먼츠의 경우 **모바일 환경에서 필수 입력**입니다.
 
+- custom\_data?: object
+
+  **가맹점 커스텀 데이터**
+
 - notice\_url?: string 또는 **string\[]**
 
   **트랜잭션 종료 후 웹훅이 발송 될 고객사 서버 URL**

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

@@ -172,7 +172,7 @@ function requestPayment() {
 
     **구매자 ID**
 
-    CBT 유형이 SBPS인 경우 필수 입력입니다. 입력하지 않은 경우 포트원에서 자동 채번된 식별값이 사용됩니다.
+    CBT 유형이 SBPS인 경우 필수 입력이며 최대 30자로 설정해야합니다.
 
   - fullName?: string
 
@@ -294,21 +294,9 @@ function requestPayment() {
 
 <details>
 
-<summary>`redirectUrl` 은 필수 입력입니다.</summary>
+<summary>`paymentId` 에는 알파벳 대소문자, 숫자 및 일부 특수문자만 허용됩니다.</summary>
 
-이니시스 일본결제의 경우 PC, 모바일 환경을 구분하지 않고 항상 리디렉션 방식으로 결제창이 동작합니다. 따라서 `redirectUrl` 는 항상 입력해야 합니다.
-
-</details>
-
-<details>
-
-<summary>`paymentId` 에는 ASCII 문자만 허용됩니다.</summary>
-
-`paymentId` 에는 ASCII 문자만으로 이루어진 문자열만 입력할 수 있습니다.
-
-ASCII 문자에 포함되지 않는 한글이나 `♤`, `♡`, `♧` 등의 특수 문자는 허용되지 않습니다.
-
-입력 가능한 ASCII 문자의 종류는 [링크](http://www.ascii-code.com/) → `ASCII printable characters` 섹션을 참고하세요.
+지원되지 않는 언어(ex. 한글) 및 특수문자(ex. `()`) 사용 시 결제가 실패할 수 있습니다.
 
 </details>
 

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

@@ -82,6 +82,7 @@ PortOne.requestPayment({
 
   - ISO 4217 통화 코드
   - [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217)
+  - Triple-A에서 사용 가능한 통화 목록은 [Triple-A 공식 문서](https://developers.triple-a.io/docs/triplea-api-doc/8974dfffa9418-presentment-currencies-for-crypto-payments)에서 확인할 수 있습니다.
 
 - locale?: Locale
 

package/assets/docs/opi/ko/integration/ready/readme.md

@@ -225,9 +225,9 @@ targetVersions:
 
 <details>
 
-<summary>모빌리언스</summary>
+<summary>KG파이낸셜</summary>
 
-포트원 콘솔에서 채널 추가 시 계약 완료 후 모빌리언스로부터 전달받은 \[서비스ID]를 입력한 후 `저장`을 클릭합니다.
+포트원 콘솔에서 채널 추가 시 계약 완료 후 KG파이낸셜로부터 전달받은 \[서비스ID]를 입력한 후 `저장`을 클릭합니다.
 
 <div class="hint" data-style="info">
 
@@ -556,25 +556,13 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
 
       (이미지 첨부: KCP 파트너관리자 내 관리용 사설인증서 발급 완료 화면)
 
-   4. \[자동결제]→\[그룹관리]→\[그룹등록]을 클릭합니다.
+   4. \[결제관리]→\[자동결제]→\[그룹관리]→\[그룹등록]을 클릭합니다.
 
-   5. \[상점정보]→\[사이트코드]에서 그룹등록할 사이트코드를 선택합니다.
+   5. 그룹명을 입력 후 그룹을 생성하고 생성된 그룹아이디를 확인합니다.
 
-   6. \[그룹정보]에서 \[유형3]을 선택한 후 원하는 그룹명을 입력합니다.
-
-   7. \[결제입력 정보]에서 \[결제유형] 및 \[납부유형]을 확인하시고 고객사 유형에 맞게 선택합니다.
-
-   8. \[고지방법]에서 원하시는 고지 방법을 선택한 후 \[등록하기]를 클릭합니다.
-
-      (이미지 첨부: KCP 파트너관리자 내 관리용 그룹등록 화면)
-
-   9. \[자동결제]→\[그룹관리]→\[그룹조회]를 클릭합니다.
-
-   10. \[사이트코드]에서 사용한 사이트코드를 선택한 후 \[검색]을 클릭합니다.
-
-       (이미지 첨부: KCP 파트너관리자 내 관리용 그룹조회 화면)
+   (이미지 첨부: KCP 파트너관리자 내 관리용 그룹등록 화면)
 
-   11. 포트원 콘솔에서 채널 추가 시 사이트코드, 사이트키, 앞서 발급한 정기자동결제 그룹아이디를 입력한 후 \[저장]을 클릭합니다.
+   6. 포트원 콘솔에서 채널 추가 시 사이트코드, 사이트키, 앞서 발급한 그룹아이디를 입력한 후 \[저장]을 클릭합니다.
 
 </div>
 
@@ -592,25 +580,13 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
 
    (이미지 첨부: KCP 파트너관리자 내 관리용 사설인증서 발급 완료 화면)
 
-4. \[자동결제]→\[그룹관리]→\[그룹등록]을 클릭합니다.
-
-5. \[상점정보]→\[사이트코드]에서 그룹등록할 사이트코드를 선택합니다.
+4. \[결제관리]→\[자동결제]→\[그룹관리]→\[그룹등록]을 클릭합니다.
 
-6. \[그룹정보]에서 \[유형3]을 선택한 후 원하는 그룹명을 입력합니다.
+5. 그룹명을 입력 후 그룹을 생성하고 생성된 그룹아이디를 확인합니다.
 
-7. \[결제입력 정보]에서 \[결제유형] 및 \[납부유형]을 확인하시고 고객사 유형에 맞게 선택합니다.
+(이미지 첨부: KCP 파트너관리자 내 관리용 그룹등록 화면)
 
-8. \[고지방법]에서 원하시는 고지 방법을 선택한 후 \[등록하기]를 클릭합니다.
-
-   (이미지 첨부: KCP 파트너관리자 내 관리용 그룹등록 화면)
-
-9. \[자동결제]→\[그룹관리]→\[그룹조회]를 클릭합니다.
-
-10. \[사이트코드]에서 사용한 사이트코드를 선택한 후 \[검색]을 클릭합니다.
-
-    (이미지 첨부: KCP 파트너관리자 내 관리용 그룹조회 화면)
-
-11. 포트원 콘솔에서 채널 추가 시 사이트코드, 사이트키, 앞서 발급한 정기자동결제 그룹아이디를 입력한 후 \[저장]을 클릭합니다.
+6. 포트원 콘솔에서 채널 추가 시 사이트코드, 사이트키, 앞서 발급한 정기자동결제 그룹아이디를 입력한 후 \[저장]을 클릭합니다.
 
 </div>
 
@@ -675,21 +651,13 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
 9. 정기결제를 이용하시는 경우, 아래 절차를 진행해주세요.
 
    1. [KCP 파트너관리자](http://partner.kcp.co.kr/) 접속 후 로그인을 합니다.
-   2. \[자동결제]→\[그룹관리]→\[그룹등록]을 클릭합니다.
-   3. \[상점정보]→\[사이트코드]에서 그룹등록할 사이트코드를 선택합니다.
-   4. \[그룹정보]에서 \[유형3]을 선택한 후 원하는 그룹명을 입력합니다.
-   5. \[결제입력 정보]에서 \[결제유형] 및 \[납부유형]을 확인하시고 고객사 유형에 맞게 선택합니다.
-   6. \[고지방법]에서 원하시는 고지 방법을 선택한 후 \[등록하기]를 클릭합니다.
+   2. \[결제관리]→\[자동결제]→\[그룹관리]→\[그룹등록]을 클릭합니다.
+   3. 그룹명을 입력 후 그룹을 생성하고 생성된 그룹아이디를 확인합니다.
 
    (이미지 첨부: KCP 파트너관리자 내 관리용 그룹등록 화면)
 
-   7. \[자동결제]→\[그룹관리]→\[그룹조회]를 클릭합니다.
-   8. \[사이트코드]에서 사용한 사이트코드를 선택한 후 \[검색]을 클릭합니다.
-
-   (이미지 첨부: KCP 파트너관리자 내 관리용 그룹조회 화면)
-
-   9. 포트원 콘솔에서 채널 추가 시 앞서 발급한  \[MID(사이트코드)], \[PG-API 인증서키], \[PG-API 개인키],
-      \[개인키 비밀번호], \[정기자동결제 그룹아이디]를 입력한 후 \[저장]을 클릭합니다.
+   4. 포트원 콘솔에서 채널 추가 시 앞서 발급한  \[MID(사이트코드)], \[PG-API 인증서키], \[PG-API 개인키],
+      \[개인키 비밀번호], \[자동결제 그룹아이디]를 입력한 후 \[저장]을 클릭합니다.
 
 <!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
 

package/assets/docs/opi/ko/integration/start/v1/non-auth.md

@@ -168,7 +168,7 @@ const {
   - 토스페이먼츠 (신모듈)
   - 다날
   - 이지페이(KICC)
-  - 모빌리언스 (휴대폰 소액결제 한정)
+  - KG파이낸셜 (휴대폰 소액결제 한정)
   - 웰컴페이먼츠
   - 스마트로 (신모듈)
   - 헥토파이낸셜 (내통장 결제 한정)

package/assets/docs/opi/ko/readme.md

@@ -122,7 +122,7 @@ targetVersions:
 
 <span>API 문서 바로가기</span>
 
-<i class="i-ic-baseline-chevron-right inline-block text-2xl" />
+<i class="icon-[ic--baseline-chevron-right] inline-block text-2xl" />
 
 </a>
 
@@ -134,7 +134,7 @@ targetVersions:
 
 <span>API 문서 바로가기</span>
 
-<i class="i-ic-baseline-chevron-right inline-block text-2xl" />
+<i class="icon-[ic--baseline-chevron-right] inline-block text-2xl" />
 
 </a>
 

package/assets/docs/opi/ko/support/code-info/pg-2.md

@@ -21,7 +21,7 @@ targetVersions:
 |       카카오페이      |   `kakaopay`   |
 |다날휴대폰결제/본인인증|     `danal`    |
 |          다날         |  `danal_tpay`  |
-|       모빌리언스      |   `mobilians`  |
+|       KG파이낸셜      |   `mobilians`  |
 |         페이코        |     `payco`    |
 |      (구) 페이팔      |    `paypal`    |
 |      (신) 페이팔      |   `paypal_v2`  |

package/assets/docs/opi/ko/support/code-info/pg-3.md

@@ -21,11 +21,11 @@ targetVersions:
 
 (파일: 토스페이먼츠 오류코드 다운로드)
 
-## KG모빌리언스
+## KG파이낸셜
 
-(파일: KG모빌리언스 휴대폰 결제 오류코드 다운로드)
+(파일: KG파이낸셜 휴대폰 결제 오류코드 다운로드)
 
-(파일: KG모빌리언스 휴대폰 결제 취소 오류코드 다운로드)
+(파일: KG파이낸셜 휴대폰 결제 취소 오류코드 다운로드)
 
 ## 다날
 

package/assets/docs/opi/ko/support/code-info/pg.md

@@ -28,7 +28,7 @@ API방식으로 연동하실 때는 [비인증 결제(일회성) API](https://de
 |      헥토파이낸셜     |       settle      |     X     |    O   |                                -                               |
 |     이지페이(KICC)    |        kicc       |     O     |    X   |                             불가능                             |
 |        키움페이       |        daou       |     X     |    O   |                                -                               |
-|      KG모빌리언스     |      moblians     |     O     |    X   |                              가능                              |
+|       KG파이낸셜      |     mobilians     |     O     |    X   |                              가능                              |
 |         KSNET         |       ksnet       |     X     |    O   |                                -                               |
 |    스마트로(신모듈)   |    smartro\_v2    |     O     |    X   |                             불가능                             |
 |      웰컴페이먼츠     |      welcome      |     O     |    O   |발급 수단에 따라 상이함. (카드 : 불가능 / 휴대폰소액결제 : 가능)|

package/assets/docs/release-notes/api-sdk/2023-07-03.md

@@ -19,8 +19,8 @@ iOS13 이후 아이패드 기기에서 결제 요청 시 PC 환경의 결제창
 
 ## 기타 수정사항
 
-### ✔️ KG모빌리언스를 통해 신용카드 결제를 이용할 수 있습니다
+### ✔️ KG파이낸셜을 통해 신용카드 결제를 이용할 수 있습니다
 
-KG모빌리언스와 계약을 통해 새로운 결제수단으로 신용카드를 이용할 수 있습니다. 하단의 일반 문의 채널을 통해 관련 문의를 남겨주시면 포트원 고객지원팀이 안내드리겠습니다.
+KG파이낸셜과 계약을 통해 새로운 결제수단으로 신용카드를 이용할 수 있습니다. 하단의 일반 문의 채널을 통해 관련 문의를 남겨주시면 포트원 고객지원팀이 안내드리겠습니다.
 
-본 기능 설정을 위한 자세한 내용은 관련 연동가이드를 확인 바랍니다. [→ KG모빌리언스](https://developers.portone.io/docs/ko/pg/payment-gateway/kg)
+본 기능 설정을 위한 자세한 내용은 관련 연동가이드를 확인 바랍니다. [→ KG파이낸셜](https://developers.portone.io/docs/ko/pg/payment-gateway/kg)