@portone/mcp-server 0.13.0

package/assets/docs/opi/ko/support/faq/undefined.md

@@ -0,0 +1,60 @@
+---
+title: 자주 묻는 질문
+description: 고객사에서 빈번하게 물어보시는 질문을 확인 합니다.
+cover: >-
+  https://images.unsplash.com/photo-1633613286848-e6f43bbafb8d?crop=entropy&cs=srgb&fm=jpg&ixid=MnwxOTcwMjR8MHwxfHNlYXJjaHwzfHxRdWVzdGlvbnxlbnwwfHx8fDE2ODE3MTczODk&ixlib=rb-4.0.3&q=85
+coverY: 185
+targetVersions:
+  - v1
+---
+
+<details>
+
+<summary>웹훅 발송규칙</summary>
+
+- 기본적으로 1회 발송 됩니다.
+- 재발송 설정을 희망하는 경우 1분 단위로 최대 5회까지 발송이 가능하며 고객사 응답(**HTTP STATUS**)이 **200**응답을 주시는 경우 발송은 중단됩니다.
+- 관리자 콘솔에서 웹훅 재 전송이 가능합니다. (결제승인내역 -> 웹훅로그 -> 재전송)
+- 웹훅주소를 변경한 경우 과거거래 재 발송시 기존 웹훅 URL로 전송됩니다.
+
+</details>
+
+<details>
+
+<summary>통합 응답코드 제공 여부</summary>
+
+결제응답으로 내려가는 오류코드 및 메세지는 원천사(PG사)가 내려주는 응답코드와 메세지를 그대로 내려드리고 있습니다. 당사와 연동되어 있는 PG사에 따라 응답코드와 메세지가 모두 상이하여 통합적으로 정리되어 있는 오류코드표는 존재하지 않습니다.
+
+</details>
+
+<details>
+
+<summary>운영계정 및 개발계정 구분방법</summary>
+
+**하나의 계정으로 실모드 & 테스트모드 운영**
+
+기존 설정되어있던 항목에 'PG사 추가' 하여 테스트용 상점정보를 입력
+
+- 장점: 동일한 고객사 식별코드 / API key, secret 으로 테스트가 가능
+- 단점: 상용계정과 함께 운영하기 때문에 PG설정/저장에 주의필요
+
+**\[체크사항]**
+
+동일 PG의 경우 상점 아이디별로 결제요청을 하려면 pg 파라미터에 **PG사명.상점아이디** 로 지정하여 요청해야 합니다.
+
+**테스트용도로 새로운 계정 생성하여 분리**
+
+포트원 관리자페이지(<https://admin.portone.io/>) 회원가입 하시어 개발용도의 계정을 생성하시는 방법입니다.
+
+- 장점 : 상용과 개발용을 분리함으로써 안정적인 테스트 가능
+- 단점 : 고객사 식별코드 / API key, secret 정보가 달라지다보니 소스코드 분기가 필요
+
+</details>
+
+<div class="hint" data-style="info">
+
+**더 많은 질문 리스트는 헬프센터를 참고해 주세요**
+
+[헬프센터 바로가기](https://help.portone.io/category/faq)
+
+</div>

package/assets/docs/opi/ko/support/flow.md

@@ -0,0 +1,24 @@
+---
+title: 포트원 결제 플로우
+description: PG사 직연동과 포트원 연동시의 결제 플로우 차이점을 확인할 수 있습니다.
+targetVersions:
+  - v1
+---
+
+## 1. PG사 직연동시 결제 흐름도
+
+(이미지 첨부: PG사 직연동 결제 플로우)
+
+> PG사 모듈을 직접 연동시에는 일반적으로 결제요청은 **2-Transaction** 으로 처리됩니다.
+>
+> 1. 결제요청을 위한 **인증키 획득**
+> 2. **실 결제요청**
+
+> 백엔드 개발 포인트가 여러군데 존재하며 복잡한 형태의 연동 모듈과 샘플페이지
+> 그리고 이해하기 어려운 연동메뉴얼 분석의 **삼중고**를 겪으시게 됩니다.
+
+## 2. 포트원 결제 흐름도
+
+(이미지 첨부: 포트원 결제 플로우)
+
+> 포트원을 통해 결제연동을 진행하시는 경우 복잡한 PG사 모듈 연동부는 이미 포트원에서 처리 되었기 때문에 도식의 흐름대로 결제처리가 이루어집니다.

package/assets/docs/opi/ko/support/redirect.md

@@ -0,0 +1,26 @@
+---
+title: 리디렉션이란?
+description: 리디렉션의 정의를 자세히 확인할수 있습니다.
+targetVersions:
+  - v1
+---
+
+**현재 페이지를 다른 페이지로 이동함을 의미합니다.**
+
+![](</gitbook-assets/ko/image (145).png>)
+
+## 리디렉션은 왜 필요할까요?
+
+- 기존의 페이지의 주소가 새롭게 변경되어 이동이 필요한 경우
+- 불필요하거나 잘못된 서브 주소를 하나로 이동시키는 경우
+- 로그인, 인증 등의 목적으로 다른 주소로 이동이 필요한 경우
+
+**리디렉션은 아래와 같이 두 가지로 구분이 됩니다.**
+
+- **리디렉션 301**
+
+  - 서버사이드 및 클라이언트 언어에서 어떤 코드도 수행하지 않고 바로 리디렉션 처리
+
+- **리디렉션 302**
+
+  - 일시적인 방법으로 Redirect으로 스크립트나 html 태그를 이용한 방법

package/assets/docs/opi/ko/support/tax.md

@@ -0,0 +1,142 @@
+---
+title: 면세금액 결제방법
+description: 결제 요청 시 상황에 맞게 면세 금액를 설정할 수 있는 방법을 설명합니다.
+targetVersions:
+  - v1
+---
+
+<div class="hint" data-style="info">
+
+**이 문서는 [부가가치세법 제26조(재화 또는 용역의 공급에 대한 면세)](https://txsi.hometax.go.kr/docs/customer/comment/comment_jomun_main_internet.jsp?node_id=null\&lawid=001571\&jomunkey=0026005\&lawnm=%EB%B6%80%EA%B0%80%EA%B0%80%EC%B9%98%EC%84%B8%EB%B2%95\&jomun_nm=%EC%A0%9C26%EC%A1%B0%E3%80%90%EC%9E%AC%ED%99%94%20%EB%98%90%EB%8A%94%20%EC%9A%A9%EC%97%AD%EC%9D%98%20%EA%B3%B5%EA%B8%89%EC%97%90%20%EB%8C%80%ED%95%9C%20%EB%A9%B4%EC%84%B8%E3%80%91\&public_ilja=20161220\&public_no=14387)에 정해진 부가가치세(부가세) 면세상품을 판매하는 사업자에게 해당합니다.**
+
+해당 조항에서 언급하는 재화 또는 서비스를 취급하지 않는 일반적인 사업자의 경우에는 PG사/카드사를 통해 자동으로 10% 부가세 적용이 이루어지기 때문에 아래의 내용은 참고사항으로 알아두셔도 됩니다.
+
+</div>
+
+## PG 계약 시 상점아이디 설정하기 <a href="#pg" id="pg" />
+
+**부가세 면세 사업자의 경우** PG 계약 시 면세 사업자임을 밝히고 사업자등록증을 제출하면 면세 금액를 설정할 수 있는 상점아이디를 발급받을 수 있습니다.
+`IMP.`**`request_pay`** 함수로 결제창을 호출할 때 다음 속성들을 사용하여 면세 금액를 적용할 수 있습니다.
+
+- **`amount`**: 총 결제금액
+- **`tax_free`**: 총 면세상품의 금액
+
+일부 PG사의 경우 상점아이디의 과세/면세별로 구분을 두지 않고 하나의 상점아이디를 사용하여 `tax_free` 속성으로 면세 금액을 설정하는 경우도 있습니다.
+
+<div class="hint" data-style="info">
+
+**상점아이디**
+
+각 PG사 별로 가입신청 및 계약 완료 이후 발급되는 상점아이디 명칭은 PG사 별로 다릅니다.
+예를 들어, KG이니시스는 `상점 아이디(MID)`, 카카오페이는 `고객사 코드(CID)`, 그리고 네이버페이는 `파트너 ID`를 발급받습니다.
+
+</div>
+
+면세 기준에 따라 발급받는 상점아이디는 다음 3가지 유형이 있습니다.
+
+> **면세 상점아이디**
+>
+> 면세 상품만 판매하는 사업자의 경우 면세 상점아이디를 발급 받습니다.
+> 면세 상점아이디로 거래를 하면, `tax_free` 속성은 무시되고 모든 결제 건은 일괄 면세 처리 됩니다.
+
+> **과세 상점아이디**
+>
+> 과세 상품만 판매하는 사업자의 경우 과세 상점아이디를 발급 받습니다.
+> 과세 상점아이디로 거래를 하면, `tax_free` 속성은 무시되고 모든 결제 건은 일괄 과세 처리 됩니다.
+
+> **복합과세 상점아이디**
+>
+> 과세상품과 면세상품을 함께 판매하는 사업자의 경우 판매되는 상품에 따라 면세 금액액이 달라질 수
+> 있으므로, 반드시 복합 과제 상점아이디를 발급 받아야 합니다.
+>
+> 과세상품과 면세상품을 함께 구매하는 경우에는, `amount` 속성에 **총 결제 금액**을 지정하고
+> `tax_free` 속성에는 구매하는 상품 중 **면세상품의 금액 합계**를 지정합니다.
+
+<div class="hint" data-style="warning">
+
+**`tax_free` 속성은 필수 입력**
+
+복합 과세 상점아이디 거래건의 경우 **반드시 `amount` 속성과 `tax_free` 속성을 함께 설정해야** 합니다.
+일부 PG사의 경우 `tax_free` 값이 누락되면 결제창 호출 단계에서 오류가 발생할 수 있습니다.
+
+특히 KG이니시스의 경우 **모든 결제건을 일괄 면세 처리**하고 있으며 과세 상점 아이디를 사용하다가 중간에 복합 과세 상점 아이디로 변경하면 기존에 과세 결제건을 모두 일괄 면세로 변경하고 있으니 이용에 주의하시길 바랍니다.
+
+</div>
+
+## 상황별 tax\_free 속성 적용하기 <a href="#taxfree" id="taxfree" />
+
+고객이 과세상품과 면세상품을 동시에 구매하는 상황을 가정하여 각각의 시나리오별로 `amount`와 `tax_free`속성을 다음과 같이 설정합니다.
+다음은 한 화훼 사업자(부가세 면세사업자)가 식물 모종과 화병을 판매하는 예제입니다.
+
+- 식물 모종: **부가세 면세 상품**, 모종 당 11,000원
+- 화병: **부가세 과세 상품**, 병당 22,000원
+
+### CASE 01. 고객이 모종(면세 상품)만 구매하는 경우
+
+고객이 11,000원짜리 모종 1단을 구매할 때 총 결제 금액은 11,000원이며 그 중 면세항목 상품의 금액 합계는 11,000원이므로 다음과 같이 설정합니다.
+
+```ts title="JavaScript"
+IMP.request_pay(
+  {
+    amount: 11000, // 결제금액
+    tax_free: 11000, // 면세공급가액
+    // ...
+  },
+  function (rsp) {
+    // ...
+  },
+);
+```
+
+위와같이 결제 속성을 지정하면 11,000원 전액이 면세적용되며 발급되는 매출전표에는 다음과 같은 내용을 확인할 수 있습니다.
+(_PG사에 따라 용어가 다를 수 있습니다_)
+
+- 면세 공급가액 : 11,000원
+- 부가가치세 : 0원
+
+### CASE 02. 고객이 화병(과세 상품)만 구매하는 경우
+
+고객이 22,000원짜리 화병 1병을 구매할 때 총 결제 금액은 22,000원이며 그 중 면세항목 상품의 금액 합계는 0원이므로 다음과 같이 설정합니다.
+
+```ts title="JavaScript"
+IMP.request_pay(
+  {
+    amount: 22000, // 결제금액
+    tax_free: 0, // 면세공급가액
+    // ...
+  },
+  function (rsp) {
+    // ...
+  },
+);
+```
+
+위와같이 결제 속성을 지정하면 22,000원에 대해 10%의 부가가치세가 적용되며, 발급되는 매출전표에는 다음과 같은 내용을 확인할 수 있습니다.
+
+- 일반공급가액 : 20,000원
+- 부가가치세 : 2,000원
+
+### CASE 03. 고객이 모종과 화병을 동시(면세 및 과세 상품)에 구매하는 경우
+
+고객이 모종 3단과 화병 1병을 구매할 때 총 결제 금액은 55,000원(33,000원 + 22,000원)이며 그 중
+면세항목 상품의 금액 합계는 33,000원(모종 3단의 금액 합계)이므로 다음과 같이 설정합니다.
+
+```ts title="JavaScript"
+IMP.request_pay(
+  {
+    amount: 55000, // 결제금액
+    tax_free: 33000, // 면세공급가액
+    // ...
+  },
+  function (rsp) {
+    // ...
+  },
+);
+```
+
+위와같이 결제 속성을 지정하면 55,000원 중 22,000원(과세금액)에 대해 10%의 부가가치세가 적용되며
+33,000원에 대해 면세적용되어 발급되는 매출전표에는 다음과 같은 내용을 확인할 수 있습니다.
+
+- 일반공급가액 : 20,000원
+- 면세공급가액 : 33,000원
+- 부가가치세 : 2,000원