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

package/assets/docs/blog/posts/2025-12/portone-chatbot.md

@@ -0,0 +1,116 @@
+---
+title: 포트원 AI 챗봇이 반복되는 기술 문의를 획기적으로 단축한 비결
+description: 잘 만든 AI 서비스 하나로 1000개의 기술 문의를 대신한 이야기
+author: portone-io
+date: 2025-12-17T15:00:00.000Z
+tags:
+  - AI
+  - Chatbot
+---
+
+안녕하세요, 온라인 비즈니스 결제 인프라를 만드는 포트원입니다.
+결제 연동은 복잡합니다. 개발 환경도 다르고, 사용하는 언어도 제각각이죠. 그러다 보니 포트원 CS 채널에는 하루에도
+수많은 '기술 문의'가 쏟아집니다.
+문제는 여기서 발생합니다. 고객의 질문은 고도화되는데, CS 담당자가 모든 개발 지식을 알 수는 없으니까요.
+결국 문의는 개발팀으로 넘어오고, "문의 - CS팀 - 개발자 - 답변 작성 - CS팀 - 고객"으로 이어지는 비효율의
+무한 루프가 시작됩니다.
+
+**"이 단순 반복 업무를 AI가 대신할 수는 없을까?"**
+
+최근 포트원이 공개한 AI 챗봇, ‘포트원 AI Assistant’ 프로젝트는 위 질문에서 시작되었습니다.
+해커톤에서 시작된 실험을 실제 서비스로 안착시키기까지, 포트원의 한지환 프로덕트 오너와 전우제 백엔드 엔지니어가
+함께한 치열했던 개발기를 공개합니다.
+
+## ‘단순한 기술 문의의 반복, 어려워지는 온보딩’
+
+포트원 개발팀은 단순한 기술 문의가 지속적으로 반복되며 개발자들이 CS답변에 쓰는 리소스가 점점 늘어나는 상황과,
+결제 연동 과정에서 고객들이 길어지는 상담으로 이탈하는 문제를 발견했습니다.
+
+한지환 프로덕트 오너 : 포트원의 미션은 '온라인 비즈니스를 하고 있는 누구나 결제 연동을 쉽게 하는 것'입니다. 그런데
+아이러니하게도 연동 과정에서 고객들이 겪는 어려움을 해결해 주는 과정이 점점 느려졌어요. 기술 문의가 들어오면
+CS팀에서 개발자에게 전달하고, 개발자가 내용을 확인하고 답변을 줄 때까지 고객은 기다려야 했죠. 내부적으로도 리소스
+낭비가 심했습니다. 개발자들이 코드 짜는 시간보다 기술 문의 답변을 검수해 주는 시간이 점점 늘어나기 시작했거든요.
+
+전우제 엔지니어 : 반복되는 기술 문의를 들여다보면 패턴이 보였어요. "결제 연동 오류가 나요"라고 하는데, 살펴보면
+뻔한 실수인 경우가 많았죠. 개발자가 보면 1초 만에 아는 내용인데, CS팀을 거치다 보니 답변이 늦어지는 상황이
+반복됐습니다. 이 시간을 단축하고 싶다는 니즈는 개발팀 내에서도 꽤 오래전부터 있었습니다
+
+## 해커톤이 가져다준 AI 실험 기회
+
+이 문제를 해결하기 위해 처음부터 거창한 프로젝트를 띄운 건 아니었습니다.
+시작은 포트원 개발팀이 참여한 'AWS X 메가존 해커톤'이었습니다.
+
+전우제 엔지니어 : 사실 이 아이디어가 해커톤 메인 출품작은 아니었어요.
+하지만 해커톤 기간 동안 AWS Bedrock과 Claude 모델을 마음껏 테스트해 볼 수 있는 '크레딧'이 생겼다는 게 중요했습니다. 회사 입장에서 AI 도입의 가장 큰 장벽은 '비용'이거든요.
+
+"이게 진짜 될까?" 싶은 아이디어를 비용 걱정 없이 검증해 볼 수 있는 완벽한 타이밍이었죠.
+그때 얻은 'AI 서비스 구성 감각'이 실제 제품 개발로 이어지는 결정적인 트리거가 됐습니다.
+
+## AI를 '답변 기계'가 아닌 '사고 파트너'로
+
+가장 큰 기술적 난관은 AI 챗봇의 고질병인 '할루시네이션(거짓 답변)'이었습니다.
+결제 연동 가이드에서 없는 함수를 있다고 하거나, 잘못된 파라미터를 알려주면 치명적이니까요.
+
+보통은 이를 해결하기 위해 RAG(검색 증강 생성)와 Vector DB를 사용하지만,
+포트원 개발팀은 조금 다른 접근을 택했습니다.
+
+### Vector DB 없는 RAG? "MCP의 도입"
+
+초기 테스트 결과, 단순히 문서를 쪼개서 Vector DB에 넣고 검색하는 방식은 한계가 명확했습니다. 문맥이 잘린 채
+검색되다 보니 AI가 엉뚱한 문서를 참고해서 답변하는 경우가 많았죠.
+
+그래서 우리는 MCP(Model Context Protocol) 개념을 적극적으로 도입했습니다.
+
+쉽게 말해, AI에게 미리 정답지(문서 조각)를 쥐여주는 게 아니라, "네가 모르는 게 있으면
+우리 개발자 문서 도구(Tool)를 사용해서 직접 검색해 봐"라고 시키는 방식입니다. AI를 단순 답변기가 아니라,
+문서를 검색하고 내용을 판단하는 '사고 파트너(Thinking Partner)'로 설계한 것이죠.
+
+### 비용과 성능의 줄타기 (Claude 4.0 Sonnet)
+
+모델 선정도 치열했습니다. 성능이 좋은 모델은 비싸고, 싼 모델은 답변 품질이 다소 낮습니다.
+
+비용 절감과 품질 사이에서 고민하다 결국 Claude 4.0 Sonnet을 채택했습니다. 저렴하지 않은 모델을 썼음에도 비용은
+오히려 통제 가능했습니다.
+
+- MCP 서버를 최적화하여 불필요한 토큰 소모를 줄였습니다.
+- 답변의 정확도가 올라가니, 사용자가 여러 번 다시 묻는 횟수가 줄어들어 전체적인 토큰 사용량은 합리적인 수준(하루 100건 사용 기준 월 $25\~30 내외)으로 유지되었습니다.
+
+### "기다림도 UX다"
+
+(관련 이미지 첨부)
+
+LLM의 답변 속도를 우리가 직접 획기적으로 줄이는 건 불가능했죠. 대신 이용자 입장에서의
+'체감 시간'을 줄이려고 했습니다.
+단순히 로딩 바가 도는 게 아니라, "현재 개발자 문서를 검색하고 있습니다...", "관련 내용을 분석 중입니다..." 처럼
+AI가 현재 수행 중인 작업을 실시간으로 보여주었습니다. (Perplexity나 Gemini처럼요.) 이 작은 장치가 고객이
+이탈하지 않고 답변을 기다리게 만드는 핵심 UX가 되었습니다.
+
+## AI 챗봇 도입 성과 : "CS 문의가 줄었습니다"
+
+(관련 이미지 첨부)
+
+포트원 AI 챗봇 도입 3주 차, 변화는 데이터로 나타나고 있습니다.
+
+한지환 프로덕트 오너 : CS팀에서 먼저 피드백이 왔어요. "체감상 기술 문의가 확 줄었다"고요. 하루 평균 약 50\~100건
+정도의 문의를 AI가 처리하고 있습니다. 도입 후 약 1,000건의 문의를 처리했죠. 특히 "API 키 어디서 찾나요?",
+"이 오류 코드는 뭔가요?" 같은 단순 문의는 AI 챗봇 선에서 대부분 해결됩니다.
+
+재미있는 건 개발자들의 반응입니다. "CS팀에서 넘어오는 기술 문의 난이도가 올라갔다"고 해요.
+
+전우제 엔지니어 : 예전엔 "뭐가 안 돼요"라는 단순한 질문이 왔다면, 이제는 AI를 통해 1차적인 해결을 시도해 본
+고객들이 "AI 챗봇을 보고 여기까지 해봤는데, 이 부분에서 막힙니다"라고 구체적인 질문을 던집니다.
+
+비효율적인 핑퐁이 사라지고, 개발자와 CS팀 모두가 '진짜 해결해야 할 문제'에 집중할 수 있게 된 것입니다.
+
+## 포트원의 다음 미션 : "결제 연동, 클릭 한 번으로 해결"
+
+포트원 AI Assistant는 이제 시작입니다. 포트원은 '단순히 질문을 답변해주는 봇'을 넘어 '결제를 직접 연동하는
+에이전트(Agent)'를 꿈꿉니다.
+
+한지환 프로덕트 오너 : 지금은 "PG 어떻게 연동해요?"라고 물으면 방법을 알려주죠. 하지만 포트원이 준비하는
+다음 단계는 그 이상입니다. 고객의 깃허브(Github)를 AI가 분석하고, 프로젝트 환경에 맞는 결제 연동 코드를 직접
+짜서 PR(Pull Request)까지 날려주는 단계. 이미 PoC(개념 검증)는 마쳤고 개발이 진행 중입니다.
+
+개발자가 더 이상 단순 반복 업무에 시달리지 않는 세상, 누구나 말 한마디로 결제를 연동하는 세상.
+
+포트원의 ‘AI를 활용한 결제 연동 경험 혁신’은 이제 막 본궤도에 올랐습니다.

