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

package/assets/docs/release-notes/api-sdk/2024-09-27.md

@@ -14,7 +14,7 @@ PG 거래대사 내의 **거래 정산 내역** 메뉴에서 정산일 또는
 
 ### **PG 거래대사**✔️ KSNET, KPN, 하이픈에서 발생한 거래 건도 PG 거래대사에서 데이터 확인이 가능해집니다.
 
-기존에 12개 PG사 (KCP, KG이니시스, 나이스페이먼츠, 토스페이, 네이버페이, 다날, 페이코, (구)토스페이먼츠,
+기존에 12개 PG사 (KCP, KG이니시스, 나이스정보통신, 토스페이, 네이버페이, 다날, 페이코, (구)토스페이먼츠,
 토스페이먼츠, 카카오페이, 엑심베이, 헥토파이낸셜) 에서만 지원하던 **PG 거래대사**가 KSNET, KPN, 하이픈까지 확장하여
 총 15개 PG사 데이터에 한하여 제공됩니다.
 

package/assets/docs/release-notes/console/2025-10-17.md

@@ -0,0 +1,47 @@
+---
+releasedAt: 2025-10-17T00:00:00.000Z
+writtenAt: 2025-10-17T00:00:00.000Z
+---
+
+## 콘솔 일부 설정 업데이트 안내
+
+안녕하세요, 포트원 입니다.
+
+더욱 쾌적하고 편리한 서비스 이용을 위해, 콘솔 내의 일부 디자인 시스템이 변경되어 안내해 드립니다.
+
+---
+
+## 관리자 콘솔
+
+### 표설정 기능 업데이트
+
+기존에는 콘솔에서 확인할 수 있는 다양한 표 내부 컬럼의 순서를 변경할 수 없었습니다. 하지만 이번 업데이트를 통해 표설정 기능을 추가하여 드래그 방식으로 손쉽게 내부 컬럼의 순서를 변경하고, 유지할 수 있습니다. 표설정 기능을 활용하여 더 중요한 정보들을 앞으로 가져오는 등의 편리한 커스터마이징이 가능합니다.
+
+파트너 정산 서비스 뿐만 아니라 포트원 전자결제를 함께 이용중이라면, 전자결제 서비스의 표 설정 또한 브라우저에 저장될 수 있습니다.
+
+(이미지 첨부: 표 순서 변경 기능)
+
+## 파트너 정산
+
+### 보관함 설정 업데이트
+
+기존 정산 정책 관리 및 파트너 관리 페이지에서 보관함 보기 토글을 이용하여 보관함을 조회한 후, 페이지를 새로고침하면 보관함이 아닌 일반 정책 목록이 조회되는 현상이 발생했습니다. 업데이트 후에는 보관함 보기 상태로 새로고침을 해도 해당 상태가 풀리지 않고 유지되어 사용 편의성이 높아집니다.
+
+### 파트너 관리 UI 업데이트
+
+기존 파트너 관리 페이지의 계약 일괄 변경 페이지에서는 변경할 신규 계약과 정산 시작일 기준 적용 시점만을 선택해야 했고, 계약 아이디로만 계약을 관리했기 때문에 실제 계약 정보 확인 없이 작업을 진행해야 하는 불편함이 있었습니다.
+
+이제부터는 계약 이름으로 변경할 계약 정보를 직접 검색 및 조회할 수 있게 됩니다. 계약을 선택하면 중개 수수료율, 정산 보류일, 정산 주기와 같은 주요 정산 정보를 즉시 확인할 수 있어 더 정확한 계약 변경이 가능해집니다. 아울러, 정산 시작일 기준 적용 시점을 선택할 때 사용되는 달력 UI도 직관적으로 변경되어 적용 시점 설정이 더욱 쉬워졌습니다.
+
+(이미지 첨부: 파트너 관리 UI 업데이트)
+
+### 콘솔 표 설정 업데이트
+
+정산 상세 조회, 정산 내역 관리, 일괄 지급 내역 관리, 지급 내역 관리, 이체 내역 관리, 일괄 이체 내역 관리, 세금계산서 작성 목록, 세금계산서 내역 관리, 일괄 세금계산서 내역 관리 페이지의 표 설정이 일괄 변경됩니다. 이제 해당 페이지들에서 표(테이블)의 필터 값을 설정한 후 페이지를 새로고침하더라도, 설정했던 필터 값이 초기화되지 않고 그대로 유지됩니다. 따라서 반복적으로 필터를 재설정할 필요 없이 더 빠르고 효율적으로 데이터를 조회할 수 있습니다.
+
+---
+
+작성일자: **2025년 10월 17일**
+
+- 일반 문의: <cs@portone.io> / 채널톡
+- 기술지원 문의: <support.b2b@portone.io> / 파트너스 슬랙 채널

package/assets/docs/release-notes/platform/2025-03-17.md

@@ -27,7 +27,7 @@ writtenAt: 2025-03-17T00:00:00.000Z
 - 기존 파트너정산자동화 제품을 이용하고 계신 고객이더라도, 세금계산서 역발행 기능 사용을 위해서는 별도 문의가 필요합니다.
 
 - 세금계산서 상태변화 웹훅 및 사업자번호 기업정보조회 API 연동이 필요하신 고객사는
-  [📩 support.b2b@portone.io](mailto:support.b2b@portone.io)로 문의해 주세요.
+  [📩 tech.support@portone.io](mailto:tech.support@portone.io)로 문의해 주세요.
 
 포트원의 전체 업데이트 소식은 [개발자센터 릴리즈노트](https://developers.portone.io/release-notes) 페이지에서 확인할 수 있습니다.
 

package/assets/docs/release-notes/platform/2025-07-07.md

@@ -52,4 +52,4 @@ writtenAt: 2025-07-07T00:00:00.000Z
 
 일반 문의 <cs@portone.io> / 채널톡
 
-기술지원 문의 <support@portone.io> / 파트너스 슬랙 채널
+기술지원 문의 <tech.support@portone.io> / 파트너스 슬랙 채널

package/assets/docs/release-notes/platform/2025-07-23.md

@@ -0,0 +1,85 @@
+---
+releasedAt: 2025-07-23T00:00:00.000Z
+writtenAt: 2025-07-23T00:00:00.000Z
+---
+
+안녕하세요, 파트너 정산 자동화 팀입니다.
+
+2025년 7월 23일 업데이트 사항을 확인해 보세요.
+
+|**업데이트 항목**                       |**변경 전**                                               |**변경 후**                                             |
+|:---------------------------------------|:---------------------------------------------------------|:-------------------------------------------------------|
+|**세금계산서 API 출시**                 |세금계산서 기능을 콘솔에서만 이용                         |**API 제공으로 시스템 연동 및 자동화 가능**             |
+|**세금계산서 정발행 기능 (API) 추가**   |역발행만 가능                                             |**정발행 및 역발행 모두 지원 (API)**                    |
+|**정산 정책 관리 사용성 개선**          |정책 수정사항 확인 불가                                   |**정책 수정 히스토리 조회 가능**                        |
+|**정산 상세 조회 내 필터 개선**         |수기 정산 건 조회 어려움<br />새로고침 시 필터 조건 초기화|**정산일 기준으로 조회<br />새로고침 시 필터 조건 유지**|
+|**파트너 정산 자동화 제품 UI 색상 변경**|오렌지 컬러                                               |**블루 컬러**                                           |
+
+## API 출시 안내
+
+## 세금계산서 API 출시
+
+이제 파트너정산 세금계산서 기능을 **콘솔이 아닌 API**로도 이용하실 수 있습니다.
+
+API를 활용하면 각 기업의 자체 서비스, 백오피스, 외부 시스템과의 연동을 통해 세금계산서 발행, 조회, 관리 등 다양한 업무를 **완전 자동화**할 수 있어, 반복적인 수기 업무의 부담을 크게 줄이고 효율적인 업무 처리가 가능합니다.
+
+## 세금계산서 정발행 기능 (API) 추가
+
+기존에는 ‘역발행’만 지원하였으나, 이번 업데이트로 **‘정발행’** 기능이 API에도 포함되었습니다.
+
+기업간 거래 상황에 따라 어떤 발행 방식이든, 이제는 포트원 하나로 발행 및 관리가 모두 가능해집니다.
+정발행 기능의 콘솔 지원도 2025년 3분기 내 업데이트 예정이니 많은 기대 부탁드립니다.
+
+**기술 변경 사항 안내**
+신규 세금계산서 API 카테고리 및 상세 문서가 [**개발자센터**](https://developers.portone.io/api/rest-v2/b2b.taxInvoice?v=v2) 에 추가되었습니다.
+기존 콘솔 UI 기반의 역발행 외에, 정발행 기능이 API로 제공됩니다.
+연동 개발 시 개발자센터의 세금계산서 관련 문서를 참고해주시기 바랍니다.
+
+---
+
+## 파트너 정산 자동화 제품 개선 안내
+
+### 정산 정책 관리 사용성 개선
+
+정산 정책 관리 페이지의 사용성이 개선되었습니다.
+
+- 페이지 사용성 개선
+
+  계약 등록 및 상세 조회, 할인 분담 정책 등록 및 상세 조회, 추가 수수료 정책 등록 및 상세 조회 등 정산 정책 관리 내의 다양한 페이지의 사용성이 개선되었습니다.
+
+- 계약 내용 수정 이력 조회 기능 추가
+
+  계약 관리 페이지에서 계약 내용 수정 시, 수정 사항을 확인할 수 있는 히스토리 조회 기능이 추가되었습니다.\
+  이제 계약 상세 페이지에서 변경 이력을 확인할 수 있어 더 효율적이고 투명한 계약 관리가 가능합니다.
+
+(관련 이미지 첨부)
+
+### 정산 상세 조회 내 필터 개선
+
+정산 상세 조회 페이지에서 더욱 편리하게 정산 내역을 확인하실 수 있도록 필터 기능이 개선되었습니다.
+
+- 기본 조회 기준 변경
+
+  정산 건 조회 시 기본 조회 기준이 기존 '정산 기준일'에서 '정산일'로 변경되었습니다.
+  정산 시작일이 설정되지 않은 수기 정산 건도 쉽게 조회할 수 있습니다.
+
+- 기본 조회 기간 확대
+  기존 30일 → 90일로 확대되어 더 넓은 범위의 데이터를 한 번에 확인하실 수 있습니다.
+
+- 필터 조건 유지 및 버그 수정
+
+  정산 건을 검색할 때 미리 지정한 필터값이 해제되던 버그가 수정되었으며,
+  이제 페이지를 새로 고침 시에도 이전에 설정한 필터 조건이 그대로 유지됩니다.
+
+(관련 이미지 첨부)
+
+### 파트너 정산 자동화 제품 사용자 인터페이스 색상 변경
+
+파트너 정산 자동화 제품의 전반적인 사용자 인터페이스 색상이 기존 오렌지에서 블루로 변경되었습니다.
+
+---
+
+작성일자: **2025년 07월 23일**
+
+- 일반 문의: <cs@portone.io> / 채널톡
+- 기술지원 문의: <tech.support@portone.io> / 파트너스 슬랙 채널

package/assets/docs/release-notes/platform/2025-08-13.md

@@ -0,0 +1,95 @@
+---
+releasedAt: 2025-08-13T00:00:00.000Z
+writtenAt: 2025-08-13T00:00:00.000Z
+---
+
+안녕하세요, 파트너 정산 자동화 팀입니다.
+
+2025년 8월 13일 업데이트 사항을 확인해 보세요.
+
+---
+
+## 정산 내역서 발송 기능 업데이트
+
+이제, 파트너 정산 콘솔에서 생성된 정산 내역을 기반으로, 파트너에게 정산 내역서를 보낼 수 있습니다.
+
+일괄지급 내역 상세 및 지급 내역 관리 페이지에서 원하는 정산 내역을 단건, 혹은 다건으로 선택하여 한 번에 정산내역서 이메일을 발송할 수 있습니다.
+
+**발신자/수신자 설정**: 발신자 이메일 설정은 필수이며, 도메인 인증을 통해 도메인을 활용한 발신이 가능합니다. 인증 완료된 도메인이 없는 경우, 기본 메일 <no-reply@portone.io>로 정산내역서를 발송할 수 있습니다.
+
+수신자 이메일은 등록해 둔 파트너의 담당자 이메일로 지정되고, 담당자 이메일을 수정하는 것으로 수신자 이메일을 수정할 수 있습니다. 모든 설정을 완료하고, '정산내역서 발송' 버튼을 클릭하면 선택된 지급 내역의 파트너 전체에게 이메일이 차례대로 발송됩니다.
+
+(관련 이미지 첨부)
+
+---
+
+## 정산 내역서 템플릿 생성 및 수정
+
+정산 내역서 템플릿을 자유롭게 생성하고, 수정할 수 있습니다.
+
+정산내역서 템플릿 관리 페이지에서 템플릿을 다양하게 만들어 관리할 수 있습니다. 지급 내역 생성 여부와 관계없이 템플릿을 생성할 수 있으며, 템플릿 목록 조회, 신규 생성 및 수정, 보관, 복원이 가능합니다. 템플릿 구성 항목의 포함 여부(on/off)를 관리할 수 있고, 구성 항목은 다음과 같습니다.
+
+(관련 이미지 첨부)
+
+**발신자 정보**
+
+- 우리 회사 상호
+
+**수신자(파트너) 정보**
+
+- 파트너 이름 및 법인명
+- 파트너 유형
+- 과세, 소득 유형
+- 예금주명
+- 은행정보 (계좌번호 및 은행명)
+
+**정산 기본 정보**
+
+- 정산 기간
+
+**정산 금액 정보**
+
+- 지급 금액 (필수값)
+- 원천징수세액 (소득세, 지방 소득세)
+- 정산 금액
+- 확정 공급가액
+- 확정 부가세액
+- 정산 면세액
+- 확정 면세액
+
+---
+
+## 지급 내역에서 정산 내역서의 상태를 확인
+
+지급 내역 페이지에서 정산 내역서 상태 컬럼이 추가되어 발송 상태를 확인할 수 있습니다.
+
+지급 내역 페이지에 `정산내역서 상태`, `정산내역서 ID`, `정산내역서 발송 일시` 컬럼이 추가됩니다. 정산 내역서의 상태는 정산내역서가 아직 생성 및 발송되지 않은 상태인 **미발송**, 이메일이 수신자에게 성공적으로 전달된 **발송 완료**, 이메일 발송을 시도했으나, 주소 오류 등의 이유로 실패한 상태인 **발송 실패** 총 3개의 상태가 존재합니다.
+
+(관련 이미지 첨부)
+
+---
+
+## API 변경 안내
+
+지급내역 `PlatformPayout` 에 정산내역서 요약 정보가 추가되었고, 지급내역 다건 조회 시 정산내역서 정보를 기준으로 필터링할 수 있습니다.
+
+**지급 내역** `PlatformPayout` **필드 추가**
+
+신규 필드: `settlementStatement`: `PlatformPayoutSettlementStatementSummary`
+
+- `id` – 정산내역서 아이디
+- `status` – 정산내역서 상태
+- `issuedAt` – 정산내역서 발송 일시
+
+**지급 내역 필터** `PlatformPayoutFilterInput` **옵션 추가**
+
+- `settlementStatementStatuses`: 정산내역서 상태
+- `criteria.settlementStatementIssuedTimestampRange`: 정산내역서 발송 일시 범위
+- `criteria.settlementStatementId`: 정산내역서 아이디
+
+---
+
+작성일자: **2025년 08월 13일**
+
+- 일반 문의: <cs@portone.io> / 채널톡
+- 기술지원 문의: <tech.support@portone.io> / 파트너스 슬랙 채널

package/assets/docs/release-notes/platform/2025-08-21.md

@@ -0,0 +1,53 @@
+---
+releasedAt: 2025-08-21T00:00:00.000Z
+writtenAt: 2025-08-21T00:00:00.000Z
+---
+
+안녕하세요, 파트너 정산 자동화 팀입니다.
+
+2025년 8월 21일 업데이트 사항을 확인해 보세요.
+
+---
+
+## 세금계산서 정발행 기능 출시
+
+고객에게 발행하는 정발행 세금계산서를 발행하고 관리할 수 있습니다.
+
+이제, 역발행 뿐 아니라 정발행 기능을 콘솔에서 사용할 수 있습니다. 단건 발행 및 일괄 발행으로 정발행 세금계산서를 발행할 수 있게 되어 정산뿐만 아니라 모든 거래에 대한 세금계산서 커버가 가능해집니다.
+
+기존 역발행과 다르게 정발행은 파트너 등록 및 <strong>국세청 연동 없이</strong> 이용할 수 있으며, 파트너 등록을 하지 않더라도 정발행시 입력한 공급받는 자(거래처) 정보를 다시 불러와 사용할 수 있습니다.
+
+(관련 이미지 첨부)
+
+---
+
+## 엑셀, CSV 일괄 정/역발행
+
+기존 일괄 세금계산서 발행은 CSV 파일만 지원되었지만, 이번 업데이트를 통해 엑셀 파일 업로드도 가능해집니다. 제공되는 엑셀 및 CSV 파일 양식을 다운로드 받아 일괄적으로 세금계산서를 작성하여 업로드할 수 있습니다. 기존 역발행과 동일하게 미리보기 후 임시 저장하거나 즉시 발행할 수 있습니다.
+
+(관련 이미지 첨부)
+
+---
+
+## 세금계산서 내역 관리
+
+기존 역발행 건과 정발행 건의 자연스러운 통합을 위해 세금계산서 내역 관리 페이지에 발행 유형 필터가 추가됩니다. 세금계산서 내역 테이블 내 사업자 정보 컬럼이 기존 공급자 정보에서 거래처(공급자/공급받는자) 정보로 변경되어 역발행의 경우 공급자, 정발행의 경우 공급받는자 정보가 표기됩니다.
+
+일괄 세금계산서 내역 관리 페이지에서 발행 대기 상태와 발행 실패 상태가 추가됩니다. 발행 대기 상태는 일괄 세금계산서 발행 처리 중 상태를 의미하며 발행 실패 상태는 시스템 처리 실패를 의미합니다. 또한 정발행과 역발행을 구분하는 발행 유형 정보 및 필터가 추가됩니다.
+
+(관련 이미지 첨부)
+
+---
+
+## 세금계산서 안내 메일 발송
+
+공급받는 자에게 이메일이 발송됩니다.
+
+세금계산서를 발행하는 시점에 공급받는자 (고객) 에게 팝빌 (포트원과 연동된 세금계산서 서비스) 로부터 이메일이 발송됩니다. 공급자는 발행 주체이므로, 별도의 알림 이메일은 발송되지 않습니다.
+
+---
+
+작성일자: **2025년 08월 21일**
+
+- 일반 문의: <cs@portone.io> / 채널톡
+- 기술지원 문의: <tech.support@portone.io> / 파트너스 슬랙 채널

package/assets/docs/release-notes/platform/2025-08-28.md

@@ -0,0 +1,53 @@
+---
+releasedAt: 2025-08-28T00:00:00.000Z
+writtenAt: 2025-08-28T00:00:00.000Z
+---
+
+안녕하세요, 파트너 정산 자동화 팀입니다.
+
+2025년 8월 28일 업데이트 사항을 확인해 보세요.
+
+---
+
+## 2단계 인증수단
+
+### 2단계 인증수단이란?
+
+관리자 계정 접근 및 이체 실행 시, 공동 인증서 외에 다른 방식의 인증 절차를 요구하여 보안을 유지하는 방식입니다. 포트원은 2단계 인증 수단으로 Google Authenticator (Google OTP) 를 사용합니다. 파트너 정산을 이용하시는 고객님의 빠르고 편리한 이체를 돕기 위해 관리자 콘솔에서 2단계 인증 수단을 이용할 수 있습니다.
+
+---
+
+## 이체 시 2단계 인증수단 업데이트
+
+### 공동인증서 없이 2단계 인증수단 (OTP) 을 이용하여 쉽게 이체하세요.
+
+이제, 공동인증서 없이 콘솔에서 2단계 인증수단을 이용하여 손쉽게 이체를 진행할 수 있습니다. 설정의 내 정보 관리탭에서 2차인증을 눌러 Google Authenticator 를 등록하여 2단계 인증 수단으로 설정할 수 있습니다. 등록이 완료되면 송금대행 일괄이체 실행 페이지의 최종 단계에서 전자서명 대신 2단계 인증번호를 입력할 수 있는 다이얼로그가 노출됩니다.
+
+(이미지 첨부: 2단계 인증번호 입력 화면)
+
+---
+
+## 보안 관련 사항
+
+### 2단계 인증수단 신청 방식
+
+공동인증서 대신 2단계 인증수단 등록을 위해서는 포트원 세일즈/CS 팀으로 요청하셔야하며, <bd@portone.io> 를 통해 요청하실 수 있습니다. 요청이 완료되었더라도, 2단계 인증 설정이 완료된 Admin 계정의 유저만 사용이 가능합니다.
+
+또한, 강력한 보안 조치를 위해 포트원 관리자 콘솔 세션 접근 시 인증을 진행하였더라도, 이체 시에 2단계 인증 수단을 통한 재인증이 요구됩니다.
+
+---
+
+## 가상계좌 과출금 방지 기능 업데이트
+
+### 권장 출금 금액보다 많은 금액을 인출할 때 과출금 방지 경고를 받습니다.
+
+실시간으로 안전한 출금을 지원하고, 과출금 리스크를 방지하기 위해 과출금 방지 기능이 업데이트 되었습니다. 권장 출금 금액 (계좌 잔액 - 예상 지급 금액) 을 자동 계산하여, 권장 출금 금액보다 많은 금액을 출금하려고 할 때 과출금 방지 경고를 받을 수 있습니다. 예상 지급 금액은 정산내역과 지급내역을 통해 계산되며, 가상계좌 출금 페이지에서 예상 지급 금액 정보를 바로 확인할 수 있습니다.
+
+(이미지 첨부: 과출금 방지 화면)
+
+---
+
+작성일자: **2025년 08월 28일**
+
+- 일반 문의: <cs@portone.io> / 채널톡
+- 기술지원 문의: <tech.support@portone.io> / 파트너스 슬랙 채널

package/assets/docs/release-notes/platform/2025-10-02.md

@@ -0,0 +1,152 @@
+---
+releasedAt: 2025-10-02T00:00:00.000Z
+writtenAt: 2025-10-02T00:00:00.000Z
+---
+
+안녕하세요, 파트너 정산 자동화 팀입니다.
+
+파트너 정산 자동화 제품의 테스트 환경 확장에 따른 API 변경 사항을 안내드립니다.
+
+---
+
+## \[파트너 정산 자동화] 테스트 환경 분리 및 API 변경 사전 안내
+
+이번 업데이트로 운영 환경과 테스트 환경이 완전히 분리되어, 설정·정산 정책·내역서 템플릿 등을 독립적으로 관리하실 수 있습니다.
+
+## 주요 변경 사항
+
+- 신규 쿼리 파라미터: test: Boolean (선택값)
+
+- 적용 대상: 모든 파트너 정산 REST API
+
+- 적용 예정 일자: 2025년 11월 중 (정확한 일자는 추후 별도 안내 예정)
+
+- 기본값: false
+
+- 연동 환경 별 설정
+  - 라이브: 하위호환성이 보장되어 영향이 없습니다.
+  - 테스트: test=true 쿼리 파라미터 추가 설정이 필요합니다.
+
+(이미지 첨부: as is - to be)
+
+이번 변경으로 라이브/테스트 환경이 완전히 분리되어 더욱 자유로운 테스트가 가능해집니다.\
+_기존 데이터는 테스트 및 라이브 환경에 복제되어 기존 그대로 활용하실 수 있습니다._
+
+---
+
+## 개선 사항
+
+### 1. 정산 정책 및 수식 테스트 환경 분리
+
+기존에는 정산 정책 및 정산 수식을 변경할 때 별도의 테스트 환경이 없어 운영에 영향을 줄 우려가 있었습니다.\
+이번 개선으로 라이브 환경과 완전히 분리된 테스트 환경을 제공하여, 정산 정책 및 수식을 실제 운영에 영향 없이 안전하게 테스트할 수 있습니다.
+
+### 2. 파트너 데이터 환경 분리
+
+테스트를 위해 등록한 파트너가 라이브 데이터에 그대로 남아 실제 파트너와 함께 조회되는 불편함이 있었습니다.\
+테스트용 파트너는 테스트 환경에 별도로 등록하여, 실제 파트너 데이터와 분리하여 관리할 수 있습니다.
+
+### 3. 국세청 연동 환경 분리
+
+국세청 연동 시 라이브와 테스트 환경에 동시에 연동되어 불필요한 연동 안내 메일을 중복으로 받는 문제가 있었습니다.\
+환경별로 독립적인 국세청 연동이 가능해져 필요한 환경에서만 선택적으로 연동할 수 있습니다.
+
+---
+
+## 세부 변경 사항
+
+### 1. 기존 요청 본문에서 테스트 환경 구분이 가능한 API
+
+요청 본문(body)의 `isForTest` 파라미터로 환경을 지정하던 방식은 deprecated 되었습니다.\
+쿼리 파라미터 `test`로 대체 해 주시기 바랍니다. deprecated 필드는 2026년 이후 별도 공지와 함께 지원이 중단될 예정입니다.
+
+```http
+#Query Parameter가 우선 적용
+POST /platform/transfers/order?test=true
+{
+  "isForTest": false,  // 무시됨, Query Parameter의 true가 적용
+  ...
+}
+
+#Query Parameter 가 없으면 Request Body 값 사용
+POST /platform/transfers/order
+{
+  "isForTest": true,  // 이 값이 적용
+  ...
+}
+```
+
+우선순위는 아래와 같습니다.
+
+1. Query Parameter 의미 `test` (최우선)
+2. Request Body 의 `isForTest` (Query Parameter 없을 때)
+3. 기본값 `false` (둘 다 없을 때)
+
+영향 받는 API는 다음과 같습니다.
+
+- 정산 상세 내역 다운로드 `GET /platform/transfer-summaries/sheet-file`
+- 정산건 다건 조회 `GET /platform/transfer-summaries`
+- 수기 정산건 생성 `POST /platform/transfers/manual`
+- 주문 정산건 생성 `POST /platform/transfers/order`
+- 주문 취소 정산건 생성 `POST /platform/transfers/order-cancel`
+- 정산 내역 다건 조회 `GET /platform/partner-settlements`
+- 지급 내역 다건 조회 `GET /platform/payouts`
+- 일괄 지급 내역 다건 조회 `GET /platform/bulk-payouts`
+- 이체 내역 다건 조회 `GET /platform/account-transfers`
+- 일괄 이체 내역 다건 조회 `GET /platform/bulk-account-transfers`
+
+### 2. 테스트 환경 지정이 필요한 API
+
+테스트 환경 지정을 위해 쿼리 파라미터 `test`가 추가되었습니다.\
+해당 파라미터는 선택 값이며 기본값은 `false`입니다.
+
+```http
+#라이브 환경 데이터만 조회 (기본값)
+GET /platform/transfers/{id}
+
+#테스트 환경 데이터만 조회
+GET /platform/transfers/{id}?test=true
+```
+
+영향 받는 API는 다음과 같습니다.
+
+- 정산건 조회 `GET /platform/transfers/{id}`
+- 정산건 삭제 `DELETE /platform/transfers/{id}`
+- 추가 수수료 정책 다건 조회 `GET /platform/additional-fee-policies`
+- 추가 수수료 정책 생성 `POST /platform/additional-fee-policies`
+- 추가 수수료 정책 조회 `GET /platform/additional-fee-policies/{id}`
+- 추가 수수료 정책 수정 `PATCH /platform/additional-fee-policies/{id}`
+- 추가 수수료 정책 보관 `POST /platform/additional-fee-policies/{id}/archive`
+- 추가 수수료 정책 복원 `POST /platform/additional-fee-policies/{id}/recover`
+- 계약 다건 조회 `GET /platform/contracts`
+- 계약 생성 `POST /platform/contracts`
+- 계약 조회 `GET /platform/contracts/{id}`
+- 계약 수정 `PATCH /platform/contracts/{id}`
+- 계약 보관 `POST /platform/contracts/{id}/archive`
+- 계약 복원 `POST /platform/contracts/{id}/recover`
+- 할인 분담 정책 다건 조회 `GET /platform/discount-share-policies`
+- 할인 분담 정책 생성 `POST /platform/discount-share-policies`
+- 할인 분담 정책 조회 `GET /platform/discount-share-policies/{id}`
+- 할인 분담 정책 수정 `PATCH /platform/discount-share-policies/{id}`
+- 할인 분담 정책 보관 `POST /platform/discount-share-policies/{id}/archive`
+- 할인 분담 정책 복원 `POST /platform/discount-share-policies/{id}/recover`
+- 파트너 다건 조회 `GET /platform/partners`
+- 파트너 생성 `POST /platform/partners`
+- 파트너 다건 생성 `POST /platform/partners/batch`
+- 파트너 일괄 국세청 연동 `POST /platform/partners/member-company-connect`
+- 파트너 국세청 연동 `POST /platform/partners/member-company-connect/{id}`
+- 파트너 일괄 국세청 연동 해제 `POST /platform/partners/member-company-disconnect`
+- 파트너 국세청 연동 해제 `POST /platform/partners/member-company-disconnect/{id}`
+- 파트너 조회 `GET /platform/partners/{id}`
+- 파트너 수정 `PATCH /platform/partners/{id}`
+- 파트너 보관 `POST /platform/partners/{id}/archive`
+- 파트너 복원 `POST /platform/partners/{id}/recover`
+- 예금주 조회 `GET /platform/bank-accounts/{bank}/{accountNumber}/holder`
+- 사업자 조회 `GET /platform/companies/{businessRegistrationNumber}/state`
+
+---
+
+작성일자: **2025년 10월 02일**
+
+- 일반 문의: <cs@portone.io> / 채널톡
+- 기술지원 문의: <support.b2b@portone.io> / 파트너스 슬랙 채널