@portone/mcp-server 0.13.0

package/assets/docs/opi/ko/console/guide/connect.md

@@ -0,0 +1,84 @@
+---
+title: 결제 연동 하기
+description: ''
+targetVersions:
+  - v1
+---
+
+## 결제 연동 체계
+
+- 결제 채널이란: 결제의 객체를 칭하는 명칭으로써 결제 대행사가 발급해준 credential 단위로 이루어
+  집니다. 해당 결제 채널을 고객사가 직접 사용하시거나 고객사의 하위상점에게 할당해 주실 수 있습니다.
+
+- 실연동 : 전자 결제 신청하기를 통해서 선택 및 계약하신 결제대행사의 credential을 입력하시면 해당
+  결제 채널을 생성하여 sdk `imp.request_pay()` 에 해당 정보를 넣고 실 결제를 진행하실 수 있습니다.
+
+- 테스트 연동: 네이버 페이, 토스, 페이팔을 제외한 모든 결제대행사의 테스트 credential을 사용하실 수
+  있습니다. 네이버 페이, 토스, 페이팔은 직접 결제대행사로부터 발급 받으시길 바랍니다.
+
+- 결제 연동 화면에서는 고객사 및 고객사 소속의 하위상점 별 해당되는 위 정보를 등록, 확인, 수정 하실
+  수 있습니다.
+
+## 웹훅 관리
+
+웹훅은 가상계좌, 정기결제를 이용하시는 경우 필수 설정사항이지만,그 외에도 안정적인 결제서비스 구축을 위해 강력히 권장드리는 기능입니다. 설정 방법은 다음과 같습니다.
+
+[이미지 링크](<https://developers.portone.io/gitbook-assets/ko/Screen Shot 2022-11-18 at 2.56.49 PM.png>)
+
+
+
+- 웹훅(Notification)발송 공통 URL : 웹훅통지를 받으실 고객사 서버의 url을 기재해주세요.
+- 호출테스트 : 기입하신 url로 수신받으실 수 있는지 호출 테스트를 해보실 수 있습니다.
+
+## 테스트 연동 관리
+
+[이미지 링크](<https://developers.portone.io/gitbook-assets/ko/Screen Shot 2022-11-18 at 3.06.39 PM.png>)
+
+
+
+- 테스트 연동 관리에서 고객사가 결제 테스트를 하실 수 있는 각 결제대행사 별 테스트 상점아이디 와 그
+  외 credential 정보를 제공합니다.
+
+- 특정 결제대행사의 결제를 테스트하기 위해서는 `imp.request_pay(pg = '테스트 PG.테스트 상점아이디')`
+  방식으로 호출하시면 됩니다.
+
+- 페이팔, 네이버페이 와 같은 결제대행사는 직접 해당 결제대행사로 부터 테스트 상점아이디를 발급받으신
+  뒤 해당 결제대행사의 테스트 카드에 `정보 수정` 을 누른뒤 입력 및 등록 하신후 사용하실 수 있습니다.
+
+## 실 연동 관리
+
+[이미지 링크](<https://developers.portone.io/gitbook-assets/ko/Screen Shot 2022-11-18 at 3.07.49 PM.png>)
+
+
+
+[이미지 링크](<https://developers.portone.io/gitbook-assets/ko/Screen Shot 2022-11-18 at 3.08.11 PM.png>)
+
+
+
+- 실 연동 채널 카드는 전자 결제 신청하기를 통해 신청하신 결제대행사 결제 형태에 따라 각각 생성할 수
+  있습니다. 즉 결제대행사로부터 발급 받으신 상점아이디 및 그 외 credential을 입력하실 수 있는 카드를
+  모듈에 맞게 생성 하실 수 있습니다. 생성된 카드에 `정보 수정` 을 누른뒤 정보를 입력 및 저 하신뒤
+  해당 결제채널 정보로 실결제를 진행하실 수 있습니다.
+
+- 동일한 pg 사더라도 결제 수단이나 결제 유형에 따라 상이한 모듈을 생성하실 수 있습니다. 이는 각 채널
+  카드에 상점아이디와 그 외 credential 을 입력하셔야 합니다.
+  - 결제 유형: 결제창 방식의 일반결제, 간편결제, 정기결제 와 api 호출 방식의 키인 결제와 정기결제에
+    따라서 동일 결제대행사 내에서 상점아이디가 개별로 발급됩니다.
+
+  - 결제 수단: 동일 pg사여도 결제 수단에 따라 상점아이디가 개별 발급되는 경우가 있습니다.
+
+  - 그 외에도 계약 과정에서 복수 MID 발급을 신청하신 경우가 있습니다.
+
+## 추가 설정 관리
+
+![](</gitbook-assets/ko/image (171).png>)
+
+- 추가 설정 관리 화면에서는 `화이트리스트 설정` 과 `내 식별코드, API Keys` 를 확인하실 수 있습니다.
+
+- 화이트 리스트 : 포트원 관리자의 IP보안설정에 입력하는 값은 IP가 아닌 CIDR 블록방식 으로 입력하셔야
+  합니다. 예를 들어 입력 하시고자 하는 IP가 `1.1.1.1` 이라고 가정 했을때 해당 IP 하나만 허용하고
+  싶으시다면 `1.1.1.1/32`로 작성 하셔야 하고 만약 `1.1.1.1` \~ `1.1.1.255`까지의
+  IP대역을 모두 허용하고 싶으시다면 `1.1.1.0/24` 형태로 작성하시면 됩니다. 보다
+  자세한 표기법은 [RFC4632](https://tools.ietf.org/html/rfc4632) 를 참고부탁드립니다.
+
+![](</gitbook-assets/ko/image (338).png>)

package/assets/docs/opi/ko/console/guide/home.md

@@ -0,0 +1,37 @@
+---
+title: 홈
+description: >-
+  포트원 콘솔 홈화면에서는 결제 현황 대시보드, 공지사항, FAQ, 포트원 새소식, 포트원 서비스 가이드 링크를 제공하고 있으며, 이에 대해
+  안내합니다.
+---
+
+(이미지 첨부: 관리자콘솔-홈 화면 예시)
+
+## 대시보드
+
+1주/1개월/6개월/사용자 선택 기간에 따른 일간 결제 데이터를 확인할 수 있습니다.
+아직 실 결제가 일어나지 않은 경우 오른쪽 상단에 \[테스트 데이터]를 활성화하여 대시보드 그래프 예시 등을
+확인할 수 있습니다.
+
+- 거래액 : 결제승인이 발생한 모든 금액이 표시됩니다. 현재 결제 상태가 승인(`PAID`)
+  혹은 취소(`CANCELLED`/`PARTIAL_CANCELLED`) 거래건이 모두 집계됩니다.
+
+- 거래취소액 : 결제 승인 이후 결제 취소된 금액이 표시됩니다. 전액 취소(`CANCELLED`) 및 부분 취소(`PARTIAL_CANCELLED`) 거래건이 모두 집계됩니다.
+
+- 순거래액 : 거래액에서 거래취소액을 제외한 금액이 표시됩니다.
+
+## 공지사항
+
+포트원의 최신 공지사항을 확인할 수 있습니다. 우측 상단의 \[더보기]를 클릭하여 더 많은 공지사항을 확인해 보세요.
+
+## FAQ
+
+포트원의 FAQ를 확인할 수 있습니다. 우측 상단의 \[더보기]를 클릭하여 더 많은 FAQ를 확인해 보세요.
+
+## 포트원 새소식
+
+포트원의 새로운 소식을 확인할 수 있습니다. 우측 상단의 \[더보기]를 클릭하여 포트원 블로그에서 더 많은 소식을 확인해 보세요.
+
+## 포트원 서비스 가이드
+
+포트원 서비스에 대한 이용 가이드를 확인할 수 있습니다.

package/assets/docs/opi/ko/console/guide/integration.md

@@ -0,0 +1,18 @@
+---
+title: 연동 관리
+description: >-
+  포트원 결제 모듈을 사용하기 위한 연동 설정을 관리할 수 있습니다. 결제대행사 채널 관리, 식별코드 및 API Keys, 결제알림(웹훅)
+  관리, 추가 설정 관리 방법에 대해 안내합니다. 
+targetVersions:
+  - v1
+  - v2
+---
+
+포트원 연동 시 필요한 사항들을 설정 및 관리할 수 있습니다.
+
+연동 정보 탭에서는 채널관리, 식별코드·API Keys, 결제알림(Webhook)관리, 추가 설정 관리 등을 설정할 수 있고,
+스마트 라우팅 탭에서는 스마트 라우팅 그룹을 설정할 수 있습니다.
+
+[연동 정보](https://developers.portone.io/opi/ko/console/guide/channel-manage)
+
+[스마트 라우팅](https://developers.portone.io/opi/ko/console/guide/smartrouting)

package/assets/docs/opi/ko/console/guide/list.md

@@ -0,0 +1,183 @@
+---
+title: 결제 내역
+description: 결제가 이루어진 거래내역을 조회할 수 있는 메뉴입니다.
+targetVersions:
+  - v1
+---
+
+## 결제내역 체계
+
+결제내역 화면에서는 결제가 이루어진 내역을 확인할 수 있는 화면입니다.
+
+- 결제가 시도된 날짜의 범위를 필터할 수 있는 캘린더 필터
+- 결제내역의 특정 데이터를 지정하여 혹은 미지정시 전체 데이터를 통합검색을 할수 있는 통합검색
+- 결제 상태, 수단, 대행사, 유형, 모드 를 지정하여 검색 할 수 있는 필터
+- 검색된 내역 결과를 상태별로 통계화 한 상태별 결제건
+- 결제 상태, 고객정보, 결제 수단, 결제 대행사, 결제 금액, 구분, 요청시각, 완료시각을 확인할 수 있는 결제내역 리스트 뷰
+- 해당 내역의 특정 결제건의 우측 코너를 클릭하여 MID, UID 복사 및 결제취소 기
+- 해당 내역의 특정 결제건을 클릭하여 확인할 수 있는 결제내역 상세정보
+- 해당 내역의 특정 결제건을 클릭하여 수행 할 수 있는 결제 취소 기능
+- 해당 내역의 특정 결제건을 클릭하여 수행 할 수 있는 웹훅 재전송 기능
+- 검색된 내역의 총 거래액 - 총 환불액의 계산을 통하여 통화별로 확인 할 수 있는 총 매출액 기능
+- 기본 결제내역 값들과 추가적으로 고객정보, 결제 대행사 정보, 카드결제 정보, 계좌결제 정보 를 선택하여 내역을 다운받을 수 있는 엑셀 다운로드 기능
+
+위 기능들로 구성되어 있는 화면입니다.
+
+## 캘린더 필터
+
+![](</gitbook-assets/ko/Screen Shot 2022-06-20 at 5.23.19 PM.png>)
+
+- 결제 요청시각 기준으로 검색하고 싶은 결제 내역의 시작 날짜 및 시각과 끝 날짜 및 시각과 끝을 지정 합니다.
+  - 결제 요청이란 고객사의 고객이 결제를 시도한 시점입니다.
+  - 따라서 결제 환불 및 완료 시간 기준으로는 해당 날짜 기간안 이후로 벗어 날 수 있습니다.
+
+- 년, 월, 일, 시, 분 단위까지 지정하실 수 있습니다.
+
+- 편의를 위해 오늘, 어제, 과거 7일, 30일, 90일 버튼을 누르셔서 빠르게 세팅 하실 수 있습니다.
+
+- 캘린더 UI를 통해서가 아니라 직접 기간을 입력하셔서 사용하실 수 있습니다.
+
+## 통합 검색
+
+![](</gitbook-assets/ko/Screen Shot 2022-06-20 at 5.36.36 PM.png>)
+
+- 결제내역의 특정값을 지정하시거나 모든 결제관련 값에 대해서 직접 입력하신 값을 검색하는 기능입니다.
+
+- 통합검색 필터는
+
+  - 포트원 거래번호
+  - 고객사 거래번호
+  - 카드사 승인번호
+  - 고객 이름
+  - 고객 휴대폰번호
+  - 고객 이메일
+  - 결제대행사 승인번호
+  - 카드번호
+  - 상점아이디
+  - 결제환경
+  - 실시간 계좌 은행
+  - 가상계좌 은행
+  - 계좌번호
+  - 입금자명
+  - 현금영수증 발급번호
+  - 고객 주소
+  - 취소 사유
+  - 결제환경 상세
+  - 주문명
+
+  으로 이루어져 있습니다.
+
+- 검색 로직은 like %value 입니다. 즉 값의 맨 앞에서부터 일치하는 값을 리턴합니다.
+  - 추후에 주문명과 고객 주소는 like %value%로 업데이트 될 예정입니다.
+
+## 필터
+
+![](</gitbook-assets/ko/Screen Shot 2022-06-20 at 6.27.42 PM.png>)
+
+- 결제상태, 결제수단, 결제대행사, 결제 유형, 결제 모드 를 필터하신뒤 결제 내역을 검색 하실수 있습니다.
+  - 결제상태: 전체, 결제예정, 결제완료, 전체취소, 부분취소, 결제실패
+  - 결제수단: 사용하시는 결제 수단 값
+  - 결제 대행사: 사용하시는 결제 대행사 값
+  - 결제유형: 전체, 정기결제, 일반결제
+  - 결제모드: 전체, 실결제, 테스트 결제
+
+## 상태별 결제 통계
+
+![](</gitbook-assets/ko/Screen Shot 2022-06-20 at 6.37.46 PM.png>)
+
+- 전체, 결제완료, 결제예정, 결제실패, 결제취소 로 이루어져있습니다. 검색된 전체 내역을 상태마다 분류하여 통계를 보여줍니다.
+  - 결제 실패는 부분 취소와 전액 취소가 포함된 상태값입니다.
+
+## 결제내역 리스트
+
+![](</gitbook-assets/ko/image (277).png>)
+
+- 결제내역 리스트뷰는 캘린더 필터, 통합검색, 필터검색에 따라 검색된 결제 내역들을 보여줍니다.
+
+- 캘린더 필터, 통합검색, 필터검색을 설정하지 않은체 나오는 기본 내역은 현 일자부로 6개월치 전체
+  결제내역 데이터를 보여줍니다.
+
+- 보여지는 값들은 결제상태, 고객정보, 결제수단, 결제대행사, 결제금액, 구분, 요청시각, 승인시각
+  입니다.
+  - 고객정보는 결제시 sdk에 입력하신 고객의 이름, 이메일, 전화번호 이며 해당 순서대로 값이 있는
+    순으로 보여집니다.
+
+  - 구분은 일반결제, 정기결제, 테스트결제를 표기하며 일반결제는 빈값으로 표기됩니다.
+
+- 요청시각 및 승인시각은 내림차순으로 보여지며 요청시각 기준으로 보일지 승인시각 기준으로 보일지는
+  해당 값을 클릭하신뒤 선택하실 수 있습니다.
+
+- 결제내역 리스트의 특정 결제건의 우측 을 누르시면 고객사 거래번호(merchant\_uid) 및 포트원 거래번호
+  (imp\_uid) 를 복사하실 수 있고 결제완료, 부분취소 건에 한해서 결제취소를 하실 수 있습니다.
+
+## 결제내역 상세정보
+
+![](</gitbook-assets/ko/Screen Shot 2022-06-20 at 7.06.01 PM.png>)
+
+- 결제내역 상세정보는 고객정보 섹션과 결제정보 섹션으로 나눠집니다.
+
+- 고객정보는 고객사가 sdk 로 전달하시는 결제하는 고객의 이름, 전화번호, 이메일, 주소 입니다.
+
+- 결제 정보는
+
+  - 결제상태
+
+  - 포트원 거래번호
+
+  - 결제수단
+    - 신용카드 일경우 매입사 및 마스킹된 카드번호가 보여집니다.
+    - 가상계좌일 경우 계좌 은행, 예금주, 계좌번호, 입금시간이 보여집니다.
+    - 계좌이체 일 경우 계좌 은행 이 보여집니다.
+    - 휴대폰 소액 결제일 경우 통신사가 보여집니다.
+
+  - 총결제금액
+    - 총 결제금액은 주문금액 - 할인금액 입니다.
+
+  - 주문금액
+
+  - 공급가액(부가세)
+
+  - 포인트 결제금액
+    - 포인트 결제금액은 간편결제사 및 결제 대행사의 포인트를 지칭합니다.
+
+  - 할인금액
+    - 할인금액은 pg사 전문에서 내려주는 값입니다. pg사마다 유무가 다를 수 있는점 유의해 주시기 바랍니다.
+
+  - 카드사 승인번호
+
+  - 상점 아이디
+
+  - 결제대행사
+
+  - 결제대행사 승인번호
+    - 결제대행사 승인번호란 결제대행사에서 부여하는 결제 id 입니다.
+
+  - 결제환경
+    - 결제환경이란 결제된 기기 및 웹/앱의 환경값을 파씽한 값입니다.
+
+  이 있습니다.
+
+## 결제 취소
+
+![](</gitbook-assets/ko/Screen Shot 2022-06-20 at 8.28.25 PM.png>)
+
+![](</gitbook-assets/ko/Screen Shot 2022-06-20 at 8.28.37 PM (1).png>)
+
+- 결제내역 상세 내에 결제 취소를 하실 수 있습니다. 해당 페이지는 결제 완료 및 부분취소 인 결제건에 대해서는 바로들어가실 수 있습니다.
+
+- 기본 세팅은 전액 환불로 되있으며 부분환불을 원하시는 경우는 환불 금액을 수정해주시거나 부분환불 클릭후 수정해주신뒤 하단의 결제취소 버튼을 누르면 됩니다.
+
+- 취소를 입력하시면 포트 데이터 및 pg사에게 취소 사유 값이 저장 및 전달됩니다.
+
+- 해당 취소건에 면세 공급가액이 포함되있을경우 해당되는 면세 공급가액 취소분을 입력하시면 됩니다.
+
+- 관리자 콘솔에서 취소를 하셨을시 고객사의 db에 상태 업데이트를 위해 웹훅 전송을 하게됩니다.
+
+- 가상계좌의 경우 환불계좌 정보를 추가 입력하실 수 있습니다.
+  - 환불계좌 은행
+  - 환불계좌 계좌번호
+  - 환불계좌 예금주
+
+## 웹훅 재발송
+
+![](</gitbook-assets/ko/Screen Shot 2022-06-20 at 8.44.01 PM.png>)

package/assets/docs/opi/ko/console/guide/pay.md

@@ -0,0 +1,14 @@
+---
+title: 결제
+description: 포트원을 관리자콘솔을 통해 발생한 거래를 조회 및 관리하는 방법을 안내합니다.
+---
+
+포트원을 통해 발생한 결제 거래 건을 조회하고 부분 취소 및 전체 취소 기능을 이용하여 결제 건을 관리할 수 있습니다.
+엑셀 다운로드 기능을 제공하여 화면에서 필터링된 결제 내역을 다운로드 받아 활용할 수 있습니다.
+
+또한 발급한 빌링키를 이용한 결제 거래 건을 별도 내역으로 확인할 수 있으며, 빌링 결제 예약건을 상태별로
+관리할 수 있고, 빌링 결제 캘린더에서 일간/월간 결제 데이터를 확인할 수 있습니다.
+
+[결제 내역 조회](https://developers.portone.io/opi/ko/console/guide/payments)
+
+[빌링결제 내역 조회](https://developers.portone.io/opi/ko/console/guide/billing-payments)

package/assets/docs/opi/ko/console/guide/payments.md

@@ -0,0 +1,298 @@
+---
+title: 결제 내역 조회
+description: >-
+  포트원을 통해 발생한 결제 내역을 상태별로 조회하고, 부분 취소 및 전체 취소 기능을 이용하여 결제 건을 관리할 수 있으며, 이에 대해
+  안내합니다.
+targetVersions:
+  - v1
+  - v2
+---
+
+(관련 이미지 첨부)
+
+## 기준 시각
+
+- **상태 승인 시각**(default) : 최종 결제 상태로 업데이트된 시각을 기준으로 조회합니다.
+  (결제 취소건의 경우 취소 시각을 기준으로 조회됩니다.)
+
+- **결제 요청 시각** : 결제를 요청한 시각을 기준으로 결제 건을 조회합니다.
+
+<div class="hint" data-style="info">
+
+**기준 시각에 따라 조회 결과가 다르게 표시됩니다.**
+
+예를 들어 4/1 결제 후 4/5에 결제 취소한 경우, 상태 승인 시각을 기준으로 4/1\~4/4로 기간을 설정한 후
+검색하면 해당 거래건은 결과에 포함되지 않습니다.
+
+</div>
+
+## 내역 검색
+
+결제 정보를 검색하여 거래건을 특정할 수 있습니다.
+
+<ul>
+
+<li>
+
+**전체** : 입력한 단어와 여러 결제 정보 필드 중 매칭되는 거래 건을 표시합니다.
+여러 필드에서 일부 혹은 전부 일치하는 경우 검색 결과에 표시됩니다.
+또한, 검색의 경우 단어의 앞에서부터 일치하는 경우에만 표시되며 중간만 일치하는 경우 원하는 검색 결과를 얻지 못할 수 있습니다.
+
+</li>
+
+<li>**포트원 거래번호** : 포트원 거래번호 (`imp_uid`) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.</li>
+
+<!-- VERSION-SPECIFIC: V1 ONLY CONTENT START -->
+
+<li>**가맹점 거래번호** : 가맹점 거래번호 (`merchant_uid`) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.</li>
+<li>**주문명** : 주문명 (`name`) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.</li>
+<li>**카드사 승인번호** : 카드사 승인번호 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.</li>
+<li>**고객 이름** : 고객 이름 (`buyer_name`) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.</li>
+<li>**고객 휴대폰 번호** : 고객 휴대폰 번호 (`buyer_tel`) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.</li>
+<li>**고객 이메일** : 고객 이메일 (`buyer_email`) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.</li>
+<li>**고객 주소** : 고객 주소 (`buyer_addr`) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.</li>
+<li>**고객 우편번호** : 고객 우편번호(`buyer_postcode`) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.</li>
+
+<!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
+
+<!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
+
+<li>**가맹점 거래번호** : 가맹점 거래번호 (`paymentId`) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.</li>
+<li>**주문명** : 주문명 (`orderName`) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.</li>
+<li>**카드사 승인번호** : 카드사 승인번호 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.</li>
+<li>**고객 이름** : 고객 이름 (`customer.fullname`) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.</li>
+<li>**고객 휴대폰 번호** : 고객 휴대폰 번호 (`customer.phoneNumber`) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.</li>
+<li>**고객 이메일** : 고객 이메일 (`customer.email`) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.</li>
+<li>**고객 주소** : 고객 주소 (`customer.address`) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.</li>
+<li>**고객 우편번호** : 고객 우편번호(`customer.zipcode`) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.</li>
+
+<!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
+
+<li>**결제대행사 승인번호** : 결제대행사(PG사) 승인번호 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.</li>
+
+<li>
+
+**카드번호** : 카드번호 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
+카드 번호의 경우 결제대행사에 따라 마스킹되는 부분이 다르므로, 앞에 6\~8자리(BIN)번호 혹은 뒷 4자리로 검색하시길 권장드립니다.
+
+</li>
+
+<li>**상점아이디** : 결제대행사 상점아이디 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.</li>
+<li>**결제환경** : 결제환경(PC/MOBILE/API) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다. 검색하는 경우 대문자로 검색해야 합니다.</li>
+
+<li>
+
+**실시간 계좌 은행** : 실시간 계좌이체 거래 건에 한하여 실시간 계좌 은행 데이터 중 입력한 택스트와 일치하는 데이터가 표시됩니다.
+(ex. 실시간 계좌이체 거래 건의 계좌은행이 토스뱅크인 경우 )
+
+</li>
+
+<li>**가상계좌 은행** : 가상계좌 거래 건에 한하여 가상계좌 은행 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.</li>
+<li>**계좌번호** : 가상계좌 거래 건에 한하여 계좌번호 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.</li>
+<li>**입금자명** : 가상계좌 거래 건에 한하여 입금자명 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.</li>
+
+<li>
+
+**현금영수증 발급번호** : 실시간 계좌이체 또는 가상계좌 거래 시 현금영수증을 발급한 거래 건에 한하여
+현금영수증 발급번호(국세청 승인번호) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
+
+</li>
+
+<li>
+
+**취소 사유** : 결제 취소 건에 한하여 취소 사유 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
+포트원 어드민콘솔에서 취소한 경우 취소 사유는 **관리자페이지취소**로 일괄 입력됩니다.
+
+</li>
+
+<li>**카드사명** : 카드사명 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.</li>
+<li>**할부개월수** : 카드 결제 시 할부가 적용된 거래 건에 한하여 할부개월수 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.</li>
+
+</ul>
+
+## 필터
+
+필터에 따라 결제 내역을 필터링하여 조회할 수 있습니다. 필터는 결제상태, 결제수단, 결제대행사, 결제유형, 결제모드에 따라 다중 선택할 수 있습니다.
+
+### 결제상태
+
+- **전체** : 모든 결제 상태의 거래를 조회합니다.
+
+- **결제 완료** : **결제 완료** (status : PAID) 상태인 거래 건만 표시됩니다. 결제 취소건은 포함되지 않습니다.
+
+- **결제 예정** : **결제 예정** (status : READY) 상태인 거래 건만 표시됩니다.
+  - 결제창이 화면에 표시되는 순간 결제 예정 상태로 거래 건이 저장됩니다.
+
+  - 일반적으로 결제 승인이되면 결제 완료 상태로 업데이트 됩니다. 다만, 결제 도중 모종의 이유로 고객이 결제창을 이탈하는 경우에는
+    해당 거래 건은 계속 결제 예정 상태로 남게 됩니다.
+
+- **결제 실패** : **결제 실패** (status : FAILED) 상태인 거래 건만 표시됩니다.
+
+- **결제 취소** : **전체 취소** (status : CANCELLED) 및 **부분 취소** (PARTIAL\_CANCELLED) 상태인 거래 건만 표시됩니다.
+
+- **승인 대기** : **승인 대기** (status : PENDING) 상태인 거래 건만 표시됩니다.
+  - 승인 대기 상태는 페이팔(SPB/RT) 거래 건에서만 발생하며, 결제 및 환불 요청 완료 후 실제 승인되기까지 결제상태를 의미합니다.
+
+### 결제수단
+
+<ul>
+
+<li>**전체** : 모든 결제 수단의 거래를 조회합니다.</li>
+
+<!-- VERSION-SPECIFIC: V1 ONLY CONTENT START -->
+
+<li>
+
+**카드결제** : 결제 요청 시 결제 수단을 카드(`pay_method : card`)로 지정하여 호출한 뒤
+신용카드, 체크카드, 법인카드, 기프트카드 등 카드로 진행된 거래 건만 표시됩니다.
+
+</li>
+
+<li>
+
+**실시간 계좌이체** :  결제 요청 시 결제 수단을 실시간 계좌이체(`pay_method : trans`)로
+지정하여 호출한 뒤 계좌이체로 진행된 거래 건만 표시됩니다.
+
+</li>
+
+<li>
+
+**가상계좌** : 결제 요청 시 결제 수단을 가상계좌 (`pay_method : vbank`)로
+지정하여 호출한 뒤 가상계좌로 진행된 거래 건만 표시됩니다.
+
+</li>
+
+<li>
+
+**휴대폰 소액결제** : 결제 요청 시 결제 수단을 휴대폰 소액결제 (`pay_method : phome`)로
+지정하여 호출한 뒤 휴대폰 소액결제로 진행된 거래 건만 표시됩니다.
+
+</li>
+
+<li>
+
+**문화상품권** : 결제 요청 시 결제 수단을 문화상품권 (`pay_method : culturegift`)로 지정하여 호출한 뒤
+문화상품권으로 진행된 거래 건만 표시됩니다. 문화상품권의 경우 웰컴페이먼츠만 지원합니다.
+
+</li>
+
+<li>
+
+**컬쳐랜드** : 결제 요청 시 결제 수단을 컬쳐랜드 문화상품권 (`pay_method : cultureland`)로 지정하여 호출한 뒤
+컬쳐랜드 문화상품권으로 진행된 거래 건만 표시됩니다.
+
+</li>
+
+<li>
+
+**스마트문상** : 결제 요청 시 결제 수단을 스마트문상(`pay_method : smartculture`)로 지정하여 호출한 뒤
+스마트문상 ((구)게임문화상품권)으로 진행된 거래 건만 표시됩니다.
+
+</li>
+
+<li>
+
+**북앤라이프** : 결제 요청 시 결제 수단을 북앤라이프(`pay_method : booknlife`)로 지정하여 호출한 뒤
+도서문화상품권으로 진행된 거래 건만 표시됩니다.
+
+</li>
+
+<!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
+
+<!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
+
+<li>
+
+**카드결제** : 결제 요청 시 결제 수단을 카드(`payMethod : CARD`)로 지정하여 호출한 뒤
+신용카드, 체크카드, 법인카드, 기프트카드 등 카드로 진행된 거래 건만 표시됩니다.
+
+</li>
+
+<li>
+
+**실시간 계좌이체** :  결제 요청 시 결제 수단을 실시간 계좌이체(`payMethod : TRANSFER`)로
+지정하여 호출한 뒤 계좌이체로 진행된 거래 건만 표시됩니다.
+
+</li>
+
+<li>
+
+**가상계좌** : 결제 요청 시 결제 수단을 가상계좌 (`payMethod : VIRTUAL_ACCOUNT`)로
+지정하여 호출한 뒤 가상계좌로 진행된 거래 건만 표시됩니다.
+
+</li>
+
+<li>
+
+**휴대폰 소액결제** : 결제 요청 시 결제 수단을 휴대폰 소액결제 (`payMethod : MOBILE`)로
+지정하여 호출한 뒤 휴대폰 소액결제로 진행된 거래 건만 표시됩니다.
+
+</li>
+
+<li>**문화상품권** : 문화상품권의 경우 V1 결제모듈의 웰컴페이먼츠만 지원합니다.</li>
+
+<li>
+
+**컬쳐랜드** : 결제 요청 시 결제 수단을 컬쳐랜드 문화상품권
+(`payMethod : GIFT_CERTIFICATE`, `giftCertificate.giftCertificateType : CULTURELAND`)로 지정하여 호출한 뒤
+컬쳐랜드 문화상품권으로 진행된 거래 건만 표시됩니다.
+
+</li>
+
+<li>
+
+**스마트문상** : 결제 요청 시 결제 수단을 스마트문상
+(`payMethod : GIFT_CERTIFICATE`, `giftCertificate.giftCertificateType : SMART_MUNSANG`)로 지정하여 호출한 뒤
+스마트문상 ((구)게임문화상품권)으로 진행된 거래 건만 표시됩니다.
+
+</li>
+
+<li>
+
+**북앤라이프** : 결제 요청 시 결제 수단을 북앤라이프
+(`payMethod : GIFT_CERTIFICATE`, `giftCertificate.giftCertificateType : BOOKNLIFE`)로 지정하여 호출한 뒤
+도서문화상품권으로 진행된 거래 건만 표시됩니다.
+
+</li>
+
+<!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
+
+<li>
+
+**포인트결제** : 실제 승인된 결제가 포인트로 진행된 거래 건만 표시됩니다.
+
+- 예를 들어 네이버페이 포인트 사용 결제 건 등이 해당됩니다.
+
+</li>
+
+<li>**기타** : 결제 수단을 알 수 없거나 해외 현지 결제 수단으로 진행된 거래 건만 표시됩니다.</li>
+
+</ul>
+
+### 결제대행사
+
+- **전체** : 모든 결제대행사의 거래를 조회합니다.
+- 결제대행사 필터는 `pg_provider`를 기준으로 구분됩니다.
+
+### 결제유형
+
+- **전체** : 모든 결제유형의 거래를 조회합니다.
+- **정기 결제** : 발급한 빌링키로 시도된 결제 거래 건만 표시됩니다.
+- **일반 결제** : SDK 및 API로 시도된 일회성 결제 거래 건만 표시됩니다.
+
+### 결제모드
+
+- **전체** : 모든 결제모드의 거래를 조회합니다.
+
+- **실결제** : 실연동 채널로 시도된 결제 거래 건만 표시됩니다.
+
+- **테스트 결제** : 테스트 채널로 시도된 결제 거래 건만 표시됩니다. 기본적으로 체크 표시가 해제되어있으니
+  테스트 거래 건을 조회할 실 때 필터에서 체크한 후 검색을 해야 합니다.
+
+## 순거래액
+
+총 거래액, 총 거래취소 금액, 순 거래액 집계 금액은 홈 대시보드에서 확인하시거나 결제 데이터 분석 서비스에서 상세히 확인하실 수 있습니다.
+
+## 엑셀다운로드
+
+조회된 거래 내역을 엑셀 파일 형식으로 로컬에 다운로드 받을 수 있습니다. 엑셀 다운로드 클릭 시 원하는 정보를 선택하여 커스텀할 수 있습니다.