@portone/mcp-server 0.13.0

package/assets/docs/platform/ko/usages/partner.md

@@ -0,0 +1,115 @@
+---
+title: 파트너 예시
+description: ''
+---
+
+## 샘플 코드
+
+### Request
+
+<div class="tabs-container">
+
+<div class="tabs-content" data-title="Python">
+
+```py
+partner_payload = {
+"id": "partnerA", # 파트너 아이디
+"name": "파이썬 강사", # 파트너 이름 및 사업자명
+"email": "admin@portone.io",
+"businessRegistrationNumber": "1178178260", #파트너 사업자 등록번호. 필수는 아닙니다
+"account": {
+  "bank": "SHINHAN", # 파트너 계좌 은행. 국내 은행일경우 영문 대문자로 보내줘야 하며 이에대한 enum 값을 api문서에서 확인 가능합니다.
+  "currency": "KRW", # 계좌 입금 통화
+  "number": "10358907249", # 계좌 번호
+  "holder": "김포트" # 예금주
+},
+"defaultContractId": "contractA", # 해당 파트너에게 적용하길 원하는 대표계약
+"memo": "파트너 테스트 생성",
+"tags": [
+  "파이썬"
+]
+}
+
+headers = {
+'Authorization': f'PortOne ${PORTONE_API_SECRET}',
+'Content-Type': 'application/json'
+}
+
+partner_A = requests.post('https://api.portone.io/platform/partners/', headers=headers, json=partner_payload)
+```
+
+</div>
+
+<div class="tabs-content" data-title="Node">
+
+```js
+const axios = require("axios");
+const partnerPayload = {
+  id: "partnerA", // 파트너 아이디
+  name: "파이썬 강사", // 파트너 이름 및 사업자명
+  email: "admin@portone.io",
+  businessRegistrationNumber: "1178178260", // 파트너 사업자 등록번호. 필수는 아닙니다
+  account: {
+    bank: "SHINHAN", // 파트너 계좌 은행. 국내 은행일경우 영문 대문자로 보내줘야 하며 이에 대한 enum 값을 api문서에서 확인 가능합니다.
+    currency: "KRW", // 계좌 입금 통화
+    number: "10358907249", // 계좌 번호
+    holder: "김포트", // 예금주
+  },
+  defaultContractId: "contractA", // 해당 파트너에게 적용하길 원하는 대표계약
+  memo: "파트너 테스트 생성",
+  tags: ["파이썬"],
+};
+
+axios
+  .post("https://api.portone.io/platform/partners", partnerPayload, {
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `PortOne ${PORTONE_API_SECRET}`,
+    },
+  })
+  .then((response) => {
+    console.log(response.data);
+  })
+  .catch((error) => {
+    console.error("Error:", error.response.data);
+  });
+```
+
+</div>
+
+</div>
+
+### Response (snippet)
+
+<div class="tabs-container">
+
+<div class="tabs-content" data-title="snippet">
+
+```json
+{
+  "partner": {
+    "id": "partnerA",
+    "graphqlId": "NDpwYXJ0bmVyQQ==",
+    "name": "파이썬 강사",
+    "email": "admin@portone.io",
+    "businessRegistrationNumber": "1178178260",
+    "account": {
+      "bank": "SHINHAN",
+      "currency": "KRW",
+      "number": "10358907249",
+      "holder": "김포트",
+      "status": "VERIFIED" // 계좌 인증 상태
+    },
+    "status": "APPROVED",
+    "defaultContractId": "contractA",
+    "memo": "파트너 테스트 생성",
+    "tags": ["파이썬"],
+    "isHidden": false,
+    "appliedAt": "2023-08-11T11:19:58.829787Z"
+  }
+}
+```
+
+</div>
+
+</div>

package/assets/docs/platform/ko/using-ai-tools.md

