@portone/mcp-server 0.14.0 → 0.15.0-alpha.1

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

@@ -93,6 +93,9 @@ IMP.request_pay(
   - payco (페이코)
   - samsung (삼성페이)
   - applepay (애플페이)
+  - cultureland (컬쳐랜드 문화상품권)
+  - smartculture (스마트문화상품권)
+  - booknlife (도서문화상품권)
 
 - merchant\_uid: string
 
@@ -126,6 +129,12 @@ IMP.request_pay(
     - `Y`: 허용
     - `N`: 차단
 
+- bypass.daou.DIRECT\_YN?: string
+
+  **카드, 간편결제 다이렉트 호출 시 키움페이 페이지 노출여부**
+
+  'Y'로 입력하는 경우 키움페이 화면이 노출되지 않고 바로 카드사, 간편결제 결제창이 호출됩니다.
+
 - app\_scheme?: string
 
   **모바일 앱 URL Scheme**
@@ -184,7 +193,7 @@ curl -H "Content-Type: application/json" \
 
 **빌링키로 결제 요청하기**
 
-빌링키 발급과 최초 결제가 성공하면 빌링키는 전달된 `customer_uid` 와 1:1 매칭되어 포트원에 저장됩니다. 보안상의 이유로 서버는 빌링키에 직접 접근할 수 없기 때문에 `customer_uid`를 이용해서 재결제([**POST /subscribe/payments/again**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)) REST API를 다음과 같이 호출합니다.
+빌링키 발급과 최초 결제가 성공하면 빌링키는 전달된 `customer_uid` 와 1:1 매칭되어 포트원에 저장됩니다. 보안상의 이유로 서버는 빌링키에 직접 접근할 수 없기 때문에 `customer_uid`를 이용해서 빌링키 결제([**POST /subscribe/payments/again**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)) REST API를 다음과 같이 호출합니다.
 
 ```sh
 curl -H "Content-Type: application/json" \

package/assets/docs/opi/ko/integration/pg/v1/daou/undefined.md

@@ -212,3 +212,11 @@ GET http://api.iamport.kr/payments/{포트원 번호}?**extension=true**
 초당 50건 이상의 비인증 결제 API가 호출될 경우 오류가 발생할 수 있습니다.
 
 </details>
+
+<details>
+
+<summary>도서문화상품권, 스마트문화상품권 거래는 부분취소 불가능</summary>
+
+도서문화상품권, 스마트문화상품권 거래는 부분취소가 불가능하며 전체취소만 가능합니다.
+
+</details>

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

@@ -117,20 +117,6 @@ IMP.request_pay(
   - HKD
   - CAD
   - AUD
-  - CNY
-  - TWD
-  - MYR
-  - VND
-  - PHP
-  - MNT
-  - NZD
-  - AED
-  - MOP
-  - BRL
-  - KZT
-  - NOK
-  - SAR
-  - TRY
 
 - language?: string
 

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

@@ -110,7 +110,7 @@ IMP.request_pay(
   - `trans` (실시간 계좌이체)
   - `vbank`(가상계좌)
   - `phone` (휴대폰소액결제)
-  - `cultureland` (문화상품권)
+  - `cultureland` (컬쳐랜드 문화상품권)
   - `smartculture` (스마트문상)
   - `booknlife`(도서문화상품권)
 
@@ -275,7 +275,7 @@ curl -H "Content-Type: application/json" \
 
 **빌링키로 결제 요청하기**
 
-빌링키 발급과 최초 결제가 성공하면 빌링키는 전달된 `customer_uid` 와 1:1 매칭되어 포트원에 저장됩니다. 보안상의 이유로 서버는 빌링키에 직접 접근할 수 없기 때문에 `customer_uid`를 이용해서 재결제([**POST /subscribe/payments/again**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)) REST API를 다음과 같이 호출합니다.
+빌링키 발급과 최초 결제가 성공하면 빌링키는 전달된 `customer_uid` 와 1:1 매칭되어 포트원에 저장됩니다. 보안상의 이유로 서버는 빌링키에 직접 접근할 수 없기 때문에 `customer_uid`를 이용해서 빌링키 결제([**POST /subscribe/payments/again**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)) REST API를 다음과 같이 호출합니다.
 
 ```sh
 curl -H "Content-Type: application/json" \
@@ -441,4 +441,62 @@ KG이니시스 설정이 완료되었으면 아래와 같이 파라미터 설정
 
 </div>
 
+<div class="tabs-content" data-title="이니시스 에스크로 상태변경 웹훅">
+
+에스크로 상태 변경이 이뤄지면 고객사의 웹훅을 호출하여 통해 아래와 같은 데이터가 전송됩니다.
+
+```json
+{
+  "event": "Inicis.Escrow.Changed",
+  "imp_uid": "imp_123412341234",
+  "merchant_uid": "asdfasdfasdf",
+  "status": "paid",
+  "extra": {
+    "escrow_status": "4",
+    "changed_at": 112312323,
+    "denied_reason": "구매 거절 사유"
+  }
+}
+```
+
+웹훅 데이터 필드 설명
+
+|필드명               |타입  |설명                                                                                                                                                                            |
+|---------------------|------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+|`event`              |string|이벤트 타입 (항상 `Inicis.Escrow.Changed`)                                                                                                                                      |
+|`imp_uid`            |string|포트원 거래 고유번호                                                                                                                                                            |
+|`merchant_uid`       |string|고객사 주문번호                                                                                                                                                                 |
+|`status`             |string|결제 상태                                                                                                                                                                       |
+|`extra.escrow_status`|string|에스크로 상태구분 <br />- `2`: 배송등록<br />- `3`: 구매확인<br />- `31`: 자동구매확인<br />- `32`: 강제구매확인<br />- `4`: 구매거절<br />- `8`: 거래취소<br />- `10`: 거절확인|
+|`extra.changed_at`   |number|상태 변경 시각 (Unix Timestamp)                                                                                                                                                 |
+|`extra.denied_reason`|string|구매 거절 사유 (구매거절시 전달)                                                                                                                                                |
+
+<div class="hint" data-style="warning">
+
+이니시스 에스크로 웹훅 기능을 사용하려면 별도 설정이 필요합니다.
+<cs@portone.io>로 아래와 같이 설정 요청 메일을 보내주세요.
+
+```text
+제목: [에스크로 상태 변화에 따른 통보 수신 URL 설정 요청]
+
+안녕하세요, 포트원 담당자님
+
+에스크로 상태 변화에 따른 통보 수신 URL 설정 요청드립니다.
+
+■ 고객사 정보
+- 상호명: [상호명 입력]
+- 사업자번호: [사업자번호 입력]
+- 이니시스 MID: [MID 입력]
+
+■ 이니시스 에스크로 상태변화 수신 URL
+-URL : https://service.iamport.kr/inicis_payments/escrow/changed
+-한글 인코딩 : UTF-8
+
+감사합니다.
+```
+
+</div>
+
+</div>
+
 </div>

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

@@ -185,10 +185,21 @@ curl -H "Content-Type: application/json" \
 
 </div>
 
-<div class="hint" data-style="info">
+## 유의사항
+
+<details>
+
+<summary> 부가세 지정 미지원</summary>
+
+- 카카오페이 결제 시 부가세 지정은 지원하지 않습니다.
+- 카카오페이 결제 취소 시 부가세 지정은 지원하지 않습니다.
+
+</details>
 
 ## 참고사항
 
+<div class="hint" data-style="info">
+
 - 카카오페이 결제버튼이 노출되는 것을 권장 합니다.
 - 카카오페이 고객사 사이니지 이미지를 [다운받아](http://biz.kakaopay.com/online/guide) 활용할 수 있습니다.
 

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

@@ -255,7 +255,8 @@ KICC는 **현금성 결제수단** (실시간 계좌이체, 가상계좌)에 한
       "code": "367",
       "quota": 3
     }
-  }
+  },
+  "company": "고객사" //해당 파라미터를 설정하지 않으면 카드사 모듈 창에 iamport 로 표기
 }
 ```
 
@@ -263,6 +264,7 @@ KICC는 **현금성 결제수단** (실시간 계좌이체, 가상계좌)에 한
 
 - **`code`** : 카드사 금융결제원 표준 코드. [**링크**](https://developers.portone.io/opi/ko/support/code-info/card-code) 참조 (**string**)
 - **`quota`** : 할부 개월 수. 일시불일 시 0 으로 지정. (**number**)
+- **`company`** : 카드사 모듈 바로 호출 시 결제창에 표시될 상호명. 입력하지 않으면 iamport로 표시됩니다.
 
 <div class="hint" data-style="danger">
 

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

@@ -289,7 +289,7 @@ curl -H "Content-Type: application/json" \
 
 빌링키 발급과 최초 결제가 성공하면 빌링키는 전달된 `customer_uid` 와 1:1 매칭되어 포트원에 저장됩니다.
 보안상의 이유로 서버는 빌링키에 직접 접근할 수 없기 때문에 `customer_uid`를 이용해서
-재결제([**POST /subscribe/payments/again**](https://developers.portone.io/api/rest-v1/nonAuthPayment#post%20%2Fsubscribe%2Fpayments%2Fagain)) REST API를 다음과 같이 호출합니다.
+빌링키 결제([**POST /subscribe/payments/again**](https://developers.portone.io/api/rest-v1/nonAuthPayment#post%20%2Fsubscribe%2Fpayments%2Fagain)) REST API를 다음과 같이 호출합니다.
 
 ```sh
 curl -H "Content-Type: application/json" \

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

@@ -334,7 +334,7 @@ curl -H "Content-Type: application/json" \
 
 **빌링키로 결제 요청하기**
 
-빌링키 발급과 최초 결제가 성공하면 빌링키는 전달된 `customer_uid` 와 1:1 매칭되어 포트원에 저장됩니다. 보안상의 이유로 서버는 빌링키에 직접 접근할 수 없기 때문에 `customer_uid`를 이용해서 재결제([**POST /subscribe/payments/again**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)) REST API를 다음과 같이 호출합니다.
+빌링키 발급과 최초 결제가 성공하면 빌링키는 전달된 `customer_uid` 와 1:1 매칭되어 포트원에 저장됩니다. 보안상의 이유로 서버는 빌링키에 직접 접근할 수 없기 때문에 `customer_uid`를 이용해서 빌링키 결제([**POST /subscribe/payments/again**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)) REST API를 다음과 같이 호출합니다.
 
 ```sh
 curl -H "Content-Type: application/json" \