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

package/assets/docs/opi/ko/extra/confirm-process/readme-v1.md

@@ -1,15 +1,13 @@
 ---
 title: 컨펌 프로세스
-description: 결제요청의 주체를 고객사 서버로 가져갈수 있는 서비스입니다.
+description: 결제 승인 직전에 고객사 측에 결제 의사를 최종적으로 확인하는 기능입니다.
 targetVersions:
   - v1
 versionVariants:
   v2: /opi/ko/extra/confirm-process/readme-v2
 ---
 
-## 해당 서비스는 결제요청직전에 고객사 측에 결제의사를 최종적으로 확인하는 서비스입니다.
-
-![](</gitbook-assets/ko/image (259).png>)
+결제 승인 직전에 고객사 측에 결제 의사를 최종적으로 확인하는 기능입니다.
 
 (이미지 첨부: 컨펌 프로세스)
 
@@ -17,9 +15,9 @@ versionVariants:
 
 **해당 서비스가 반드시 필요한 고객사는 아래와 같은 경우입니다.**
 
-- 판매 제품이 재고적으로 소량인 경우
-- 선착순방식으로 결제가 진행되는 경우
-- 결제 요청전 마지막으로 고객사에서 처리하고 싶은 업무처리가 있는 경우
+- 판매 제품의 재고가 소량으로 재고파악이 필요한 경우 (한정된 상품 또는 고가 제품 판매시)
+- 선착순 방식으로 결제가 진행되어야 하는 경우
+- 결제 승인 전 마지막으로 고객사에서 처리하고 싶은 로직이 존재하는 경우
 
 </div>
 

package/assets/docs/opi/ko/extra/confirm-process/readme-v2.md

@@ -1,13 +1,13 @@
 ---
 title: 컨펌 프로세스
-description: 결제 승인의 주체를 고객사 서버로 가져갈 수 있는 서비스입니다.
+description: 결제 승인 직전에 고객사 측에 결제 의사를 최종적으로 확인하는 기능입니다.
 targetVersions:
   - v2
 versionVariants:
   v1: /opi/ko/extra/confirm-process/readme-v1
 ---
 
-**해당 서비스는 결제 승인 직전에 고객사에서 결제 의사를 최종적으로 확인하는 서비스입니다.**
+결제 승인 직전에 고객사 측에 결제 의사를 최종적으로 확인하는 기능입니다.
 
 <div class="hint" data-style="info">
 

package/assets/docs/opi/ko/extra/identity-verification/readme-v2.md