package/assets/docs/help/admin-console/analytics/content32.md

@@ -190,38 +190,6 @@ searchTags:
 - 데이터 표기 기준
   - 국내결제, 해외결제 모두 연동되어 있는 결제대행사를 기준으로 표기됩니다.
 
-**Section 4. 결제전환율 (coming soon)**
-
-- 목적
-  - 결제 상태별 현황 및 비중을 파악할 수 있습니다. 결제 상태별 상세 현황과 타사 비교 벤치마크를 통해 현재 자사 결제전환율이 건강한지 파악하고, 결제 실패 사유를 심층 분석합니다.
-
-### **결제 모니터링 서비스 (coming soon)**
-
-- 목적
-  - 실시간 / 기간별 결제 모니터링 서비스를 통해서 결제 이상 유무 및 장애 여부를 파악할 수 있습니다.
-
-
-
-##### **Section 1. 실시간 결제 모니터링**
-
-- 결제 상태 현황
-  - 결제 상태별 거래건수를 실시간으로 확인할 수 있습니다.
-- 웹훅 수신 현황
-  - 포트원으로부터 수신한 웹훅에 대해 응답한 웹훅의 상태코드를 (http status )확인할 수 있습니다.
-- 결제대행사별 결제성공률
-  - 연동한 모든 결제대행사의 결제성공률을 실시간으로 확인할 수 있습니다.
-- 웹훅 발송 현황
-  - 웹훅 발송 성공률을 실시간으로 확인할 수 있습니다.
-
-##### **Section 2. 기간별 결제 모니터링**
-
-- 결제 상태별 거래현황
-  - 선택한 날짜에 대한 결제 상태별 거래건수를 확인할 수 있습니다.
-- 시간대별 웹훅 수신 및 발송 현황
-  - 선택한 날짜에 대한 고객사 수신 웹훅 건수와 고객사 발송 웹훅 에러코드를 비교할 수 있습니다.
-
-
-
 ### **부가 설명**
 
 #### **1.계정 설정**