@@ -0,0 +1,140 @@
+---
+title: AI 도구 활용하기
+description: AI 도구를 활용하여 쉽고 빠르게 포트원을 연동하세요. 연동 코드 작성은 물론, 24시간 언제나 관련 질의에 대한 답변을 받을 수 있습니다.
+targetVersions:
+  - v1
+  - v2
+---
+
+## 포트원 MCP (Model Context Protocol) 서버
+
+포트원은 쉬운 연동과 빠른 개발을 위해 MCP 서버를 제공합니다. [(GitHub 저장소 바로가기)](https://github.com/portone-io/mcp-server)
+
+포트원 MCP 서버는 개발자센터 문서 내용을 AI에게 제공하여,
+AI가 보다 정확하고 구체적인 정보를 바탕으로 사용자의 연동 및 질의를 돕도록 합니다.
+
+### 1. MCP 서버 등록하기
+
+포트원 MCP 서버를 사용하기 위해서는 먼저 사용하는 AI 도구에 서버를 등록해야 합니다.
+
+Cursor, Windsurf, Claude Code, Claude for Desktop 등 다양한 AI 도구의 설정 파일에서 아래 내용을 추가하여 MCP 서버를 등록할 수 있습니다.
+
+```json
+{
+  // ...
+
+  "mcpServers": {
+    // ...
+
+    "portone-mcp-server": {
+      "command": "uvx",
+      "args": ["portone-mcp-server@latest"]
+    }
+  }
+}
+```
+
+<div class="hint" data-style="info">
+
+사용 환경에 [uv](https://docs.astral.sh/uv/getting-started/installation/)가 설치되어 있어야 합니다.
+
+</div>
+
+설정 파일 수정이 완료된 후 AI 도구를 재시작하면 MCP 서버가 적용됩니다.
+
+#### 포트원 기능 사용하기
+
+MCP 서버에 포트원 기능을 연동하면, AI가 아래와 같은 작업을 수행할 수 있습니다.
+
+- 결제 내역 단건/다건 조회
+- 본인인증 내역 단건/다건 조회
+
+연동을 활성화하려면, MCP 설정 파일의 env 블록에 포트원 관리자 콘솔에서 발급받은 API\_SECRET을 추가합니다.
+
+```json
+{
+  // ...
+
+  "mcpServers": {
+    // ...
+
+    "portone-mcp-server": {
+      "command": "uvx",
+      "args": ["portone-mcp-server@latest"],
+      // 아래 env 블록을 추가하여 API 시크릿을 설정합니다.
+      "env": {
+        "API_SECRET": "<YOUR_PORTONE_API_SECRET>"
+      }
+    }
+  }
+}
+```
+
+<div class="hint" data-style="warning">
+
+**API 시크릿은 MCP 서버에서 제공하는 기능 외에도 포트원 REST API의 모든 권한을 가집니다.**
+
+내부의 인가된 인원만이 MCP 서버를 사용할 수 있도록 통제해야 합니다.
+
+</div>
+
+<div class="hint" data-style="warning">
+
+**MCP 서버는 포트원의 공개된 API 기능만을 사용하며, 인증을 위해 사용자가 제공한 API 시크릿을 활용합니다.**
+
+이 인증 과정은 전적으로 MCP 서버 내부에서 일어나므로, 언어 모델의 문제로 인해 비인가 사용자에게 기밀 정보가 유출되지는 않습니다.
+
+</div>
+
+<div class="hint" data-style="warning">
+
+**제3자 AI 서비스를 사용할 경우, API 응답(조회된 데이터 등)이 AI 서비스 측으로 전달되어 저장되거나 해당 서비스의 정책에 따라 모델 학습에 사용될 수 있습니다.**
+
+MCP 서버는 API 응답에 포함된 개인정보가 외부로 전달되지 않도록, 우선적으로 해당 정보를 식별 및 제거하는 보호 조치를 마련하고 있습니다.
+다만, 그 외의 정보는 AI 서비스의 운영 정책에 따라 일시적으로 저장되거나 처리될 수 있는 점을 유의해야 합니다.
+
+</div>
+
+### 2. MCP 서버 활용하기
+
+사용 중인 AI 도구에 포트원 MCP 서버가 적용되었다면, 아래 예시들과 같이 질의하여 사용할 수 있습니다.
+
+#### 개발 관련 프롬프트 예시
+
+- _"포트원 V2로 카카오페이 결제창 호출을 구현해줘"_
+- _"포트원 문서 읽고 V1 페이팔 결제창 호출하는 코드 작성해줘"_
+- _"포트원 V2 Python 서버 SDK 사용해서 결제건 조회하는 스크립트 작성해줘"_
+- _"Kotlin으로 포트원 V2 웹훅 검증하는 코드 작성해줘"_
+- _"Java로 포트원 서버 SDK 사용해서 포트원 V2 결제 연동하는 법 알려줘"_
+- _"포트원 파트너정산 자동화 서비스에 파트너 등록하는 코드를 타입스크립트로 구현해줘"_
+
+#### 전반적인 질의 예시
+
+- _"포트원 문서 읽고 V2와 V1의 차이점을 설명해줘"_
+- _"포트원 V2가 지원하는 PG사 목록 보여줘"_
+- _"포트원 API의 하위호환성 정책 설명해줘"_
+- _"포트원 파트너정산 자동화 서비스가 제공하는 기능들을 요약해줘"_
+
+## llms.txt 표준 지원
+
+포트원 개발자센터 웹사이트는 [llms.txt 표준](https://llmstxt.org)을 준수하며, LLM이 문서 정보를 쉽게 조회할 수 있도록 지원하고 있습니다.
+
+- [llms.txt](https://developers.portone.io/llms.txt): LLM을 위한 가이드 및 문서 목차를 포함합니다.
+- [llms-full.txt](https://developers.portone.io/llms-full.txt): llms.txt에 더해 모든 문서 내용을 추가로 포함합니다.
+- [llms-small.txt](https://developers.portone.io/llms-small.txt): llms.txt에 더해 모든 문서의 메타 정보만 추가로 포함합니다.
+
+llms.txt, llms-small.txt를 사용하는 AI 어시스턴트의 프롬프트에 포함하거나, llms-full.txt를 파일로 업로드해 질의하는 방식으로도 활용이 가능합니다.
+
+## LLM 전용 개발자센터 문서 디렉터리
+
+포트원 개발자센터 내 문서들을 마크다운 형식으로 담고 있는 LLM 전용 문서 디렉터리를 제공합니다.
+
+해당 디렉터리는 포트원 MCP 서버와 같은 포트원 관련 도구를 만드는 데 사용될 수 있으며,
+
+Cursor, Windsurf, Claude Code와 같이 코드베이스 맥락을 자동으로 분석하는 AI 도구를 사용하는 경우
+해당 디렉터리를 해당 도구로 열어 질의하는 방식으로도 활용하실 수 있습니다.
+
+이 경우 위 AI 도구들이 제공하는 임베딩 기반 색인과 RAG (Retrieval Augmented Generation) 검색이 자동적으로 적용되어
+일부 질의에 대해 보다 원활하게 원하는 결과를 얻으실 수 있습니다.
+
+(파일: LLM 전용 포트원 문서 디렉터리 다운로드)

package/assets/docs/release-notes/api-sdk/2023-04-24.md

@@ -0,0 +1,10 @@
+---
+releasedAt: 2023-04-24T00:00:00.000Z
+writtenAt: 2023-04-27T00:00:00.000Z
+---
+
+## 수정사항
+
+### ✔️ 비인증 결제에서 웹훅 재전송이 작동하지 않던 오류를 수정했습니다
+
+비인증 결제건의 웹훅 응답이 500으로 전송되는 경우, 1분 간격으로 최대 5회 웹훅이 재전송 됩니다.

package/assets/docs/release-notes/api-sdk/2023-05-08.md

@@ -0,0 +1,22 @@
+---
+releasedAt: 2023-05-08T00:00:00.000Z
+writtenAt: 2023-05-11T00:00:00.000Z
+---
+
+## 주요 업데이트 사항
+
+### ✔️ 결제내역 대용량 조회 API를 이용할 수 있습니다
+
+결제내역 대용량 조회 API를 통해 5만건 이상의 결제내역을 한 번에 조회할 수 있습니다. 1회 호출 시
+1,000건의 결제내역이 나타나며, 추가 호출을 통해 5만건 이상의 결제내역을 확인할 수 있습니다.
+
+본 기능 설정을 위한 자세한 내용은 관련 API 문서를 확인 바랍니다. [→ 결제내역 다건조회 API](https://developers.portone.io/api/rest-v2/payment?v=v2#get%20%2Fpayments-by-cursor)
+
+## 기타 수정사항
+
+### ✔️ 네이버페이 구매확정 API 에서 요청인을 설정할 수 있습니다
+
+기존 네이버페이 구매확정 시 admin(store)이 기본값으로 구현되어 있었으나, `/requester` 파라미터를
+추가하여 customer 로 구매확정할 수 있습니다.
+
+본 기능 설정을 위한 자세한 내용은 관련 API 문서를 확인 바랍니다. [→ \[결제형-네이버페이\] 에스크로 주문 확정 API](https://api.iamport.kr/)

package/assets/docs/release-notes/api-sdk/2023-05-12.md

@@ -0,0 +1,24 @@
+---
+releasedAt: 2023-05-12T00:00:00.000Z
+writtenAt: 2023-05-15T00:00:00.000Z
+---
+
+## 주요 업데이트 사항
+
+### ✔️ 스마트로의 새로운 결제모듈을 이용할 수 있습니다
+
+기존 결제모듈을 통해 제공되는 결제기능은 제한적이었으나, 이번 업데이트를 통해 이용 가능한 결제기능이
+대폭 확대되었습니다. 그럼, 새로운 스마트로 결제모듈의 주요 기능을 바로 소개합니다.
+
+- REST API 를 이용해 연동합니다
+- 기존에 발급된 연동키값(MID, 서명, 결제취소 비밀번호)을 그대로 새로운 결제모듈에서 이용할 수 있습니다
+- 정기결제를 지원합니다
+- 허브형 간편결제를 지원합니다
+- KRW, USD 결제를 지원합니다
+- 카드사 결제창 다이렉트 호출이 가능합니다
+- 에스크로 결제를 지원합니다
+- 에스크로 배송 정보를 수정할 수 있습니다
+- 면세 금액을 직접 설정할 수 있습니다
+- 회전식/고정식 가상계좌를 발급할 수 있습니다
+
+본 기능 설정을 위한 자세한 내용은 관련 API 문서를 확인 바랍니다. [→ 스마트로 PG 설정하기](https://developers.portone.io/docs/ko/pg/payment-gateway/smartro-v2/readme)

package/assets/docs/release-notes/api-sdk/2023-05-22.md

@@ -0,0 +1,46 @@
+---
+releasedAt: 2023-05-22T00:00:00.000Z
+writtenAt: 2023-05-25T00:00:00.000Z
+---
+
+## 주요 업데이트 사항
+
+### ✔️ 페이팔 정기결제를 이용 가능합니다
+
+기존에 해외 정기결제를 연동하기 위해서는 페이먼트월이 유일한 선택지였지만 이번 업데이트를 통해 보다 다양한 선택지를 제공합니다.
+그럼, 페이팔 정기결제를 이용하기 위한 주요 절차를 소개합니다.
+
+- 포트원 SDK 1.3.0 부터 빌링키를 발급할 수 있습니다
+
+- 빌링키 발급을 위해서는 포트원의 페이팔 파트너 계정으로 사전에 등록해야 합니다
+  - 기존 페이팔 SPB 를 이용 중인 고객은 바로 이용 가능합니다
+
+- 결제창 호출을 위해서는 페이팔 SPB 버튼 렌더링이 필요합니다
+
+본 기능 설정을 위한 자세한 내용은 관련 API 문서를 확인 바랍니다.
+[→ 페이팔 RT 빌링키 발급 연동가이드 바로가기](https://developers.portone.io/docs/ko/pg/payment-gateway/rt)
+
+<br />
+
+### ✔️ 네이버페이(결제형)을 이용 중인 경우, 모바일 결제창이 표시됩니다
+
+네이버페이의 업데이트에 따라, 네이버페이(결제형)을 이용 중인 경우 PC에서 결제창 호출 시 모바일 UI의 결제창이 표시되도록 수정했습니다.
+또한 결제창 호출 시, 열린 웹페이지의 전체화면으로 결제창이 표시됩니다.
+
+전체화면이 아닌 팝업으로 결제창을 나타나도록 하기 위해서는 `naverPopupMode` 파라미터 설정이 필요합니다.
+
+본 기능 설정을 위한 자세한 내용은 관련 API 문서를 확인 바랍니다.
+[→ 네이버페이(결제형) 팝업 모드 설정하기](https://developers.portone.io/docs/ko/pg/simple/naver)
+
+<br />
+
+### ✔️ 워드프레스 우커머스를 통해 네이버페이(주문형)을 이용 중인 경우, 구매자의 배송지 변경 사항이 자동 반영됩니다
+
+이번 업데이트를 통해 우커머스에서 배송지 정보를 간편하게 확인할 수 있습니다.
+
+구매자가 배송지 변경 시 주문 건의 \[상세정보] - \[상태] 항목은 ‘배송지 변경’으로 표시되며, \[배송] 항목에서 변경된 배송지를 확인할 수 있습니다.
+이와 함께 \[주문 메모]에 변경 내역이 기록됩니다.
+
+본 기능 이용을 위해서는 아임포트 우커머스 플러그인 `2.2.36` 버전으로 업데이트하시기 바랍니다.
+
+(관련 이미지 첨부)

package/assets/docs/release-notes/api-sdk/2023-05-25.md

@@ -0,0 +1,15 @@
+---
+releasedAt: 2023-05-25T00:00:00.000Z
+writtenAt: 2023-05-31T00:00:00.000Z
+---
+
+## 주요 업데이트 사항
+
+### ✔️ 우리카드 독자 결제망을 이용할 수 있습니다
+
+우리카드가 독자 결제망을 구축함에 따라 우리카드 결제건의 매입도 우리카드를 통해 실행됩니다.\
+이러한 변경은 5월 26일부터 발급되는 모든 우리카드에 적용됩니다.
+
+이번 업데이트를 통해 우리카드 결제창을 다이렉트 호출할 수 있습니다.
+우리카드 결제 건에 대해 관리자콘솔에서 결제내역 조회 시, 결제수단에서 바로 '우리카드'로 구별할 수 있으며
+API 결제내역 조회 시 카드사 코드번호(금융결제원 표준코드번호) '041' 로 구별할 수 있습니다.

package/assets/docs/release-notes/api-sdk/2023-06-19.md

@@ -0,0 +1,20 @@
+---
+releasedAt: 2023-06-19T00:00:00.000Z
+writtenAt: 2023-06-21T00:00:00.000Z
+---
+
+## 주요 업데이트 사항
+
+### ✔️ KG이니시스를 통해 애플페이를 이용할 수 있습니다
+
+KG이니시스 간편결제수단으로 애플페이를 이용할 수 있습니다. 이번 업데이트를 통해 포트원은 토스, KCP, KG이니시스, 총 3개 PG사를 통해 애플페이를 지원합니다.
+
+기존에 KG이니시스를 이용 중이라면 결제수단 추가 계약을 통해 애플페이를 연동할 수 있습니다. 하단의 일반
+문의 채널을 통해 관련 문의를 남겨주시면 포트원 고객지원팀이 안내드리겠습니다.
+
+### ✔️ 기타 수정사항
+
+- 블루월넛 가상계좌 만료일자가 실제 만료일자로 저장됩니다
+- 엑심베이 결제 취소 안내 메일이 결제시 설정된 언어로 발송됩니다
+- 페이먼트월 결제대기(pending) 단계에서 결제실패로 웹훅이 발송되던 오류를 수정했습니다
+- 카카오페이 이용시 `partner_user_id`를 고객 식별 파라미터로 설정 가능합니다

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

@@ -0,0 +1,26 @@
+---
+releasedAt: 2023-07-03T00:00:00.000Z
+writtenAt: 2023-07-05T00:00:00.000Z
+---
+
+## 주요 업데이트 사항
+
+### ✔️ (구)토스페이먼츠 SDK(결제창) 결제 요청 시 아이패드 기기에서 모바일 환경의 결제창이 표시됩니다
+
+iOS13 이후 아이패드 기기에서 결제 요청 시 PC 환경의 결제창이 표시되어 결제가 정상적으로 진행되지
+않았습니다. 이번 업데이트를 통해 아이패드에서도 모바일 환경의 결제창이 표시되어 정상적으로 결제를
+진행할 수 있습니다.
+
+### ✔️ 헥토파이낸셜 빌링키 발급을 위한 API를 이용할 수 있습니다
+
+기존 헥토파이낸셜의 경우 API를 통한 빌링키 발급 요청 시 결제가 함께 진행되었으나, 이번 업데이트를 통해 결제 없이 빌링키만 독립적으로 발급할 수 있습니다.
+
+본 기능 사용을 위한 자세한 내용은 관련 연동가이드를 확인 바랍니다. [→ 헥토파이낸셜 빌링키 발급 요청하기](https://developers.portone.io/docs/ko/pg/payment-gateway/settle/readme)
+
+## 기타 수정사항
+
+### ✔️ KG모빌리언스를 통해 신용카드 결제를 이용할 수 있습니다
+
+KG모빌리언스와 계약을 통해 새로운 결제수단으로 신용카드를 이용할 수 있습니다. 하단의 일반 문의 채널을 통해 관련 문의를 남겨주시면 포트원 고객지원팀이 안내드리겠습니다.
+
+본 기능 설정을 위한 자세한 내용은 관련 연동가이드를 확인 바랍니다. [→ KG모빌리언스](https://developers.portone.io/docs/ko/pg/payment-gateway/kg)

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

@@ -0,0 +1,35 @@
+---
+releasedAt: 2023-07-10T00:00:00.000Z
+writtenAt: 2023-07-12T00:00:00.000Z
+---
+
+## 주요 업데이트 사항
+
+### **결제 모듈 V1**✔️ 나이스페이먼츠의 새로운 결제창을 이용할 수 있습니다
+
+포트원을 통해 나이스페이먼츠의 새로운 결제창(이하 ‘(신) 나이스페이먼츠’)을 이용할 수 있습니다. 이번
+업데이트를 통해 기존 모듈보다 확장된 결제수단을 제공하며, 모든 간편결제에 대해 허브형과 다이렉트
+호출을 지원합니다.
+
+(신) 나이스페이먼츠에서 이용 가능한 간편결제는 다음과 같습니다.
+
+- 카카오페이
+- 네이버페이
+- 페이코
+- 삼성페이
+- 11Pay (구.SKPay)
+- SSG Pay
+- L Pay
+- 애플페이
+
+이 외에도 SDK/API 빌링키 발급, 에스크로, API 가상계좌 발급 및 회수, 면세 및 부가세 금액 지정(영세율 포함), 상점분담무이자 등의 기능을 지원합니다.
+
+(신) 나이스페이먼츠 이용시 고려해야 하는 조건들이 있으니 다음 문서를 참고하시기 바랍니다.
+
+[→ (신)나이스페이먼츠 일반결제 연동 유의사항](https://developers.portone.io/docs/ko/pg/payment-gateway/nice-v2/payment-caution)
+
+[→ (신)나이스페이먼츠 비인증결제 연동 유의사항(빌링키 발급 및 API 연동)](https://developers.portone.io/docs/ko/pg/payment-gateway/nice-v2/billing-api-caution)
+
+기존에 나이스페이먼츠를 이용 중이라면 간편결제사와 별도의 계약없이 간단한 신청만으로 간편결제를
+이용할 수 있습니다. 하단의 일반 문의 채널을 통해 관련 문의를 남겨주시면 포트원 고객지원팀이
+안내드리겠습니다.

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

@@ -0,0 +1,31 @@
+---
+releasedAt: 2023-07-17T00:00:00.000Z
+writtenAt: 2023-07-19T00:00:00.000Z
+---
+
+## 주요 업데이트 사항
+
+### **결제 모듈 V1**✔️ KCP를 통해 PC환경에서 애플페이 허브형과 다이렉트형을 이용할수 있습니다
+
+기존에 KCP를 통해 애플페이를 이용하기 위해서는 모바일 환경에서만 가능했지만,
+이번 업데이트를 통해 PC환경에서 애플페이 허브형과 다이렉트형을 모두 지원합니다.
+
+### **결제 모듈 V1**✔️ PG MID 복수조회 API (`GET /users/pg`) 호출시 `channel_name`과 `channel_key`를
받아볼 수 있습니다
+
+API를 통해 PG 설정 정보 호출시 channel\_name과 channel\_key 응답을 받아볼 수 있습니다.
+
+본 기능 설정을 위한 자세한 내용은 관련 API 문서를 확인 바랍니다.
+[→ PG MID 복수조회 API 호출하기](https://developers.portone.io/docs/ko/api/miscellaneous-api/pg/pg-mid-api)
+
+<br />
+
+## 기타 수정사항
+
+### **결제 모듈 V1**✔️ 네이버페이 웹훅 수신 시점에 거래 취소시 콜백을 수신합니다
+
+웹훅 우선순위 설정 후 네이버페이 결제시, 웹훅 수신 포인트에서 결제상태가 결제취소여도 콜백을 수신합니다.
+
+### **결제 모듈 V1**✔️ 페이먼트월 취소 요청 시점에 고객사 웹훅을 호출하지 않습니다
+
+기존에는 결제 취소 요청시 즉시 결제상태가 변경되는 웹훅이 전송되어 잘못된 결제상태를 수신하는 문제가 있었으나,
+이번 업데이트를 통해 페이먼트월 결제 취소 요청시 콜백을 수신하는 시점에 결제상태를 결제취소로 변경합니다.

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

@@ -0,0 +1,14 @@
+---
+releasedAt: 2023-07-31T00:00:00.000Z
+writtenAt: 2023-07-31T00:00:00.000Z
+---
+
+## 주요 업데이트 사항
+
+### **결제 모듈 V1**✔️ KCP 결제창 내 할인쿠폰 적용 여부 파라미터 기능 추가
+
+KCP 인증결제창에서 할인쿠폰 적용 여부를 컨트롤 할수 있는 파라미터가 추가되었습니다.
+할인쿠폰기능을 사용하기 위해서는 KCP와 협의가 먼저 선행되어야 하는점 유의하세요
+
+본 기능 설정을 위한 자세한 내용은 SDK 가이드 문서를 확인 해주세요
+[→ KCP SDK 연동가이드 확인하기](https://developers.portone.io/docs/ko/pg/payment-gateway/nhn-kcp#4-%EA%B8%B0%ED%83%80-%ED%8C%8C%EB%9D%BC%EB%AF%B8%ED%84%B0)

package/assets/docs/release-notes/api-sdk/2023-08-31.md

@@ -0,0 +1,29 @@
+---
+releasedAt: 2023-09-01T00:00:00.000Z
+writtenAt: 2023-09-01T00:00:00.000Z
+---
+
+## 주요 업데이트 사항
+
+### **결제 모듈 V1**✔️ 엑심베이 브라우저 팝업 차단 해제 문구 default 언어를 영문으로 변경
+
+엑심베이는 해외결제를 지원하는 PG사이기에 글로벌 언어인 영어로
+팝업차단 해제 문구가 고객에게 안내되도록 변경하였습니다.
+
+### **결제 모듈 V1**✔️ NHN KCP 빌링키 발급 시 주민등록입력/생년월일 파라미터로 노출 여부
+
+NHN KCP결제창을 통한 빌링키 발급시 파라미터를 통해 빌링키 발급을 위한 정보입력 과정에서 필요한 항목중 개인정보에 해당되는 주민등록번호/생년월일 항목을
+선택할수 있도록 하였습니다.
+
+본 기능 설정을 위한 자세한 내용은 SDK 가이드 문서를 확인 해주세요
+[→ KCP SDK 연동가이드 확인하기](https://developers.portone.io/docs/ko/pg/payment-gateway/nhn-kcp#4-%EA%B8%B0%ED%83%80-%ED%8C%8C%EB%9D%BC%EB%AF%B8%ED%84%B0)
+
+### **결제 모듈 V1**✔️ 결제 URL 생성 API 지원 PG사 확대
+
+이번 업데이트를 통해 아래 PG사도 결제 URL 생성 API를 통해 결제를 발생시킬수 있게되었습니다.
+
+- (신)토스페이먼츠
+- (신)스마트로
+- KSNET
+- (신)페이팔 일반결제/정기결제
+- (신)나이스페이먼츠

package/assets/docs/release-notes/api-sdk/2023-12-15.md

@@ -0,0 +1,12 @@
+---
+releasedAt: 2023-12-15T00:00:00.000Z
+writtenAt: 2023-12-15T00:00:00.000Z
+---
+
+## 주요 업데이트 사항
+
+### **결제 모듈 V1**✔️ (신) 토스페이먼츠 SDK(결제창) 빌링키 발급 시 결제창 백그라운드 변경
+
+기존에는 토스페이먼츠 결제창의 백그라운드가 모서리 부분에만 표시되었으나 결제창 호출 시 전체 백그라운드를 동일한 색상으로 처리하여 깔끔하게 표시되도록 하였습니다.
+
+(관련 이미지 첨부)

package/assets/docs/release-notes/api-sdk/2024-01-08.md

@@ -0,0 +1,36 @@
+---
+releasedAt: 2024-01-08T00:00:00.000Z
+writtenAt: 2024-01-08T00:00:00.000Z
+---
+
+## 주요 업데이트 사항
+
+### **결제 모듈 V2**✔️ 포트원 V2 신모듈에서 나이스페이먼츠 결제를 지원합니다.
+
+이제 포트원 V2를 통해 나이스페이먼츠 일반결제/정기결제가 가능합니다. 이번 업데이트를 통해 다양한 결제수단을 제공하며, 모든 간편결제에 대해 허브형과 다이렉트 호출을 지원합니다.
+
+나이스페이먼츠에서 지원하는 결제수단 아래와 같습니다.
+
+- 카드
+
+- 실시간 계좌이체
+
+- 가상계좌 (회전식/고정식)
+
+- 휴대폰 소액결제
+
+- 상품권 (컬쳐랜드)
+
+- 간편결제 (허브형/다이렉트)
+  - 카카오페이
+  - 네이버페이
+  - 페이코
+  - 삼성페이
+  - 애플페이
+  - 11Pay (구.SKPay)
+  - SSGPay
+  - LPay
+
+이 외에도 SDK/API 빌링키 발급, 에스크로, API 가상계좌 발급 및 말소, 면세 및 부가세 금액 지정(영세율 포함), 상점분담무이자 등의 기능을 지원합니다.
+
+나이스페이먼츠 연동에 대해 자세히 알고 싶다면 [→ 나이스페이먼츠 연동가이드](https://developers.portone.io/docs/ko/v2-payment/pg/nice-v2?v=v2) 에서 확인하실 수 있습니다.

package/assets/docs/release-notes/api-sdk/2024-01-11.md

@@ -0,0 +1,18 @@
+---
+releasedAt: 2024-01-11T00:00:00.000Z
+writtenAt: 2024-01-11T00:00:00.000Z
+---
+
+## 주요 업데이트 사항
+
+### **결제 모듈 V1**✔️ 토스페이 정기결제 이용이 가능합니다.
+
+기존에는 토스페이 일반결제만 지원하였으나 이번 업데이트를 통해 토스페이 일반결제와 정기결제를
+이용하실 수 있습니다. 그럼, 토스페이 정기결제를 이용하기 위한 주요 절차를 소개합니다.
+
+- 포트원 SDK 1.3.0 부터 빌링키 발급 및 정기결제를 사용할 수 있습니다.
+- 토스페이 일반결제 / 정기결제를 사용하시려면 (신)토스페이(tosspay\_v2)로 연동해야 합니다.
+- (신)토스페이 결제 시 카드결제, 계좌결제를 지정할 수 있습니다.
+
+(신)토스페이 연동에 대해 자세히 알고 싶다면
+[→ (신)토스페이 연동가이드](https://developers.portone.io/docs/ko/pg/simple/tosspay-v2/readme?v=v1) 에서 확인하실 수 있습니다.

package/assets/docs/release-notes/api-sdk/2024-01-25.md

@@ -0,0 +1,35 @@
+---
+releasedAt: 2024-01-24T00:00:00.000Z
+writtenAt: 2024-01-25T00:00:00.000Z
+---
+
+## 주요 업데이트 사항
+
+### **결제 모듈 V1**✔️ 네이버페이 결제형에서 10원부터 결제할 수 있습니다.
+
+네이버페이 결제형의 기존 최소주문금액 100원이었으나, 10원으로 수정되었습니다.
+
+### **관리자 콘솔**✔️ 가상계좌 발급취소/말소 API를 이용하여 가상계좌를 말소한 경우 결제실패로
분류되어 표시됩니다.
+
+가상계좌 발급 후 입금 전에 API를 이용해 가상계좌를 말소한 경우, 관리자콘솔 \[결제 상세 내역 조회]에서
+결제실패로 분류됩니다. 가상계좌 말소 건은 엑셀 다운로드시 실패 상세 항목에 **계좌말소**로 표시되어
+구분할 수 있습니다.
+
+### **관리자 콘솔**✔️ 엑셀 내의 `PG계정` 컬럼명이 `PG상점아이디(MID)` 로 변경되었습니다.
+
+\[결제 상세 내역 조회]에서 엑셀 다운로드시 기존에 PG계정으로 표시되던 컬럼명이 **PG상점아이디(MID)** 로 표시됩니다.
+
+<br />
+
+## 기타 수정사항
+
+### **결제 모듈 V1**✔️ Microsoft Edge 브라우저에서 adblock extension과 충돌하는 현상이 수정되었습니다.
+
+Microsoft Edge 브라우저 환경에서 결제 모듈 호출 시 adblock extension과 충돌을 일으켜 결제창이
+정상적으로 호출되지 않는 현상이 간헐적으로 발생하였으나 현재는 수정되어 정상적으로 호출이
+가능합니다.
+
+### **결제 모듈 V1**✔️ (신) 페이팔 결제 요청 시 컨텐츠 상품인 경우 배송지 입력란이 표시되지 않습니다.
+
+기존에는 디지털 상품인 경우에도 배송지 입력란이 표시되었으나 결제 요청 시 `digital:true`로
+입력한 경우 청구주소로 배송 체크박스 및 상세 주소 입력 칸이 표시되지 않습니다.