@@ -162,7 +162,7 @@ app.post("/identity-verifications", async (req, res) => {
 - `ci`: 연계 정보(Connecting Information).
   - 사람마다 고유하고 서비스별로 달라지지 않기 때문에, 서비스 간 연계에 사용할 수 있음.
   - 다날의 경우 항상 제공.
-  - KCP의 경우 항상 제공.
+  - KCP의 경우 가맹점 설정에 따라 제공.
   - KG이니시스의 경우 카카오를 제외한 인증 업체에서 항상 제공. 카카오의 경우 별도 서류 작성이 필요합니다.
 
 - `di`: 중복 가입 확인 정보(Duplication Information).

package/assets/docs/opi/ko/extra/manual-confirm/readme-v2.md

@@ -13,7 +13,7 @@ targetVersions:
 
 **수동 승인을 사용할 수 없는 PG**
 
-엑심베이, 페이레터 해외결제의 경우 수동 승인을 지원하지 않고, 채널 설정에서도 해당 항목이 보이지 않습니다.
+엑심베이, 페이레터 해외결제, 이지페이(KICC)의 경우 수동 승인을 지원하지 않고, 채널 설정에서도 해당 항목이 보이지 않습니다.
 
 이는 근본적으로 위챗 결제와 같이 일부 해외 결제수단이 수동 승인을 지원하지 않기 때문입니다. 따라서 추후 포트원에 추가되는 PG가 이러한 결제수단을 지원한다면, 해당 PG에서는 수동 승인을 이용할 수 없을 가능성이 높습니다.
 

package/assets/docs/opi/ko/integration/cancel/v1/virtual-account.md

@@ -20,6 +20,9 @@ versionVariants:
 
 PG사는 이런 과정에서 발생할 수 있는 혼란을 미연에 방지하고자 **가상계좌 특약서비스에 가입한 고객사에 한해서만 가상계좌 환불을 제공**하고 있습니다.
 
+단, **토스페이먼츠**의 경우 별도의 특약 가입 없이도 가상계좌 환불이 가능합니다.
+이 경우 환불 시 기존 거래에서 발생한 수수료는 환불되지 않습니다.
+
 </div>
 
 가상계좌의 경우 단방향 결제수단이여서 환불 대상을 알 수 없으므로 환불 금액 외에 다음의 환불 수령계좌 정보를 입력해야 합니다.
@@ -32,7 +35,7 @@ PG사는 이런 과정에서 발생할 수 있는 혼란을 미연에 방지하
 
 **가상계좌 은행코드는 PG사에 따라 다릅니다**
 
-`은행코드는`같은 은행이더라도 PG사에 따라 상이하므로 \*\*은행코드(TODO)\*\*표에서 은행코드를 확인해 주세요
+은행코드는 같은 은행이더라도 PG사에 따라 상이하므로 [은행코드표](https://developers.portone.io/opi/ko/support/code-info/pg-1?v=v1)에서 은행코드를 확인해 주세요.
 
 </div>
 

package/assets/docs/opi/ko/integration/cancel/v2/readme.md

@@ -31,6 +31,9 @@ PG사를 통해 직접 취소할 경우 포트원과 결제 상태가 동기화
 
 PG사는 이런 과정에서 발생할 수 있는 혼란을 미연에 방지하고자 **가상계좌 특약서비스에 가입한 고객사에 한해서만 가상계좌 환불을 제공**하고 있습니다.
 
+단, **토스페이먼츠**의 경우 별도의 특약 가입 없이도 가상계좌 환불이 가능합니다.
+이 경우 환불 시 기존 거래에서 발생한 수수료는 환불되지 않습니다.
+
 </div>
 
 - **필수 정보**: 환불 계좌 정보 (`refundAccount.bank`, `refundAccount.number`, `refundAccount.holderName`)
@@ -262,7 +265,7 @@ try {
 
     **계좌 은행**
 
-    [Bank](https://developers.portone.io/api/rest-v2/type-def#Bank) 타입 참고
+    [Bank](https://developers.portone.io/api/rest-v2/payment#Bank) 타입 참고
 
   - number: string
 

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

@@ -15,12 +15,6 @@ targetVersions:
 
 [JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk-old/readme) `IMP.request_pay(param, callback)`을 호출하여 키움페이 결제창을 호출할 수 있습니다. **결제 결과**는 PC의 경우 `IMP.request_pay(param, callback)` 호출 후 **callback**으로 수신되고 모바일의 경우 **m\_redirect\_url**로 리디렉션됩니다.
 
-<div class="hint" data-style="warning">
-
-**키움페이 결제창 연동을 위해서는 ****JS SDK Version 1.2.0**** 이상을 사용하셔야 합니다.**
-
-</div>
-
 <div class="tabs-container">
 
 <div class="tabs-content" data-title="인증결제창 요청">
@@ -96,6 +90,7 @@ IMP.request_pay(
   - cultureland (컬쳐랜드 문화상품권)
   - smartculture (스마트문화상품권)
   - booknlife (도서문화상품권)
+  - phone (휴대폰결제)
 
 - merchant\_uid: string
 
@@ -135,6 +130,43 @@ IMP.request_pay(
 
   'Y'로 입력하는 경우 키움페이 화면이 노출되지 않고 바로 카드사, 간편결제 결제창이 호출됩니다.
 
+- bypass.daou.CARDQUOTA?: string
+
+  **카드사별 할부개월 수 설정**
+
+  ^ 로 구분된 다수의 카드 할부 설정 그룹으로 구성되며, 각 그룹은 `{키움페이_카드사_코드}-{할부_개월수_옵션1}:{할부_개월수_옵션2}:...` 형식으로 구성하여 카드사별 할부 개월 수를 지정합니다.
+
+  예시로 `CCBC-0:2:3:4:5:6^CCNH-0:2:3^CCKM-0:2:3:4` 를 입력하는 경우 BC카드는 일시불, 2, 3, 4, 5, 6개월, 농협카드는 일시불, 2, 3개월, 국민카드는 일시불, 2, 3, 4개월 할부가 선택 가능하도록 표시됩니다.
+
+  카드사 코드
+
+  |카드사 명   |코드|
+  |------------|----|
+  |비씨카드    |CCBC|
+  |국민카드    |CCKM|
+  |제주은행    |CCCJ|
+  |신한카드    |CCLG|
+  |씨티은행    |CCCT|
+  |롯데카드    |CCLO|
+  |신협카드    |CCCU|
+  |새마을금고  |CCMG|
+  |현대카드    |CCDI|
+  |NH카드      |CCNH|
+  |현대증권    |CCHD|
+  |우리카드    |CCPH|
+  |하나SK카드  |CCHN|
+  |우체국카드  |CCPO|
+  |전북은행    |CCJB|
+  |저축은행카드|CCSB|
+  |카카오뱅크  |CCKA|
+  |삼성카드    |CCSS|
+  |산은카드    |CCKD|
+  |수협        |CCSU|
+  |하나은행    |CCKE|
+  |토스뱅크    |CCTS|
+  |광주은행    |CCKJ|
+  |K뱅크       |CKBK|
+
 - app\_scheme?: string
 
   **모바일 앱 URL Scheme**
@@ -311,4 +343,97 @@ curl -H "Content-Type: application/json" \
 
 </div>
 
+<div class="tabs-content" data-title="통신사 노출 제어">
+
+```json title="모든 통신사 노출"
+{
+  "phone": {
+    "detail": [
+      {
+        "carrier": "*", // 모두 활성화
+        "enabled": true
+      }
+    ]
+  }
+}
+```
+
+```json title="특정 통신사만 노출"
+{
+  "phone": {
+    "detail": [
+      {
+        "carrier": "SKT", // SKT만 활성화
+        "enabled": true
+      }
+    ]
+  }
+}
+```
+
+```json title="2개 이상 통신사 노출"
+{
+  "phone": {
+    "detail": [
+      {
+        "carrier": "SKT",
+        "enabled": true
+      },
+      {
+        "carrier": "KTF",
+        "enabled": true
+      },
+      {
+        "carrier": "LGT",
+        "enabled": false
+      },
+      {
+        "carrier": "CJH",
+        "enabled": false
+      }
+    ]
+  }
+}
+// SKT, KTF 을 제외한 나머지 통신사는 비활성화 됩니다.
+```
+
+```json title="특정 통신사만 비노출"
+{
+  "phone": {
+    "detail": [
+      {
+        "carrier": "SKT",
+        "enabled": false
+      }
+    ]
+  }
+}
+```
+
+<div class="hint" data-style="info">
+
+`phone 파라미터 미 설정시`(기본값) 모든 통신사 노출됨
+
+</div>
+
+</div>
+
+<div class="tabs-content" data-title="휴대폰 번호 고정">
+
+```json
+{
+  "prefill": {
+    "phoneNumber": "휴대폰번호" // 휴대폰번호 입력(하이픈 제거)
+  }
+}
+```
+
+<div class="hint" data-style="info">
+
+휴대폰 결제시 해당 파라미터를 설정하면 휴대폰번호를 고정시킬수 있습니다.
+
+</div>
+
+</div>
+
 </div>