package/assets/docs/help/admin-console/console-account/content31.md

@@ -20,7 +20,6 @@ searchTags:
   - 하위상점
   - 관리자권한
   - 마케팅수신
-  - 로그아웃
   - 회원탈퇴
   - 2차인증
   - 비밀번호변경
@@ -48,10 +47,6 @@ searchTags:
 - **회원 탈퇴** : <Highlight text="Admin(Owner) 계정은 삭제 시, 연결된 상점 전체도 함께 삭제되니 주의해 주세요" />\
   (탈퇴한 계정의 경우  30일이내에 변경/가입이 불가 합니다. )
 
-
-
-- **로그아웃** : 좌측 하단 계정을 클릭 후 ‘로그아웃’
-
 #### **2. 관리자 계정 관리**
 
 - 해당 메뉴에서는 권한별 로그인 가능한 계정을 추가/삭제/변경 하실 수 있습니다.
@@ -74,9 +69,6 @@ searchTags:
 - 상위 상점과 하위 상점이 구분되어있는 형태의 서비스이실 경우, 하나의 상위 상점에서 하위 상점의 연동 채널/결제내역을 통합 관리하실 수 있습니다. \
   (ex : A상점(상위)에서 지역별 지점이 존재하는 경우, 하위상점에 \[강남 지점],\[삼성 지점],\[역삼 지점] 등으로 구분하여 설정가능)
 
-
-
-- **돋보기 기능** : 등록된 하위상점을 검색하여 조회가능
 - **연결된 계정 권한**
   - 하위상점에 특정 메일계정 연동가능 (연결된 계정은 해당 하위상점의 내역만 조회가능)
   - 하위상점에 매핑되는 계정은 Manager 혹은 Read only 권한으로만 가능합니다.
@@ -87,8 +79,8 @@ searchTags:
 - **사용할 결제채널 선택** : 하위상점으로 연동하고자 하는 PG사와 상점정보를 선택
   - 결제연동 메뉴에서 연동이 필요한 채널을 먼저 설정하신 후 하위상점과 연결합니다.
 - **서비스 URL :** 하위상점의 연동페이지 URL 입력
-- **담당자명** : 하위상점의 담당자님 성함
-- **담당자 휴대폰번호 :** 하위상점의 담당자님 휴대폰번호
+- **담당자명** : 하위상점 담당자 성함
+- **담당자 휴대폰번호 :** 하위상점 담당자 휴대폰번호
 - **티어 코드** : 영문(대문자)와 숫자3자리로 티어코드 설정
   - 하위상점 연동시 티어코드로 구분합니다.
 - **결제알림(Webhook) 설정** : 상위상점의 웹훅 URL과 동일하게 설정하실 경우 체크

