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

package/README.md

@@ -21,7 +21,8 @@
 
 3. 설치 후 도구를 재시작하여 MCP 서버가 정상적으로 등록되었는지 확인합니다.
 
-> [!WARNING] > **Claude Desktop에서 DXT 파일 사용 시 주의사항**
+> [!WARNING]
+> **Claude Desktop에서 DXT 파일 사용 시 주의사항**
 >
 > 현재 [알려진 이슈](https://github.com/anthropics/dxt/issues/45)로 인해 Claude Desktop에서 DXT 설치 후 MCP 서버가 정상적으로 작동하지 않을 수 있습니다.
 >
@@ -50,7 +51,8 @@
 
 1. 도구를 재시작해 portone-mcp-server 및 해당 서버가 제공하는 도구들이 잘 등록되었는지 확인합니다.
 
-> [!CAUTION] > **제3자 AI 서비스를 사용할 경우, API 응답(조회된 데이터 등)이 AI 서비스 측으로 전달되어 저장되거나 해당 서비스의 정책에 따라 모델 학습에 사용될 수 있습니다.**
+> [!CAUTION]
+> **제3자 AI 서비스를 사용할 경우, API 응답(조회된 데이터 등)이 AI 서비스 측으로 전달되어 저장되거나 해당 서비스의 정책에 따라 모델 학습에 사용될 수 있습니다.**
 >
 > MCP 서버는 API 응답에 포함된 개인정보가 외부로 전달되지 않도록, 우선적으로 해당 정보를 식별 및 제거하는 보호 조치를 마련하고 있습니다.
 > 다만, 그 외의 정보는 AI 서비스의 운영 정책에 따라 일시적으로 저장되거나 처리될 수 있는 점을 유의해야 합니다.

package/assets/docs/_components/ko/docs-for-llms.md

@@ -0,0 +1,21 @@
+---
+title: LLM을 위한 개발자센터 문서 디렉터리 지원
+description: LLM을 위한 개발자센터 문서 디렉터리와 사용 방법을 설명합니다.
+targetVersions:
+  - v1
+  - v2
+---
+
+Cursor, Windsurf, Claude Code와 같이 코드베이스 맥락을 자동으로 분석하는 AI 도구를 사용하는 경우,
+LLM을 위한 포트원 문서 디렉터리를 다운받아 작업 중인 코드베이스 내에 위치시키는 방식으로도 활용할 수 있습니다.
+
+이 경우, 위 AI 도구들이 제공하는 임베딩 기반 색인과 RAG (Retrieval Augmented Generation) 검색이 자동적으로 적용되어
+보다 원활히 원하는 결과를 얻으실 수 있습니다.
+
+(파일: LLM 전용 포트원 문서 디렉터리 다운로드)
+
+### 사용 방법
+
+1. 위 링크를 눌러 LLM 전용 포트원 문서 압축 파일을 다운로드합니다.
+2. 압축을 해제하고, 해당 디렉터리를 작업 중인 코드베이스 내에 위치시킵니다.
+3. 포트원 관련 질의 시 AI에게 해당 디렉터리를 태그하여 질의합니다.

package/assets/docs/_components/ko/llms-txt-support.md

@@ -0,0 +1,15 @@
+---
+title: llms.txt 표준 지원
+description: 포트원이 지원하는 llms.txt 표준에 대한 내용입니다.
+targetVersions:
+  - v1
+  - v2
+---
+
+포트원 개발자센터 웹사이트는 [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를 파일로 업로드해 질의하는 방식으로도 활용이 가능합니다.

package/assets/docs/_components/ko/using-mcp-server.md

@@ -0,0 +1,60 @@
+---
+title: 포트원 MCP (Model Context Protocol) 서버 사용하기
+description: 포트원이 제공하는 MCP (Model Context Protocol) 서버 사용 방법을 안내합니다.
+targetVersions:
+  - v1
+  - v2
+---
+
+포트원은 쉬운 연동과 빠른 개발을 위해 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"]
+    }
+  }
+}
+```
+
+<div class="hint" data-style="info">
+
+사용 환경에 [uv](https://docs.astral.sh/uv/getting-started/installation/)가 설치되어 있어야 합니다.
+
+</div>
+
+설정 파일 수정이 완료된 후 AI 도구를 재시작하면 MCP 서버가 적용됩니다.
+
+### 2. MCP 서버 활용하기
+
+사용 중인 AI 도구에 포트원 MCP 서버가 적용되었다면, 아래 예시들과 같이 질의하여 사용할 수 있습니다.
+
+#### 개발 관련 프롬프트 예시
+
+- _"포트원 V2 Python 서버 SDK를 사용해서 서버 연동 코드를 작성해줘"_
+- _"포트원 V2 Kotlin 서버 SDK를 사용해 웹훅 검증을 구현해줘"_
+- _"포트원 V1 브라우저 SDK를 사용한 페이팔 결제창 호출을 구현해줘"_
+- _"파트너정산 자동화 서비스에 파트너 등록하는 코드를 타입스크립트로 구현해줘"_
+- _"포트원 V2 본인인증 기능 연동해줘"_
+
+#### 전반적인 질의 예시
+
+- _"포트원 V2와 V1의 차이점을 설명해줘"_
+- _"포트원 V2가 지원하는 PG사 목록 보여줘"_
+- _"포트원 API의 하위호환성 정책 설명해줘"_
+- _"포트원 파트너정산 자동화 서비스가 제공하는 기능들을 요약해줘"_

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

@@ -144,11 +144,11 @@ searchTags:
 - **데이터 표기 기준**
   - 카드결제 : 결제 요청시 지정된 결제수단 (pay\_method) 값이 card로 지정된 거래입니다.
   - 간편결제 : 결제요청시 지정된 결제수단 (pay\_method)이나 결제대행사(pg\_provider)가 간편결제(예: naverpay , kakaopay) 로 지정된 거래입니다.
-    - 결제 데이터 분석의 간편결제는 허브형 혹은 직계약에 상관없이 최종 상세 결제 수단으로 표기됩니다. (예: 카카오페이, 네이버페이)
+    - 결제 데이터 분석의 간편결제는 PG 제휴 혹은 직계약에 상관없이 최종 상세 결제 수단으로 표기됩니다. (예: 카카오페이, 네이버페이)
     - 참고
-      - 간편결제를 허브형으로 이용한 경우, 포트원 관리자 콘솔은 아래와 같이 별도 표기합니다.
-        - 결제대행사는 `허브형 계약된 결제대행사`로 노출 (ex: 결제대행사: KCP)
-        - 결제내역 상세 모달 내 결제대행사는 결제대행사 허브형ㅣ간편결제로 노출 (ex: 결제대행사: KCP 허브형 ㅣ 네이버페이 결제형)
+      - 간편결제를 PG를 통해 이용한 경우, 포트원 관리자 콘솔은 아래와 같이 별도 표기합니다.
+        - 결제대행사는 `일반 결제대행사`로 노출 (ex: 결제대행사: KCP)
+        - 결제내역 상세 모달 내 결제대행사는 결제대행사ㅣ간편결제로 노출 (ex: 결제대행사: KCP ㅣ 네이버페이 결제형)
 
 * **\[전체 결제수단] 페이지**
   - **국내결제**

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

@@ -15,6 +15,8 @@ tags:
 pgCompanies:
   - 공통
 searchTags:
+  - 현금영수증
+  - 본인인증
   - 네이버페이상품평
   - 본인인증조회
   - 정기결제캘린더
@@ -30,80 +32,80 @@ searchTags:
 
 
 
-**기준시각**
+##### **기준 시각**
 
 - 결제 요청 시각 : 결제가 요청된 시각을 기준으로 조회합니다.
-- 상태 승인 시각 : 결제상태가 업데이트된 최신 시각을 기준으로 조회합니다. \
+- 상태 승인 시각 : 결제 상태가 업데이트된 최신 시각을 기준으로 조회합니다. \
   (결제취소건의 경우 취소시각으로 적용됨)
 
 <Callout content="ex) 4월에 결제하고 5월에 취소한 거래를 > 상태 승인시각 04/01~04/30 기준으로  조회하면 결과에 포함되지 않습니다." title="조회기준에 따라 결과가 달라져요!" icon="💡 " />
 
-**내역검색**
-
-확인이 필요한 거래건을 특정하기 위하여 검색이 필요한 정보를 입력할 수 있습니다.
-
-- 전체 : 입력한 단어와 여러 결제 정보 필드 중 매칭되는 거래 건을 표시합니다. 여러 필드에서 일부 혹은 전부 일치하는 경우 검색 결과에 표시됩니다. 또한, 검색의 경우 단어의 앞에서부터 일치하는 경우에만 표시되며 중간만 일치하는 경우 원하는 검색 결과를 얻지 못할 수 있습니다.
-- 포트원 거래번호 : 포트원 거래번호 (imp\_uid) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
-- 가맹점 거래번호 : 가맹점 거래번호 (merchant\_uid) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
-- 주문명 : 주문명 (name) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
-- 카드사 승인번호 : 카드사 승인번호 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
-- 고객 이름 : 고객 이름 (buyer\_name) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
-- 고객 휴대폰 번호 : 고객 휴대폰 번호 (buyer\_tel) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
-- 고객 이메일 : 고객 이메일 (buyer\_email) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
-- 고객 주소 : 고객 주소 (buyer\_addr) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
-- 고객 우편번호 : 고객 우편번호(buyer\_postcode) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
-- 결제대행사 승인번호 : 결제대행사(PG사) 승인번호 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
-- 카드번호 : 카드번호 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다. 카드 번호의 경우 결제대행사에 따라 마스킹되는 부분이 다르므로, 앞에 6\~8자리(BIN)번호 혹은 뒷 4자리로 검색하시길 권장드립니다.
-- 상점아이디 : 결제대행사 상점아이디 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
-- 결제환경 : 결제환경(PC/MOBILE/API) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다. 검색하는 경우 대문자로 검색해야 합니다.
-- 실시간 계좌 은행 : 실시간 계좌이체 거래 건에 한하여 실시간 계좌 은행 데이터 중 입력한 택스트와 일치하는 데이터가 표시됩니다. (ex. 실시간 계좌이체 거래 건의 계좌은행이 토스뱅크인 경우 )
-- 가상계좌 은행 : 가상계좌 거래 건에 한하여 가상계좌 은행 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
-- 계좌번호 : 가상계좌 거래 건에 한하여 계좌번호 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
-- 입금자명 : 가상계좌 거래 건에 한하여 입금자명 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
-- 현금영수증 발급번호 : 실시간 계좌이체 또는 가상계좌 거래 시 현금영수증을 발급한 거래 건에 한하여 현금영수증 발급번호(국세청 승인번호) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
-- 취소 사유 : 결제 취소 건에 한하여 취소 사유 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다. 포트원 어드민콘솔에서 취소한 경우 취소 사유는 관리자페이지취소로 일괄 입력됩니다.
-- 카드사명 : 카드사명 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
-- 할부개월수 : 카드 결제 시 할부가 적용된 거래 건에 한하여 할부개월수 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
+**내역 검색**
+
+**확인이 필요한 거래건을 특정하기 위하여 검색이 필요한 정보를 입력할 수 있습니다.**
+
+- **전체** : 입력한 단어와 여러 결제 정보 필드 중 매칭되는 거래 건을 표시합니다. 여러 필드에서 일부 혹은 전부 일치하는 경우 검색 결과에 표시됩니다. 또한, 검색의 경우 단어의 앞에서부터 일치하는 경우에만 표시되며 중간만 일치하는 경우 원하는 검색 결과를 얻지 못할 수 있습니다.
+- **포트원 거래번호 :** 포트원 거래번호 (imp\_uid) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
+- **가맹점 거래번호 :** 가맹점 거래번호 (merchant\_uid) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
+- **주문명 :** 주문명 (name) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
+- **카드사 승인번호 :** 카드사 승인번호 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
+- **고객 이름 :** 고객 이름 (buyer\_name) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
+- **고객 휴대폰 번호 :** 고객 휴대폰 번호 (buyer\_tel) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
+- **고객 이메일 :** 고객 이메일 (buyer\_email) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
+- **고객 주소** : 고객 주소 (buyer\_addr) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
+- **고객 우편번호 :** 고객 우편번호(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)을 이용하실 경우에만 존재하는 결제상태로, 결제 및 환불 요청 완료 후 승인되기까지 결제상태를 의미합니다.
 
 **집계**
 
-- 순 거래액 : (조회된 결제내역 기준) 총 결제완료액 - 결제취소액
-- EXCEL 다운로드 : 조회된 내역을 excel 데이터로 다운로드 받을 수 있습니다.
+- **순 거래액** : (조회된 결제내역 기준) 총 결제완료액 - 결제취소액
+- **EXCEL 다운로드** : 조회된 내역을 excel 데이터로 다운로드 받을 수 있습니다.
 
 **조회결과**
 
-- 조회결과 항목 확인하기
-  - 결제상태 : 거래별로 해당되는 결제상태를 표기합니다. (결제상태는 ④번 항목을 자세히 참조해주세요.)
-  - UID/MID
-    - UID : 포트원의 주문번호. imp\_숫자12자리 형태입니다. \
+- **조회결과 항목 확인하기**
+  - **결제상태 :** 거래별로 해당되는 결제상태를 표기합니다.
+  - **UID/MID**
+    - **UID** : 포트원의 주문번호. imp\_숫자12자리 형태입니다. \
       (정기결제는 imps\_숫자12자리) 결제창이 호출되자마자 자동으로 생성/저장되는 번호.
-  - 상품명 : 결제요청시 지정하신 상품명(name)
-  - 고객정보 : 결제요청시 지정하신 고객명(buyer\_name)
-  - 결제수단 : 결제요청하신 결제수단
-  - 결제대행사 : 결제요청하신 결제대행사(PG사)
-  - 결제금액 : 총 결제금액
-  - 구분 : 정기(정기결제 실 연동), 테스트 | 정기(정기결제 테스트), 테스트 | 일반(일반결제 테스트) 으로 구분됩니다.
-  - 결제요청시각 / 상태승인시각 : 조회하신 기준시각 기준으로 적용된 시각. (검은바탕에는 일자가 표기됩니다)
-  - 취소 : 거래 취소를 위한 버튼
-  - ≡ : 거래 상세내역 조회를 위한 버튼
+  - **상품명** : 결제요청시 지정하신 상품명(name)
+  - **고객정보** : 결제요청시 지정하신 고객명(buyer\_name)
+  - **결제수단** : 결제요청하신 결제수단
+  - 결**제대행사** : 결제요청하신 결제대행사(PG사)
+  - **결제금액** : 총 결제금액
+  - **구분** : 정기(정기결제 실 연동), 테스트 | 정기(정기결제 테스트), 테스트 | 일반(일반결제 테스트) 으로 구분됩니다.
+  - **결제요청 시각 / 상태승인 시각 :** 조회하신 기준시각 기준으로 적용된 시각. (검은바탕에는 일자가 표기됩니다)
+  - **취소** : 거래 취소를 위한 버튼
+  - **≡ :** 거래 상세내역 조회를 위한 버튼
 
 
 
@@ -121,12 +123,12 @@ searchTags:
 
 ##### **조회 기준**
 
-- 상태별 최종 업데이트 일시(default) : 예약, 성공, 실패, 해지 상태 건에 대해 최종 업데이트 일시를 기준으로 조회합니다. (결제 예약건의 경우 예약 예정 시각을 기준으로 조회됩니다.)
-- 빌링결제 등록 일시 : 예약결제의 경우 예약건이 등록된 일시를 기준으로, 빌링키 일회성 결제 건의 경우 결제를 시도한 일시를 기준으로 조회합니다.
-- 오늘 : 오늘 00시 00분 00초부터 23시 59분 59초로 설정됩니다.
-- 최근7일 : 오늘을 기준으로 D-7일로 설정됩니다.
-- 이번 달 : 이번달 1일부터 말일까지로 설정됩니다.
-- 올해 : 올해 1월 1일부터 12월 31일까지로 설정됩니다.
+- **상태별 최종 업데이트 일시(default)** : 예약, 성공, 실패, 해지 상태 건에 대해 최종 업데이트 일시를 기준으로 조회합니다. (결제 예약건의 경우 예약 예정 시각을 기준으로 조회됩니다.)
+- **빌링결제 등록 일시** : 예약결제의 경우 예약건이 등록된 일시를 기준으로, 빌링키 일회성 결제 건의 경우 결제를 시도한 일시를 기준으로 조회합니다.
+- **오늘 :** 오늘 00시 00분 00초부터 23시 59분 59초로 설정됩니다.
+- **최근7일 :** 오늘을 기준으로 D-7일로 설정됩니다.
+- **이번 달** : 이번달 1일부터 말일까지로 설정됩니다.
+- **올해 :** 올해 1월 1일부터 12월 31일까지로 설정됩니다.
 
 ##### **필터**
 
@@ -134,25 +136,25 @@ searchTags:
 
 ##### **결제대행사**
 
-- 전체 : 모든 결제대행사의 거래를 조회합니다.
+- **전체** : 모든 결제대행사의 거래를 조회합니다.
 - 결제대행사 필터는 하나의 결제대행사에 모든 pg\_provider가 포함됩니다.
-  - KG 이니시스 : inicis, html5\_inicis, inicis\_v2
-  - 나이스페이먼츠 : nice, nice\_v2
-  - 페이팔 : paypal, paypal\_v2
-  - 스마트로 : smartro, smartro\_v2
-  - 토스페이 : tosspay, tosspay\_v2
-  - 토스페이먼츠 : uplus, tosspayments
+  - **KG 이니시스 :** inicis, html5\_inicis, inicis\_v2
+  - **나이스정보통신** : nice, nice\_v2
+  - **페이팔** : paypal, paypal\_v2
+  - **스마트로** : smartro, smartro\_v2
+  - **토스페이** : tosspay, tosspay\_v2
+  - **토스페이먼츠** : uplus, tosspayments
 
 ##### **내역검색**
 
 빌링 결제 정보를 검색하여 거래건을 특정할 수 있습니다.
 
-- 빌링결제 아이디 : 빌링결제 아이디(schedule\_id) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
-- 고객사 거래번호 : 고객사 거래번호(paymentId) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
-- 포트원 빌링키 : 포트원 빌링키(billingKey) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
-- 고객 식별 정보 : 고객식별정보 (customer.id) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
-- 고객 이름: 고객 이름 (customer.name) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
-- 상품 이름 : 상품 이름 (orderName) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
+- **빌링결제 아이디** : 빌링결제 아이디(schedule\_id) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
+- **고객사 거래번호** : 고객사 거래번호(paymentId) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
+- **포트원 빌링키** : 포트원 빌링키(billingKey) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
+- **고객 식별 정보** : 고객식별정보 (customer.id) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
+- **고객 이름** : 고객 이름 (customer.name) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
+- **상품 이름** : 상품 이름 (orderName) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
 
 ##### **리커버리**
 
@@ -168,11 +170,11 @@ searchTags:
 
 ##### **상태별 상세조회**
 
-- 전체 : 모든 빌링 결제 상태의 거래를 조회합니다.
-- 예약 : 예약 (status : Scheduled) 상태인 거래 건만 표시됩니다.
-- 성공 : 결제 대기 (status : Pending) 및 결제 성공 (status : Succeeded) 상태인 거래 건만 표시됩니다.
-- 실패 : 실패 (status : Failed) 상태인 거래 건만 표시됩니다.
-- 해지 : 해지 (status : Revoked) 상태인 거래 건만 표시됩니다.
+- **전체 :** 모든 빌링 결제 상태의 거래를 조회합니다.
+- **예약** : 예약 (status : Scheduled) 상태인 거래 건만 표시됩니다.
+- **성공** : 결제 대기 (status : Pending) 및 결제 성공 (status : Succeeded) 상태인 거래 건만 표시됩니다.
+- **실패** : 실패 (status : Failed) 상태인 거래 건만 표시됩니다.
+- **해지** : 해지 (status : Revoked) 상태인 거래 건만 표시됩니다.
 
 <Callout title="빌링결제 상태별 상세조회 보러가기 ↗" />
 
@@ -181,7 +183,7 @@ searchTags:
 <Callout content="빌링결제 캘린더에서는 빌링결제 건에 대한 월간/일간 데이터를 확인할 수 있습니다.
 " title="참고사항" icon="💡 " />
 
-##### 기준
+##### **기준**
 
 - 페이지 최초 진입 시 해당 월을 기준으로 데이터가 표시되며, 월을 조정하여 해당 월의 빌링결제 데이터를 확인할 수 있습니다.
 - 기본적으로 거래 금액을 기준으로 표시되며, 토글을 클릭하여 건수를 기준으로 데이터 확인이 가능합니다.
@@ -192,63 +194,174 @@ searchTags:
 
 #### **3. 현금영수증 관리**
 
-<Callout content="- 현재 현금영수증 관리 메뉴는 (구)관리자콘솔에서만 지원가능하며, 추후 신규 관리자콘솔에서도 기능이 추가될 예정입니다. 
-- API로 현금영수증 발행한 건에 한하여 조회가능합니다. (지원가능한 결제대행사 확인필요)" title="참고사항" icon="💡 " />
+현금영수증 내역 메뉴에서는 고객사에서 발급한 현금영수증을 조회·검색·필터링할 수 있습니다.
+
+포트원을 통해 결제된 거래뿐만 아니라, 포트원을 통해 결제되지 않은 자체 거래에 대해서도 현금영수증 발급/조회가 가능합니다.
+
+<Callout content="API로 현금영수증 발행한 건에 한하여 조회가능합니다. (지원가능한 결제대행사(PG사) 확인필요)" title="참고사항" icon="💡 " />
 
 
 
 **발급내역 구분**
 
-- 포트원 거래분 : 포트원을 통해 결제된 거래에 대한 현금영수증 발행분을 의미합니다.
+- **포트원 거래분 :** 포트원을 통해 결제된 거래에 대한 현금영수증 발행분을 의미합니다.
   - 발행 API : [POST `/receipts/{imp_uid}`](https://developers.portone.io/api/rest-v1/receipt#get%20%2Freceipts%2F%7Bimp_uid%7D)
-- 고객사 자체 거래분 : 포트원을 통해 결제되지 않은 거래에 대한 현금영수증 발행분을 의미합니다.
+- **고객사 자체 거래분** : 포트원을 통해 결제되지 않은 거래에 대한 현금영수증 발행분을 의미합니다.
   - 발행 API : [POST `/receipts/external/{merchant_uid}`](https://developers.portone.io/api/rest-v1/receipt#post%20%2Freceipts%2Fexternal%2F%7Bmerchant_uid%7D)\`(포트원을 통해 결제되지 않은 건이어도 위 API로 현금영수증 발행이 가능합니다)
 
-**조회기준**
+**조회 및 검색**
 
-- \#포트원 거래고유번호(imp\_uid) : 거래건별 포트원의 고유번호로 검색가능합니다.
-- \#고객사 주문번호(merchant\_uid) : 거래건별 고객사에서 지정하신 고유번호로 검색가능합니다.
-- \#발급상태 : 전체, 발급, 취소 로 검색가능합니다.
-- \#검색기간(발급/취소일자) : 달력으로 검색기간 조정이 가능합니다.
 
-**조회결과**
 
-- 발행PG사 : 발행된 PG사명
-- 포트원 거래고유번호(imp\_uid) : 거래건별 포트원의 고유번호
-- 고객사 주문번호(merchant\_uid) : 거래건별로 고객사에서 지정하신 고유번호
-- 결제일자 : 거래가 승인된 결제일
-- 현금영수증 발급번호 : 현금영수증 발급후 응답되는 발급번호
-- 발급유형(type) : 소득공제용 혹은 지출증빙용
-- 발급상태 : 발급여부 노출
-- 발급일자 : 현금영수증 발급일자
-- 발급취소일자 : (발급 취소된 경우) 취소일자
-- 발급금액총계(부가세) : 총금액(부가세) 표기
+- 조회 기준
+
+<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. 본인인증 조회**
 
-**본인인증 내역**
+##### **본인인증 내역**
 
-<Callout content="- 본인인증 조회 메뉴는 (구)관리자콘솔에서만 지원가능합니다. 
-- 추후 신규 관리자콘솔에서도 기능이 추가될 예정입니다." icon="💡 " title="참고사항" />
+본인인증 내역 메뉴에서는 고객사의 인증 시도 기록을 조회, 검색, 필터링할 수 있습니다.
 
+신규 관리자 콘솔과 API를 통해 본인인증 내역 확인이 가능하며, 인증 성공 여부와 인증자의 정보를 한눈에 확인할 수 있습니다.
 
+<Callout content="- 인증이 성공하지 않은 건은 인증자의 상세 데이터가 없는 것이 정상입니다.
+- 결제대행사별 정책에 따라 일부 정보(통신사, 휴대폰번호 등)가 제공되지 않을 수 있습니다.
+- 조회 가능한 최대 기간은 6개월입니다." icon="💡 " title="참고사항" />
 
-**조회기준**
 
-- 조회조건 : 조건없음, 포트원 거래고유번호, 고객사 주문번호
-- 조회기간(본인인증 시도시각 기준) : 본인인증 시도시각 기준으로 조회기간/시각 설정가능
-- 조회건수 : 100건, 500건, 1000건
 
-**조회결과**
+##### **조회 및 검색**
+
+
+
+- 조회 기준
+
+<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사)
+- 성별
+- 통신사
+
+##### 정렬 및 컬럼
+
+- 시도시각과 인증시각을 인증/실패 시각 단일 컬럼에서 확인할 수 있습니다.
+- 상태 승인 시각 기준 (오름/내림차순)으로 정렬 가능합니다.
+
+##### 조회 결과 (테이블)
 
-<Callout content="" title="인증이 성공하지 않은 건은 인증자의 상세 데이터가 없는 것이 정상입니다!" icon="⚠️" />
+- 인증상태 : 인증 완료 / 실패
+- 상태 승인 시각 : 인증이 완료되거나 실패한 시각
+- 고객사 본인인증 아이디 : 고객사에 부여된 본인인증 구분 번호
+- PG사 본인인증 아이디 : PG사에서 부여된 본인인증 구분 번호
+- 결제대행사 : 인증 시도 PG사
+- PG MID : 인증 성공 시 PG사에서 응답된 거래번호
+- 이름 : 인증 대상자 이름
+- 성별 : 인증 대상자 성별
+- 생년월일 : 인증 대상자 생년월일
+- 통신사 : 인증 대상자 통신사
+- 전화번호 : 인증 대상자 휴대폰 번호
+- 포트원 본인인증 아이디 : 포트원에서 부여한 본인인증 건별 고유 번호
 
-- imp\_uid : 본인인증 건별로 부여되는 고유 주문번호 (포트원에서 자동생성됩니다)
-- merchant\_uid : 본인인증 건별로 지정하시는 고객사의 고유 주문번호 (인증창 호출시 고객사에서 지정합니다)
-- PG사/PG상점아이디 : 시도하신 PG사와 상점아이디
-- PG사 거래번호 : 인증성공시 PG사에서 응답된 거래번호
-- 이름/성별/생년월일/통신사,전화번호/인증여부/시도시각,인증시각
-  - 인증성공시 인증자의 정보(다날 본인인증의 경우 별도 요청하지 않으신 경우 통신사,휴대폰번호 정보 확인이 불가합니다.
+<Callout content="다날 본인인증의 경우 별도 요청하지 않으신 경우 통신사, 휴대폰번호 정보 확인이 불가합니다. 추가 정보 취득방법 가이드 참고하셔서 별도 신청 해주셔야 합니다. " icon="💡 " title="참고사항" />
 
 <Callout title="휴대폰 본인인증 추가 정보 취득방법 보러가기 ↗" />