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

package/assets/docs/api/rest-v1/_components/v1auth.md

@@ -1,103 +0,0 @@
----
-title: V1 API 인증 방법
-description: 포트원 V1 API 사용 시 인증 방법에 관한 내용입니다.
-targetVersions:
-  - v1
----
-
-포트원 API를 호출할 때는 **액세스 토큰**을 `Authorization` 헤더에 넣어주어야 합니다.\
-액세스 토큰은 [access\_token 발급 API - POST /users/getToken](https://developers.portone.io/schema/v1.openapi.yml)를 호출해서 발급받을 수 있습니다.
-
-액세스 토큰 발급 API를 호출하려면 **API 키**와 **API 시크릿**을 인자로 넣어주어야 합니다.
-
-<details>
-
-<summary>API 키와 API 시크릿 확인하기</summary>
-
-1. [관리자 콘솔 `상점・계정 관리` 화면](https://admin.portone.io/merchant) 접속
-2. `내 식별코드・API Keys` 버튼 클릭
-
-(이미지 첨부: API 키와 API 시크릿은 관리자 콘솔 → 상점・계정 관리 메뉴 → 내 식별코드・API Keys 모달을 열어서 확인하실 수 있습니다)
-
-<div class="hint" data-style="danger">
-
-**API 시크릿은 절대로 외부에 노출되어서는 안 되는 값**입니다.\
-실제 구현에서 액세스 토큰 발급은 꼭 서버 사이드에서 해주세요.
-
-</div>
-
-</details>
-
-<details>
-
-<summary>액세스 토큰 발급 받기</summary>
-
-[access\_token 발급 API - POST /users/getToken](https://developers.portone.io/schema/v1.openapi.yml) 호출
-
-(이미지 첨부: /users/getToken API를 호출해서 액세스 토큰을 발급받습니다)
-
-<div class="hint" data-style="info">
-
-포트원 REST API 서버는 **Google Public NTP**의 시간과 동기화되고 있습니다.
-
-</div>
-
-<div class="hint" data-style="warning">
-
-하위 상점 연동을 할 경우 액세스 토큰을 발급받을 때 **Agent 계정**의 **API 키** 와 **API 시크릿**을 사용해야 합니다.
-
-[Agency & Tier 란?](https://developers.portone.io/opi/ko/support/agency-and-tier)
-
-</div>
-
-</details>
-
-<details>
-
-<summary>액세스 토큰 사용하기</summary>
-
-발급받은 액세스 토큰은 다른 API를 호출할 때\
-`Authorization` 헤더에 `Bearer <액세스 토큰>` 형식의 값을 넣어주면 됩니다.
-
-자세한 내용은 [MDN - HTTP 인증 문서](https://developer.mozilla.org/ko/docs/Web/HTTP/Authentication)를 참고해주세요.
-
-(관련 이미지 첨부)
-
-<div class="hint" data-style="warning">
-
-하위 상점 연동을 할 경우 포트원 API 호출시 `Tier` 헤더에 하위 상점 티어 코드를 입력해야 합니다.
-
-[Agency & Tier 란?](https://developers.portone.io/opi/ko/support/agency-and-tier)
-
-(관련 이미지 첨부)
-
-</div>
-
-</details>
-
-<details>
-
-<summary>액세스 토큰 만료기한 연장</summary>
-
-만료된 액세스 토큰으로 API를 호출하면 `401 Unauthorized` 응답을 받습니다.\
-액세스 토큰의 만료 기한은 발행시간부터 **30분**입니다.
-
-- 기존 액세스 토큰이 만료되기 전 [access\_token 발급 API - POST /users/getToken](https://developers.portone.io/schema/v1.openapi.yml)를 다시 호출했을 경우
-  - 기존 액세스 토큰이 반환됩니다.\
-    **만료 기한이 1분 안쪽으로 남았을 때** 요청했다면 기존 액세스 토큰의 만료 기한이 **5분 연장**됩니다.
-
-- 기존 액세스 토큰이 만료된 다음 [access\_token 발급 API - POST /users/getToken](https://developers.portone.io/schema/v1.openapi.yml)를 다시 호출했을 경우
-  - 새로운 액세스 토큰이 반환됩니다.
-
-(관련 이미지 첨부)
-
-<div class="hint" data-style="info">
-
-액세스 토큰의 재사용과 만료기한 5분 연장 동작방식은 다음과 같은 상황을 고려해서 설계되었습니다.
-
-- 한 고객사에서 여러 대의 웹서버가 동시에 경쟁적으로 REST API(`/users/getToken`)를 호출하는 상황
-- 한 고객사에서 여러 대의 웹서버가 시간 동기화 되어있지 않은 상황
-
-</div>
-
-</details>

package/assets/docs/help/core-service/payment-type/tosspayments-easypay-hub-fee.md

@@ -1,42 +0,0 @@
----
-title: 토스페이먼츠_제휴 간편결제 추가 방법 안내
-category: 결제서비스 (채널설정 및 이용안내) > 결제유형 > 간편결제
-seo:
-  title: 토스페이먼츠_제휴 간편결제 추가 방법 안내
-  description: |
-    토스페이먼츠에 이미 가입되어 있으신 경우,
-    토스페이먼츠측에 간편결제 추가계약 절차가 필요 합니다!
-tags:
-  - 토스페이먼츠
-  - 간편결제
-pgCompanies:
-  - 토스페이먼츠
-searchTags:
-  - 추가계약
-  - 간편결제 추가
-  - 간편결제
-  - 제휴 간편결제
-  - 토스페이먼츠
-datetime: 2024-07-10T07:39:34.415Z
----
-
-<Callout content=" 토스페이먼츠에 이미 가입되어 있으신 경우, 
-토스페이먼츠측에 간편결제 추가계약 절차가 필요 합니다!" />
-
-### 토스페이먼츠 추가계약 절차
-
-- 토스페이먼츠 홈페이지 <https://www.tosspayments.com/> 접속 > 기존 토스페이먼츠 계정 로그인
-- 로그인 후 화면 하단 "전자결제 신청" 선택
-- 사업자등록번호 입력
-- 호스팅사에서 제공하는 쇼핑몰 구축 서비스를 이용 중이신가요? > “네” 선택
-- 이용중인 호스팅사를 선택하세요 > "\[다른 업체 검색]" 선택 후 검색란에 "포트원(간편결제)" 입력
-- 검색된 리스트 중 "포트원(간편결제)" 선택
-
-신청접수가 완료되면 토스페이먼츠 담당자가 계약절차 및 계약서류 안내드릴 예정입니다. (약 3영업일 소요)
-
-
-
-- 토스페이먼츠는 일반결제와 제휴 간편결제용 MID가 개발 발급되므로, 추가 설정하시어 pg파라미터에 MID를 지정하여 요청하도록 구현 부탁 드립니다.
-- [제휴 간편결제 이용 방법 보러가기 ↗](https://help-center-portone.vercel.app/content/hub-service-fee)
-- [토스페이먼츠\_간편결제 연동 방법 ↗](https://guide.portone.io/67330b1b-24a9-444a-a394-a2783e8876a2)
-- [토스페이먼츠\_애플페이 이용 방법 보러가기 ↗ ](https://guide.portone.io/67330b1b-24a9-444a-a394-a2783e8876a2)

package/assets/docs/opi/ko/integration/ready/_components/integration-guide/hyphen.md

@@ -1,27 +0,0 @@
----
-title: 결제대행사별 연동 정보 확인하기 - 하이픈
-targetVersions:
-  - v2
----
-
-1. [HYPHEN PAY & 바로계좌결제 운영 백오피스](http://payadmin.hyphen.im/) 접속 후 **바로계좌결제** 선택 후
-   로그인을 합니다.
-
-   (이미지 첨부: HYPHEN 백오피스 로그인 화면)
-
-2. \[상점관리]→\[바로계좌결제 상점정보관리]를 클릭합니다.
-
-3. 상점명을 클릭합니다.
-
-   (이미지 첨부: HYPHEN \[상점관리] - \[상점정보관리] 예시 화면)
-
-4. \[상점 기본정보]에서 \[상점번호]를 확인합니다.
-
-   (이미지 첨부: HYPHEN \[상점 기본정보] 예시 화면)
-
-5. \[암호화 키, 토큰]에서 \[암호화 키]와 \[암호화 토큰]을 확인합니다.
-
-   (이미지 첨부: HYPHEN \[암호화 키, 토큰] 예시 화면)
-
-6. 포트원 콘솔에서 채널 추가 시 \[PG상점아이디(상점 번호)], \[암호화 키], \[암호화 토큰]을
-   입력한 후 \[저장]을 클릭합니다.

package/assets/docs/opi/ko/integration/ready/_components/integration-guide/inicis.md

@@ -1,64 +0,0 @@
----
-title: 결제대행사별 연동 정보 확인하기 - KG이니시스
-targetVersions:
-  - v1
-  - v2
----
-
-<!-- VERSION-SPECIFIC: V1 ONLY CONTENT START -->
-
-<div class="hint" data-style="info">
-
-- **INILite Key**는 정기결제 시 필수로 입력해야 합니다.
-- **INIAPI Key**, **INIAPI IV** 하위 상점 관련 API 사용시 필수로 입력해야 합니다. [영수증 내 하위 상점 거래 등록 API 바로가기](https://developers.portone.io/api/rest-v1/partner#post%20%2Fpartners%2Freceipts%2F%7Bimp_uid%7D)
-
-</div>
-
-<!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
-
-<!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
-
-<div class="hint" data-style="info">
-
-크레덴셜 중 **hashKey** 는 선택사항으로, KG이니시스에서 제공하는 모바일 금액위변조 방지 기능 사용을 원하실 경우 입력하시면 됩니다.
-
-</div>
-
-<!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
-
-1. [KG이니시스 가맹점관리자](http://iniweb.inicis.com/security/login.do) 접속 후 로그인을 합니다.
-
-2. \[상점정보]→\[계약정보]→\[부가정보]를 클릭합니다.
-
-3. 아래의 크레덴셜 값들을 확인합니다. 값이 표시되지 않는 경우 생성/갱신 버튼을 클릭해 주세요.
-
-   <ul>
-
-   <li>**웹결제 signkey 생성 조회**의 조회 버튼을 클릭하여 값을 확인할 수 있습니다.</li>
-   <li>**INIAPI key 생성 갱신**의 조회 버튼을 클릭하여 \[INIAPI KEY], \[INIAPI IV] 값을 확인할 수 있습니다.</li>
-
-   <!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
-
-   <li>**모바일 금액위변조 HashKey**의 조회 버튼을 클릭하여 값을 확인할 수 있습니다.</li>
-
-   <!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
-
-   </ul>
-
-(이미지 첨부: KG이니시스 가맹점관리자 내 크레덴셜 정보 조회 화면 1)
-
-4. INILite Key의 조회 버튼을 클릭하여 값을 확인할 수 있습니다.
-
-(이미지 첨부: KG이니시스 가맹점관리자 내 크레덴셜 정보 조회 화면 2)
-
-5. 포트원 콘솔에서 채널 추가 시 \[상점아이디]와 위 과정에서 발급받은 크레덴셜 값들을 입력한 후 `저장`을 클릭합니다.
-
-<!-- VERSION-SPECIFIC: V1 ONLY CONTENT START -->
-
-<div class="hint" data-style="warning">
-
-포트원 V1 결제모듈을 사용하시는 경우 KG이니시스로부터 전달받은 키파일을 별도로 등록해야 합니다. 키파일 등록과 관련하여 문의사항이 있는 경우 채널톡으로 문의해주세요.
-
-</div>
-
-<!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->

package/assets/docs/opi/ko/integration/ready/_components/integration-guide/kcp-v2.md

@@ -1,70 +0,0 @@
----
-title: 결제대행사별 연동 정보 확인하기 - NHN KCP (V2)
-targetVersions:
-  - v2
----
-
-<div class="hint" data-style="danger">
-
-포트원 V2에서 제공하는 KCP의 경우 **KCP의 PG-API방식**만 지원합니다. 따라서 아래와 같이 인증서 발급 후
-사용할 수 있습니다.
-
-해당 인증서의 경우 유효기간은 **5년**이며, 유효기간 만료 30일전부터 갱신이 가능합니다.
-
-**서비스 인증서의 유효기간이 만료되거나 폐기된 경우** 즉시 결제 승인/취소 등 관련
-**서비스 이용이 불가능**하오니
-서비스 사용을 위해서 인증서를 재발급이 필요한 후 **포트원에 저장된 채널 정보를 업데이트** 해야 합니다.
-
-</div>
-
-1. [KCP 파트너관리자](http://partner.kcp.co.kr/) 접속 후 로그인을 합니다.
-
-2. \[고객센터]→\[인증센터]→\[KCP PG-API]를 클릭합니다.
-
-   (이미지 첨부: NHN KCP 파트너관리자 내 \[고객센터] - \[PG-API 인증서] 예시 화면)
-
-3. KCP PG-API 발급 버튼을 클릭합니다.
-
-4. 파트너 관리자 비밀번호(로그인시 입력한 비밀번호)를 입력한 후 다음을 클릭합니다.
-
-   (이미지 첨부: \[PG-API 인증서] 발급시 \[파트너 관리자 비밀번호 입력] 화면)
-
-5. 사용할 개인키 비밀번호를 입력한 후 다음을 클릭합니다.
-
-   - 개인키 비밀번호를 분실하신 경우 확인이 불가함으로 폐기 후 재발급해야 합니다.
-
-   - 개인키를 폐기하는 즉시 기존에 사용하던 개인키와 서비스 인증서 사용이 불가능하며,
-     결제 승인/취소/조회가 불가능하오니 잘 보관하시길 바랍니다.
-
-   (이미지 첨부: \[PG-API 인증서] 발급시 \[개인키 비밀번호 등록] 화면)
-
-6. KCP PG-API 개인키 및 서비스 인증서 발급이 완료되면 로컬에 .zip 파일이 다운로드 됩니다.
-
-   - 서비스 인증서의 유효기간은 발급일로부터 5년으로, 유효기간 만료 30일전부터 갱신이 가능합니다.
-   - 서비스 인증서의 유효기간이 만료되었거나 폐기한 경우 원활한 서비스 사용을 위해 인증서를 재발급해주세요.
-
-   (이미지 첨부: \[PG-API 인증서] 발급 완료 화면)
-
-7. 로컬내에서 압축 풀면 `KCP_AUTH_{$사이트코드}_CERT.pem` 파일과 `KCP_AUTH_{$사이트코드}_PRIKEY.pem` 파일을 확인할 수 있습니다.
-
-8. 포트원 콘솔에서 채널 추가 시 \[MID(사이트코드)], \[PG-API 인증서키], \[PG-API 개인키], \[개인키 비밀번호]를
-   입력한 후 저장을 클릭합니다.
-
-9. 정기결제를 이용하시는 경우, 아래 절차를 진행해주세요.
-
-   1. [KCP 파트너관리자](http://partner.kcp.co.kr/) 접속 후 로그인을 합니다.
-   2. \[결제관리]→\[정기자동결제 그룹관리]→\[그룹등록]을 클릭합니다.
-   3. \[상점정보]→\[사이트코드]에서 그룹등록할 사이트코드를 선택합니다.
-   4. \[그룹정보]에서 \[유형3]을 선택한 후 원하는 그룹명을 입력합니다.
-   5. \[결제입력 정보]에서 \[결제유형] 및 \[납부유형]을 확인하시고 고객사 유형에 맞게 선택합니다.
-   6. \[고지방법]에서 원하시는 고지 방법을 선택한 후 \[등록하기]를 클릭합니다.
-
-   (이미지 첨부: KCP 파트너관리자 내 관리용 그룹등록 화면)
-
-   7. \[결제관리]→\[정기자동결제 그룹관리]→\[그룹조회]를 클릭합니다.
-   8. \[사이트코드]에서 사용한 사이트코드를 선택한 후 \[검색]을 클릭합니다.
-
-   (이미지 첨부: KCP 파트너관리자 내 관리용 그룹조회 화면)
-
-   9. 포트원 콘솔에서 채널 추가 시 앞서 발급한  \[MID(사이트코드)], \[PG-API 인증서키], \[PG-API 개인키],
-      \[개인키 비밀번호], \[정기자동결제 그룹아이디]를 입력한 후 \[저장]을 클릭합니다.

package/assets/docs/opi/ko/integration/ready/_components/integration-guide/paypal-v2.md

@@ -1,25 +0,0 @@
----
-title: 결제대행사별 연동 정보 확인하기 - 페이팔 (V2)
-targetVersions:
-  - v2
----
-
-1. [페이팔](http://www.paypal.com/) 접속 후 로그인을 합니다.
-
-2. \[Account settings]-\[Business information]을 클릭합니다.
-
-   (이미지 첨부: 페이팔 페이지 내 PayPal Merchant ID 조회 화면)
-
-3. 포트원 콘솔에서 채널 추가 시 \[PayPal Merchant ID]를 입력한 후 `저장`을 클릭합니다.
-
-   <div class="hint" data-style="info">
-
-   - 포트원에서 제공하는 페이팔 테스트용 계정으로 채널을 추가하신 경우, 테스트 결제 시 테스트용 구매자 계정을 이용하여 결제를 진행해야합니다.
-     [→ 테스트용 계정생성 바로가기](http://developer.paypal.com/dashboard/accounts)
-
-   - 판매자와 구매자 계정 국가가 모두 한국인 경우 페이팔 정책상 결제가 불가능합니다.
-     따라서 테스트용 구매자 계정 생성 시 Sandbox Accounts의 Country가 US인 Personal(구매자) 계정으로 생성하여 테스트를 해야합니다.
-
-   - 테스트 계정으로 결제 시 테스트용 카드정보를 참고하여 결제를 진행해야 합니다. [→ 테스트용 카드정보 바로가기](http://developer.paypal.com/api/rest/sandbox/card-testing/#link-creditcardgeneratorfortesting)
-
-   </div>

package/assets/docs/opi/ko/integration/ready/_components/integration-guide/tosspayments.md

@@ -1,15 +0,0 @@
----
-title: 결제대행사별 연동 정보 확인하기 - 토스페이먼츠 (신모듈)
-targetVersions:
-  - v1
-  - v2
----
-
-1. [토스페이먼츠 개발자센터](http://developers.tosspayments.com/) 접속 후 로그인을 합니다.
-2. \[내 개발정보]를 클릭합니다.
-3. \[API키] 메뉴에서 \[상점아이디(MID)]와 \[클라이언트키], \[시크릿키]를 확인합니다.
-4. API 버전은 `2022-07-27`로 설정해야합니다.
-
-(이미지 첨부: 토스페이먼츠 개발자센터 내 API 키 조회 화면)
-
-5. 포트원 콘솔에서 채널 추가 시 \[상점아이디(MID)]와 \[클라이언트키], \[시크릿키]를 입력한 후 `저장`을 클릭합니다.

package/assets/docs/opi/ko/integration/start/_components/sdk-installation.md

@@ -1,71 +0,0 @@
----
-title: V2 JavaScript SDK 설치하기
-description: 웹 브라우저에서 결제창 연동 시 사용되는 SDK 설치 방법을 안내합니다.
-targetVersions:
-  - v2
----
-
-포트원 V2 SDK는 npm 레지스트리와 CDN을 통해 배포되고 있습니다.
-
-- npm, yarn 등 패키지 매니저를 사용한다면 의존
-  대상으로 [@portone/browser-sdk](http://www.npmjs.com/package/@portone/browser-sdk)를 추가하세요.
-
-- 패키지 매니저를 사용하지 않는다면 `<script>` 요소를 이용하여 CDN에서 SDK를 직접 불러오세요.
-
-- CDN에서 ESM 모듈 형태로도 SDK를 제공하고 있습니다.
-
-<div class="tabs-container">
-
-<div class="tabs-content" data-title="패키지 의존 대상으로 추가">
-
-사용하는 패키지 매니저에 알맞은 명령어를 실행하세요.
-
-```shell
-npm i @portone/browser-sdk
-```
-
-```shell
-yarn add @portone/browser-sdk
-```
-
-```shell
-pnpm add @portone/browser-sdk
-```
-
-패키지 매니저로 SDK를 불러온 경우 `PortOne` 객체를 import해서 사용합니다.
-
-```javascript
-import * as PortOne from "@portone/browser-sdk/v2";
-```
-
-</div>
-
-<div class="tabs-content" data-title="<script> 요소로 추가">
-
-```html
-<script src="https://cdn.portone.io/v2/browser-sdk.js"></script>
-```
-
-`<script>` 요소로 SDK를 불러온 경우 전역 객체 `window`에 `PortOne` 객체가 추가됩니다.
-
-</div>
-
-<div class="tabs-content" data-title="ESM 모듈로 추가">
-
-ESM 모듈을 사용하는 경우 URL에서 `PortOne` 객체를 직접 import할 수 있습니다.
-
-```javascript
-import * as PortOne from "https://cdn.portone.io/v2/browser-sdk.esm.js";
-```
-
-</div>
-
-</div>
-
-<div class="hint" data-style="info">
-
-**타입스크립트 지원**
-
-포트원 V2 SDK는 타입스크립트 선언 파일(`.d.ts`)의 형식으로 타입 정보를 제공하고 있습니다. npm 레지스트리를 이용하는 경우 각종 개발 환경에서 별도 설정 없이 사용 가능합니다.
-
-</div>

package/assets/docs/sdk/ko/v2-sdk/_components/sdk-installation.md

@@ -1,71 +0,0 @@
----
-title: V2 JavaScript SDK 설치하기
-description: 웹 브라우저에서 결제창 연동 시 사용되는 SDK 설치 방법을 안내합니다.
-targetVersions:
-  - v2
----
-
-포트원 V2 SDK는 npm 레지스트리와 CDN을 통해 배포되고 있습니다.
-
-- npm, yarn 등 패키지 매니저를 사용한다면 의존
-  대상으로 [@portone/browser-sdk](https://www.npmjs.com/package/@portone/browser-sdk)를 추가하세요.
-
-- 패키지 매니저를 사용하지 않는다면 `<script>` 요소를 이용하여 CDN에서 SDK를 직접 불러오세요.
-
-- CDN에서 ESM 모듈 형태로도 SDK를 제공하고 있습니다.
-
-<div class="tabs-container">
-
-<div class="tabs-content" data-title="패키지 의존 대상으로 추가">
-
-사용하는 패키지 매니저에 알맞은 명령어를 실행하세요.
-
-```shell
-npm i @portone/browser-sdk
-```
-
-```shell
-yarn add @portone/browser-sdk
-```
-
-```shell
-pnpm add @portone/browser-sdk
-```
-
-패키지 매니저로 SDK를 불러온 경우 `PortOne` 객체를 import해서 사용합니다.
-
-```javascript
-import * as PortOne from "@portone/browser-sdk/v2";
-```
-
-</div>
-
-<div class="tabs-content" data-title="<script> 요소로 추가">
-
-```html
-<script src="https://cdn.portone.io/v2/browser-sdk.js"></script>
-```
-
-`<script>` 요소로 SDK를 불러온 경우 전역 객체 `window`에 `PortOne` 객체가 추가됩니다.
-
-</div>
-
-<div class="tabs-content" data-title="ESM 모듈로 추가">
-
-ESM 모듈을 사용하는 경우 URL에서 `PortOne` 객체를 직접 import할 수 있습니다.
-
-```javascript
-import * as PortOne from "https://cdn.portone.io/v2/browser-sdk.esm.js";
-```
-
-</div>
-
-</div>
-
-<div class="hint" data-style="info">
-
-**타입스크립트 지원**
-
-포트원 V2 SDK는 타입스크립트 선언 파일(`.d.ts`)의 형식으로 타입 정보를 제공하고 있습니다. npm 레지스트리를 이용하는 경우 각종 개발 환경에서 별도 설정 없이 사용 가능합니다.
-
-</div>