package/assets/docs/help/admin-console/console_home/content34.md

@@ -25,53 +25,14 @@ searchTags:
 
 
 
-##### **1. 결제내역 조회일자**
-
 - 조회일자(달력)에 따라 결제대시보드 확인이 가능하며, 6개월/1개월/1주로 간편하게 일자 조절이 가능합니다.
 
-##### **2. 일자표기**
-
-- 조회하시는 년도/월/일/요일 이 표기됩니다.
-
-##### **3. 테스트 데이터**
-
-- 대시보드를 임시 데이터로 확인해보실 수 있습니다. \
-  (테스트용 상점정보로 결제된 내역이 아닌, 더미데이터 입니다.)
-
-##### **4. 거래액 집계데이터**
-
-- 거래액 : 결제완료 된 적 있는 모든 금액 (결제완료+결제취소 금액 합산)
-- 순거래액 : 거래액-거래취소액
-- 거래취소액 : 결제완료 후 취소한 금액 (전액취소+부분취소)
-
-##### **5. 거래액 그래프**
-
-- 일간, 시간별 거래액을 그래프 형식으로 확인할 수 있습니다.
-
-##### **6. 순 거래액 TOP5**
-
-- 결제가 많이 발생한 결제수단 TOP5을 확인할 수 있습니다.
-
-
-
-##### **7. 공지사항**
-
-- 포트원의 공지사항을 실시간으로 확인할 수 있습니다.
-- 모든 공지사항을 확인하시려면 우측 더보기를 클릭해주세요.
-
-##### **8. 새소식**
-
-- 포트원의 새로운 소식을 빠르게 확인하실 수 있습니다.
-- 모든 새소식을 확인하시려면 우측 더보기를 클릭해주세요 ([포트원 블로그 ↗](https://blog.portone.io/)  로 이동됩니다.)
-
-##### **9. FAQ**
-
-- 포트원의 주요 FAQ TOP5를 확인하실 수 있습니다.
-- 모든 FAQ를 확인하시려면 우측 더보기를 클릭해주세요.
-
-##### **10. 가이드**
+- 대시보드를 임시 데이터로 확인해보실 수 있습니다 (테스트용 상점정보로 결제된 내역이 아닌, 더미데이터 입니다.)
 
-- 포트원 서비스를 이용하실 때 필요하신 가이드를 제공드립니다.
+* 거래액 집계데이터
+  - 거래액 : 결제완료 된 적 있는 모든 금액 (결제완료+결제취소 금액 합산)
+  - 순거래액 : 거래액-거래취소액
+  - 거래취소액 : 결제완료 후 취소한 금액 (전액취소+부분취소)
 
 ### **전자결제 신청 ⚡**
 

package/assets/docs/help/admin-console/integration/content28.md

@@ -3,7 +3,7 @@ title: 결제연동
 category: 관리자콘솔 (관리자콘솔 사용 가이드) > 결제연동 > 결제 연동
 seo:
   title: 결제연동
-  description: 상점정보, 테스트/실 연동관리, 결제알림, 추가 설정 관리 등 관리자콘솔 내 결제연동을 위한 정보들을 확인해보세요.
+  description: 채널관리, 식별코드/Api Keys 관리, 결제웹훅 관리, 추가 설정 관리 등 관리자콘솔 내 결제연동을 위한 정보들을 확인해보세요.
   keywords:
     - 결제연동
     - 관리자콘솔
@@ -24,27 +24,9 @@ searchTags:
   - 대표상점
 ---
 
-### **결제연동**
-
-#### **1. 상점정보**
-
-
-
-- 대표상점
-  - 최초 회원가입된 계정은 \[대표상점]으로 분류되며 하위상점을 추가하신 경우 변경 버튼을 통해 하위상점의 메뉴로 이동할 수 있습니다.
-
-
-
-- 내 식별코드 ・ API Keys
-  - 고객사 식별코드 : 결제연동시(결제창 호출시) 사용하는 식별코드
-  - REST API Key : 결제연동시(REST API 호출시) 사용하는 Key
-  - REST API Secret : 결제연동시(REST API 호출시) 사용하는 Key
-
-#### **2. 테스트/실 연동관리**
-
-**테스트 및 실 연동환경을 위해 상점정보를 설정하는 메뉴입니다.**
-
+#### **1. 테스트/실 연동관리**
 
+**테스트 및 실 연동 채널 정보 설정하는 메뉴입니다.**
 
 
 
@@ -58,6 +40,12 @@ searchTags:
 
 </Indent>
 
+#### 2. 내 식별코드 ・ API Keys
+
+- 고객사 식별코드 : 결제연동시(결제창 호출시) 사용하는 식별코드
+- REST API Key : 결제연동시(REST API 호출시) 사용하는 Key
+- REST API Secret : 결제연동시(REST API 호출시) 사용하는 Key
+
 #### **3. 결제알림(Webhook) 관리**
 
 **안정적인 결제연동을 위해 웹훅 서비스를 사용하시기 위한 메뉴입니다.**

package/assets/docs/help/admin-console/payment-service/content29.md

@@ -56,33 +56,23 @@ searchTags:
 - **고객 우편번호 :** 고객 우편번호(buyer\_postcode) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
 - **결제대행사 승인번호 :** 결제대행사(PG사) 승인번호 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
 - **카드번호** : 카드번호 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다. 카드 번호의 경우 결제대행사에 따라 마스킹되는 부분이 다르므로, 앞에 6\~8자리(BIN)번호 혹은 뒷 4자리로 검색하시길 권장드립니다.
-- **상점아이디** : 결제대행사 상점아이디 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
 - **결제 환경** : 결제환경(PC/MOBILE/API) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다. 검색하는 경우 대문자로 검색해야 합니다.
 - **실시간 계좌 은행** : 실시간 계좌이체 거래 건에 한하여 실시간 계좌 은행 데이터 중 입력한 택스트와 일치하는 데이터가 표시됩니다. (ex. 실시간 계좌이체 거래 건의 계좌은행이 토스뱅크인 경우 )
-- **가상계좌 은행** : 가상계좌 거래 건에 한하여 가상계좌 은행 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
-- **계좌번호** : 가상계좌 거래 건에 한하여 계좌번호 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
-- **입금자명** : 가상계좌 거래 건에 한하여 입금자명 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
 - **현금영수증 발급번호** : 실시간 계좌이체 또는 가상계좌 거래 시 현금영수증을 발급한 거래 건에 한하여 현금영수증 발급번호(국세청 승인번호) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
 - **취소 사유** : 결제 취소 건에 한하여 취소 사유 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다. 포트원 어드민콘솔에서 취소한 경우 취소 사유는 관리자페이지취소로 일괄 입력됩니다.
-- **카드사명** : 카드사명 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
-- **할부 개월수** : 카드 결제 시 할부가 적용된 거래 건에 한하여 할부개월수 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
-
-**필터**
-
-결제상태/결제수단/결제대행사/결제유형/결제모드로 구분된 필터로 검색조건을 제어할 수 있습니다.
 
 <Callout content="테스트용 상점아이디로 결제된 건은 테스트결제를 반드시 체크해주셔야 조회가 가능합니다." icon="💡 " />
 
 **결제 상태**
 
 - **전체 :** 모든 결제상태의 거래를 조회합니다.
-- **결제 완료** : 조회하시는 시점에 결제상태가 완료(status: paid)된 건의 거래를 조회합니다. (결제취소건 미포함)
-- **결제 예정** : 조회하시는 시점에 결제상태가 예정(status: ready)된 건의 거래를 조회합니다.
+- **결제 완료** : 조회하는 시점에 결제상태가 완료(status: paid)인 거래를 조회합니다. (결제취소건 미포함)
+- **결제 예정** : 조회하는 시점에 결제상태가 예정(status: ready)인 거래를 조회합니다.
   - 결제창을 띄운 직후 결제의 상태는 결제예정(ready)로 저장됩니다.
   - 결제가 최종적으로 완료되면서 승인되면 결제완료(paid)로 상태가 변경되어 저장되나, 결제도중 모종의 이유로 인하여 고객이 결제창을 이탈한 경우에는 처음 저장된 상태(ready) 그대로 남게 됩니다.
-- **결제 실패** : 조회하시는 시점에 결제상태가 실패(status: failed)된 건의 거래를 조회합니다.
-- **결제 취소** : 조회하시는 시점에 결제상태가 취소(status: cancelled)된 건의 거래를 조회합니다.
-- **승인 대기** : 조회하시는 시점에 결제상태가 승인대기(status: pending)된 건의 거래를 조회합니다.\
+- **결제 실패** : 조회하는 시점에 결제상태가 실패(status: failed)인 거래를 조회합니다.
+- **결제 취소** : 조회하는 시점에 결제상태가 취소(status: cancelled)인 거래를 조회합니다.
+- **승인 대기** : 조회하는 시점에 결제상태가 승인대기(status: pending)인 거래를 조회합니다.\
   승인대기는 페이팔(SPB/RT)을 이용하실 경우에만 존재하는 결제상태로, 결제 및 환불 요청 완료 후 승인되기까지 결제상태를 의미합니다.
 
 **집계**
@@ -97,15 +87,8 @@ searchTags:
   - **UID/MID**
     - **UID** : 포트원의 주문번호. imp\_숫자12자리 형태입니다. \
       (정기결제는 imps\_숫자12자리) 결제창이 호출되자마자 자동으로 생성/저장되는 번호.
-  - **상품명** : 결제요청시 지정하신 상품명(name)
-  - **고객정보** : 결제요청시 지정하신 고객명(buyer\_name)
-  - **결제수단** : 결제요청하신 결제수단
-  - 결**제대행사** : 결제요청하신 결제대행사(PG사)
-  - **결제금액** : 총 결제금액
-  - **구분** : 정기(정기결제 실 연동), 테스트 | 정기(정기결제 테스트), 테스트 | 일반(일반결제 테스트) 으로 구분됩니다.
-  - **결제요청 시각 / 상태승인 시각 :** 조회하신 기준시각 기준으로 적용된 시각. (검은바탕에는 일자가 표기됩니다)
-  - **취소** : 거래 취소를 위한 버튼
-  - **≡ :** 거래 상세내역 조회를 위한 버튼
+  - **구분** : 정기(정기결제 실 연동), 테스트-정기(정기결제 테스트), 테스트-일반(일반결제 테스트) 으로 구분됩니다.
+  - **결제요청 시각 / 상태승인 시각 :** 조회하신 기준시각 기준으로 적용된 시각.
 
 
 
@@ -125,10 +108,6 @@ searchTags:
 
 - **상태별 최종 업데이트 일시(default)** : 예약, 성공, 실패, 해지 상태 건에 대해 최종 업데이트 일시를 기준으로 조회합니다. (결제 예약건의 경우 예약 예정 시각을 기준으로 조회됩니다.)
 - **빌링결제 등록 일시** : 예약결제의 경우 예약건이 등록된 일시를 기준으로, 빌링키 일회성 결제 건의 경우 결제를 시도한 일시를 기준으로 조회합니다.
-- **오늘 :** 오늘 00시 00분 00초부터 23시 59분 59초로 설정됩니다.
-- **최근7일 :** 오늘을 기준으로 D-7일로 설정됩니다.
-- **이번 달** : 이번달 1일부터 말일까지로 설정됩니다.
-- **올해 :** 올해 1월 1일부터 12월 31일까지로 설정됩니다.
 
 ##### **필터**
 
@@ -190,8 +169,6 @@ searchTags:
 - 기본적으로 KRW를 기준으로 표시되며, 해외 통화 빌링 결제 거래건이 있는 경우 해당 통화를 선택할 수 있으며 각 통화별 빌링결제 데이터를 확인할 수 있습니다.
 - 해당 월의 결제예약 / 결제성공 / 결제실패 / 예약해지 상태별로 거래 금액 혹은 건수 데이터를 확인할 수 있습니다.
 
-
-
 #### **3. 현금영수증 관리**
 
 현금영수증 내역 메뉴에서는 고객사에서 발급한 현금영수증을 조회·검색·필터링할 수 있습니다.
@@ -200,8 +177,6 @@ searchTags:
 
 <Callout content="API로 현금영수증 발행한 건에 한하여 조회가능합니다. (지원가능한 결제대행사(PG사) 확인필요)" title="참고사항" icon="💡 " />
 
-
-
 **발급내역 구분**
 
 - **포트원 거래분 :** 포트원을 통해 결제된 거래에 대한 현금영수증 발행분을 의미합니다.
@@ -209,70 +184,15 @@ searchTags:
 - **고객사 자체 거래분** : 포트원을 통해 결제되지 않은 거래에 대한 현금영수증 발행분을 의미합니다.
   - 발행 API : [POST `/receipts/external/{merchant_uid}`](https://developers.portone.io/api/rest-v1/receipt#post%20%2Freceipts%2Fexternal%2F%7Bmerchant_uid%7D)\`(포트원을 통해 결제되지 않은 건이어도 위 API로 현금영수증 발행이 가능합니다)
 
-**조회 및 검색**
-
-
-
-- 조회 기준
-
-<Indent level="1">
-
-- 고객사 거래번호
-- PG사 현금영수증 아이디
-- 발급 상태: 전체 / 발급 / 취소
-- 조회 기간: 발급일/취소일 기준 조회 가능
-
-</Indent>
-
-- 날짜 선택
-
-<Indent level="1">
-
-- 최대 조회 가능 기간: 6개월
-- 프리셋(Preset): 오늘 / 어제 / 1주 / 1개월 / 3개월 / 6개월
-
-</Indent>
-
-- 검색 키워드
-
-<Indent level="1">
-
-- 고객사 거래번호
-- PG사 현금영수증 아이디
-- 주문명
-
-</Indent>
-
-필터기능
-
-
-
-- **발급 상태** : 완료 / 취소
-- **발급 유형** : 소득공제용 / 지출증빙용
-- **수동 발급 여부** : Y / N
-- **결제대행사(PG) :** 거래가 처리된 PG사별 필터
-- **테스트 결제 구분** : 실제 결제 / 테스트 결제 구분
-
-정렬 및 컬럼
-
-- 발급일자와 취소일자를 상태 승인 시각 단일 컬럼에서 확인할 수 있습니다.
-- 상태 승인 시각 기준 (오름/내림차순)으로 정렬 가능합니다.
-
 조회 결과 (테이블)
 
 - 발급 상태 : 발급 성공/취소 여부
 - 상태 승인 시각 : 발급 혹은 취소가 승인된 시각
 - 발급 유형 : 소득공제용 / 지출증빙용
 - 수동 발급 : 수동 발급 ‘Y’ 자동 발급 ‘N’
-- 결제대행사 : 영수증이 발행된 결제대행사
 - 고객사 거래번호 : 고객사에 부여된 거래 번호
 - PG사 현금영수증 아이디 : PG사에서 부여된 현금영수증 구분 번호
-- 현금영수증 승인번호 : 현금영수증 승인 번호
 - 영수증 : PG사 제공 영수증 바로 조회
-- 주문명 : 주문 이름
-- 결제 금액 : 총 결제 금액
-- 부가세액 : 총 부가세액
-- 면세액 : 총 면세액
 
 #### **4. 본인인증 조회**
 
@@ -286,79 +206,13 @@ searchTags:
 - 결제대행사별 정책에 따라 일부 정보(통신사, 휴대폰번호 등)가 제공되지 않을 수 있습니다.
 - 조회 가능한 최대 기간은 6개월입니다." icon="💡 " title="참고사항" />
 
-
-
-##### **조회 및 검색**
-
-
-
-- 조회 기준
-
-<Indent level="1">
-
-- 고객사 본인인증 아이디
-- PG사 본인인증 아이디
-- 인증 상태: 전체 / 완료 / 실패
-- 조회 기간: 완료일/실패일 기준 조회 가능
-
-</Indent>
-
-- 날짜 선택
-
-<Indent level="1">
-
-- 최대 조회 가능 기간 :  6개월
-- 프리셋(Preset): 오늘 / 어제 / 1주 / 1개월 / 3개월 / 6개월
-
-</Indent>
-
-- 검색 키워드
-
-<Indent level="1">
-
-- 고객사 본인인증 아이디
-- PG사 본인인증 아이디
-- 포트원 본인인증 ID
-- 본인인증 전화번호
-
-</Indent>
-
-- 검색 기능
-
-<Indent level="1">
-
-- 통합 검색 키 : 고객사 본인인증 ID, PG사 본인인증 ID, 포트원 본인인증 ID
-- 추가 검색 조건: 고객 전화번호
-
-</Indent>
-
-##### 필터 기능
-
-
-
-- 인증 상태 (성공 / 실패)
-- 결제대행사 (PG사)
-- 성별
-- 통신사
-
-##### 정렬 및 컬럼
-
-- 시도시각과 인증시각을 인증/실패 시각 단일 컬럼에서 확인할 수 있습니다.
-- 상태 승인 시각 기준 (오름/내림차순)으로 정렬 가능합니다.
-
 ##### 조회 결과 (테이블)
 
 - 인증상태 : 인증 완료 / 실패
 - 상태 승인 시각 : 인증이 완료되거나 실패한 시각
 - 고객사 본인인증 아이디 : 고객사에 부여된 본인인증 구분 번호
 - PG사 본인인증 아이디 : PG사에서 부여된 본인인증 구분 번호
-- 결제대행사 : 인증 시도 PG사
 - PG MID : 인증 성공 시 PG사에서 응답된 거래번호
-- 이름 : 인증 대상자 이름
-- 성별 : 인증 대상자 성별
-- 생년월일 : 인증 대상자 생년월일
-- 통신사 : 인증 대상자 통신사
-- 전화번호 : 인증 대상자 휴대폰 번호
 - 포트원 본인인증 아이디 : 포트원에서 부여한 본인인증 건별 고유 번호
 
 <Callout content="다날 본인인증의 경우 별도 요청하지 않으신 경우 통신사, 휴대폰번호 정보 확인이 불가합니다. 추가 정보 취득방법 가이드 참고하셔서 별도 신청 해주셔야 합니다. " icon="💡 " title="참고사항" />

package/assets/docs/help/admin-console/pg-settlement/content30.md

@@ -90,15 +90,6 @@ searchTags:
 
 <Highlight text="① 조회 기간 설정" />
 
-- 시작일과 종료일을 직접 입력하여 조회할 수 있습니다.
-- 캘린더를 통해서도 직접 조회 기간 설정할 수 있습니다.
-
-
-
-- 조회 기간은 최대 6개월까지 조회가 가능합니다.
-- 날짜 Preset 버튼을 눌러 원하는 조회 기간 범위를 쉽게 설정할 수 있습니다.
-  - 오늘 / 어제 / 지난주 / 지난달 / 이번달 / 3개월
-
 <Highlight text="② 요약대시보드" /> : 조회한 거래 결과의 요약을 확인할 수 있습니다.
 
 - 조회기간, 상점 아이디, PG 고객 식별아이디의 필터가 결과값에 반영됩니다.
@@ -124,8 +115,6 @@ searchTags:
 
 - 거래 금액(PG) - 거래 금액(포트원)
 
-
-
 <Indent level="1">
 
 a. 대사 불능 : 데이터가 없는 경우에 노란색 글씨로 표시

package/assets/docs/help/admin-console/pg-settlement-history/content35.md

@@ -88,17 +88,10 @@ searchTags:
 - 계산 수식 정리: 각 테이블별 계산 수식은 하단에서 자세하게 확인 가능합니다.
 - 정산일 : PG 정산 데이터의 정산 일자를 기준으로 확인 가능하며, 동일한 정산일자에 PG 고객 식별아이디별로 하위 그룹핑된 데이터들을 함께 확인할 수 있습니다.
 
-
-
 > 상세 버튼 클릭하면 해당 일자의 모든 거래건 혹은, 개별 PG 고객 식별아이디에 대한 상세 내역을 정산 건별 조회 메뉴로 이동하여 정산일 기준으로 상세 거래 내역 확인이 가능합니다.
 
 - 상점 아이디 : 포트원을 사용하기 위해 설정한 상점을 구분하기 위한 값을 의미합니다.
 - PG 고객 식별아이디 : PG 사에서 고객을 구분하기 위해 생성하는 고유한 값을 의미합니다.
-- 정산건 수 : 해당 정산일자에 입금되어야하는 총 정산건 수를 의미합니다.
-- 정산 금액 : 해당 정산일자에 입금되어야하는 총 정산 금액을 의미합니다.
-- 거래 금액 : 해당 정산일자에 정산 받을 거래 건의 총 거래 금액을 의미합니다.
-- PG 수수료 : 해당 정산일자에 부과되는 총 PG 수수료 금액을 의미합니다.
-- PG 수수료 부가세 : 해당 정산일자에 부과되는 총 PG 수수료 부과세 금액을 의미합니다.
 
 <Highlight text="③ 부가세 참고 자료 다운로드" />
 

package/assets/docs/help/admin-console-2025-10-17.md

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

package/assets/docs/help/content61.md

@@ -123,7 +123,7 @@ searchTags:
 
 #### **실 모드 연동**
 
-결제대행사로부터 전달받은  실 운영용 연동 정보를 포트원 관리자콘솔 내 \[결제 연동] → \[연동 관리] → \[채널 관리] 페이지에 추가해야 합니다.
+결제대행사로부터 전달받은  실 운영용 연동 정보를 포트원 관리자콘솔 내 \[결제 연동] → \[연동 정보] → \[채널 관리] 페이지에 추가해야 합니다.
 포트원 모듈을 연동하는 경우 관리자콘솔에 등록된 채널을 기반으로 결제를 요청하므로 아래 절차를 필수로 진행해야 합니다.
 결제대행사별로 연동 정보 명칭 및 정보 확인 절차가 다르므로 결제대행사별 채널 연동 가이드를 잘 참고하여 설정해 주세요.
 

package/assets/docs/help/core-service/channel-setting/danal.md

@@ -45,7 +45,7 @@ datetime: 2024-02-22T15:00:00.000Z
 결제 연동을 위해서 채널 설정은 필수이며 결제대행사와 연동방식별로 설정하는 정보는 상이할 수 있습니다.
 또한 채널 설정 없이 결제 연동을 하실 경우 정상적인 호출이 불가하며, 오류가 발생됩니다." />
 
-<Highlight url="#7_결제창-휴대폰결제-및-휴대폰-본인인증" text="다날 휴대폰 결제 및 본인인증 설정 바로가기 ↓" />
+<Highlight url="https://help.portone.io/content/danal#7_%EA%B2%B0%EC%A0%9C%EC%B0%BD-%ED%9C%B4%EB%8C%80%ED%8F%B0-%EA%B2%B0%EC%A0%9C-%EB%B0%8F-%ED%9C%B4%EB%8C%80%ED%8F%B0-%EB%B3%B8%EC%9D%B8%EC%9D%B8%EC%A6%9D" text="다날 휴대폰 결제 및 본인인증 설정 바로가기 ↓" />
 
 ## <Highlight text="결제창 일반/정기결제" />