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

package/assets/docs/help/admin-console/platform-settlement/partner_settlement_service_guide.md

@@ -0,0 +1,268 @@
+---
+title: 파트너 정산 자동화 서비스 가이드
+category: 관리자콘솔 (관리자콘솔 사용 가이드) > 파트너 정산 자동화 > 파트너 정산 자동화
+seo:
+  title: 파트너 정산 자동화 가이드
+  description: >-
+    재무, 개발 공수를 획기적으로 줄여주는 포트원의 파트너정산 자동화 서비스를 소개합니다. 간단한 API 연동과 관리자 콘솔을 통해 고객사
+    자체 개발에 드는 많은 비용과 시간의 절감이 가능합니다.
+  keywords:
+    - 관리자콘솔
+    - 파트너정산자동화
+    - 파트너정산
+tags:
+  - 공통
+  - 파트너 정산 자동화
+pgCompanies:
+  - 공통
+searchTags:
+  - 파트너계약
+  - 정산정책
+  - 할인수수료정책
+  - 할인수수료
+  - 수수료등록
+  - 추가수수료정책
+  - 수식관리
+  - 파트너관리
+  - 파트너추가
+  - 정산내역
+  - 할인분담금
+  - 할인정책
+  - 파트너분담률
+  - 하위정산
+  - 정산자동화
+  - pg지급이체
+  - 지급이체
+  - 매출정산자동화
+  - 파트너정산
+  - 파트너 정산
+  - 정산
+  - 파트너 정산 자동화
+datetime: 2025-06-18T07:47:13.455Z
+---
+
+### **서비스 소개**
+
+#### **1. 요약**
+
+파트너 정산 자동화 서비스는 플랫폼, 마켓 플레이스, 커머스 사업을 위한 포트원만의 재무 서비스 모듈로 국내 최초로 개발되었습니다. 파트너에게 지급되어야 하는 정산 금액을 자동으로 계산하고 세금계산서, 송금(지급이체)까지 자동화함으로써 재무팀과, 운영팀, 개발팀 모두의 리소스를 획기적으로 절감할 수 있습니다. API 연동 및 포트원 관리자 콘솔을 통한 노코드 연동 모두 지원됩니다.
+
+#### **2. 핵심 기능**
+
+1. 개인 및 사업자 유형에 따라 다양한 정산 정책을 등록하고 관리할 수 있습니다.
+2. 파트너를 대량으로 등록하고 손쉽게 관리할 수 있습니다.
+3. 파트너별 정산 정책을 자동으로 매칭시켜서 정산 주기에 맞게 정산금을 자동으로 계산합니다.
+4. 사업자 대상 세금계산서 역발행 요청 기능을 제공합니다.
+5. 계산된 정산금을 클릭 한 번으로 송금 및 이체 처리할 수 있습니다.
+6. 가상계좌의 입출금 내역을 실시간으로 확인할 수 있습니다.
+
+#### **3. 용어 설명**
+
+- 정산 서비스 이용에 참고하실 수 있는 [용어별 설명 가이드 보러가기↗](https://developers.portone.io/platform/guides/dictionary)를 안내드립니다.
+
+### 상세 이용 가이드
+
+
+
+#### 1. 정산정책관리
+
+<Tag text="계약관리" />
+
+이름, 아이디 생성
+
+아이디 생성 : 설정하신 계약에 대한 아이디를 부여합니다. api에 입력될 아이디를 설정하거나 원하는 아이디를 기입해주세요. 난수의 식별번호로 생성할 수도 있습니다.
+
+##### 중개수수료 설정
+
+##### 정률(일정비율)/정액(일정금액) 중 선택하여 설정 가능합니다. 부가세를 파트너에서 부담할지, 우리회사가 부담할지 설정할 수 있습니다.
+
+정산 주기 설정
+
+정산 보류일 : 매출(결제)이 발생된 이후 홀드하고 있어야 하는 기간입니다. 환불/취소 대응 및 정산 안정성을 위해 자유롭게 설정할 수 있습니다.
+
+- 매일/매주/매월/매년
+
+<Tag text="할인 분담 정책" />
+
+&#x9;							&#x9;
+
+할인 정책 아이디 : 설정할 할인정책을 구분할 아이디를 설정해주세요.
+
+파트너 분담률 : 포인트 및 쿠폰, 프로모션 등 할인금액에 대해서 파트너가
+부담하기로 한 비율입니다.
+
+5,000원 할인 프로모션 진행 → 분담률10% → 파트너 500원 부담
+
+**메모**\
+내부 관리를 위해 관리용 메모를 작성할 수 있습니다.
+
+<Tag text="추가 수수료 정책" />
+
+추가 수수료 아이디 : 추가하실 수수료 정책을 구분할 아이디를 설정해주세요.
+\
+\* 정산 건에 추가 수수료가 적용될 경우 등록하신 아이디를 같이 호출해주셔야 합니다.\
+추가 수수료 : 정률(일정 비율) / 정액(일정 금액) 중 설정부가세 분담 주체 : 파트너 부담 or 우리 회사 부담 설정PG 수수료 등의 추가적인 수수료에 대한 정책을 등록해보세요.
+
+<Tag text="계산관리" />
+
+**제공되는 파라미터를 이용하여 수식을 만들거나, 사용자 정의 파라미터를 추가할 수 있습니다.**
+
+##### **정산 파라미터란?**
+
+정산 로직에 영향을 주는 변수 값으로 수수료율, 할인금액 등을 의미
+
+##### 사**용자 정의 파라미터**
+
+주문 금액, 결제 금액 부가세 등 기본 파라미터 외에도 각 플랫폼의 특성에 맞는 사용자 정의 파라미터를 추가하여 고도화된 수식을 관리할 수 있습니다.
+
+**기본 파라미터**
+
+주문 금액, 주문 면세 금액 등 다양한 기본 파라미터를 제공합니다.
+
+**사용자 정의 수식**
+
+수식 이름/키 : 수식을 구분할 이름과 키를 입력해주세요.
+
+수식 작성 : 파라미터(기본, 사용자)와 연산자를 이용하여 수식을 추가하세요.
+
+수수료 소수점 계산 : 회계 기준에 부합하는 부가세 처리 및 정산 금액의 소수점 처리 기준(내림, 올림, 반올림)을 제공하여 맞춤 설정할 수 있습니다.
+
+**정산 금액과 정산 면세액**
+
+최종적으로 정산을 진행하는 금액에 대한 수식을 확인하고 수정할 수 있습니다. 면세액이 발생하는 경우, 정산 면세액 수식을 확인하고 수정할 수 있습니다.
+
+**부가세 소수점 처리 방식**
+
+회계 기준에 부합하는 부가세 처리 및 정산 금액의 소수점 처리 기준(내림, 올림, 반올림)을 제공하여 맞춤 설정할 수 있습니다.
+
+#### 2. 파트너 관리
+
+**정산이 이루어질 파트너를 등록합니다.**
+
+
+
+<Tag text="파트너 추가" />
+
+##### **기본 정보 등록**
+
+파트너 이름 : 파트너를 구분할 수 있는 이름을 입력해주세요.
+
+아이디 생성 : api 에 입력될 아이디를 발급하거나 원하는 아이디를 기입해주세요.
+
+##### **파트너 정보 등록**
+
+파트너 유형 : 사업자, 원천징수 대상자, 원천징수 비대상자로 구분하여 선택할 수 있습니다.
+
+사업자 등록번호를 입력하여 등록하는 시점에 휴폐업 조회를 할 수 있으며,
+파트너 관리탭에서 확인할 수 있습니다.
+
+**계좌 정보 등록**
+
+파트너가 정산 받을 계좌 정보를 등록해주세요. 계좌 저보를 입력하고, 예금주조회를 통해 예금주명이 파트너와 일치하는지, 유효한 계좌인지 확인할 수 있습니다.
+
+**사용자 정의 수식**
+
+파트너에 할당되어야 하는 계약을 확인하고 등록해주세요.
+
+**태그 정보 등록**
+
+파트너의 속성을 관리할 수 있도록 복수의 태그 정보를 등록할 수 있고, 추후 태그 정보로 파트너를 분류하여 조회하고 검색할 수 있습니다.
+
+**사용자 정의 속성**
+
+내부적으로 관리하는 파트너와 관련된 메타 데이터를 넣을 수 있도록 총 10개의 사용자 정의 수식을 등록하고 값을 넣어 관리할 수 있습니다.
+
+**파트너 일괄 등록**
+
+파트너 일괄등록 CSV 파일을 다운로드 받아, 작성하여 첨부하면 일괄적으로 파트너를 등록할 수 있습니다.
+
+#### **3. 정산 상세 조회**
+
+- 정산 API를 호출하여 정산일에 맞게 생성된 주문 정산, 주문 취소 정산 내역을 조회할 수 있습니다.
+- 수기로 정산 내역 조정이 필요한 경우 음수 정산 / 양수 정산 건을 생성하여 예외적인 정산 케이스를 관리할 수 있습니다.
+- 정산 상세 내역을 CSV 파일로 다운로드하여 정산 명세서를 손쉽게 작성하고 관리할 수 있습니다.
+- 수기 정산건 등록 시 즉시 정산내역 관리에 반영되어 실시간 확인이 가능합니다.
+
+
+
+#### 4. **정산 내역 관리하기**
+
+**정산일에 맞춰 정산금액과 지급예정금액을 각각 확인할 수 있습니다.**\
+**내역 확인** : 정산 API 호출 내역을 기반으로 정산일을 자동으로 생성, 선택한 정산일을 기준으로 정산금액 (계산금액) 과 지급예정금액 (송금대행 일괄지급 가능 금액)을 각각 확인할 수 있습니다.
+
+정산내역은 정산일이 생성된 경우, 과거의 데이터와 미래의 데이터 모두 확인 가능합니다.
+
+##### **엑셀 다운로드**
+
+\[정산 상세 조회] 페이지에서 정산 상세 내역을 CSV 파일로 다운로드할 수 있습니다. 파일 다운로드 후 상세 내역을 확인하고 정산 명세서를 손쉽게 정리할 수 있습니다.
+
+
+
+#### **5. 일괄이체 실행**
+
+지급 확정 내역에 대해 이체를 실행할 수 있습니다.
+
+**송금대행 일괄 이체 실행**
+
+총 지급 금액과 가상계좌 잔액을 확인하고 이체할 수 있습니다.
+
+##### **예약 이체**
+
+예약 이체를 통해 10분 단위로 이체를 예약할 수 있습니다.
+이체는 예약시간에 순차적으로 진행되며, 예약 취소 및 시간 변경은 일괄이체
+내역 관리 메뉴에서 가능합니다.
+
+은행망의 점검으로 22:50\~01:00 에는 이체 예약이 불가합니다.
+
+**즉시 이체**
+
+즉시 이체 버튼을 클릭하면 법인용 공동인증서 전자서명이 실행되고, 전자서명
+비밀번호가 등록된 비밀번호와 일치하면 지급이 시작됩니다.
+
+
+
+#### 6. **일괄지급 내역 관리**
+
+송금대행 일괄지급 내역을 확인하며, 지급 결과를 실시간으로 확인할 수 있습니다.
+
+**일괄지급 내역 관리**\
+일괄지급 내역의 상태를 확인할 수 있으며, 정보 오기입 등의 사유로 중단이 필요한 경우, 진행중 상태의 송금대행 일괄지급을 중단할 수 있습니다.
+
+지급 오류를 방지하기 위해 지급은 시스템에서 차례로 진행되며, 2개 이상의 일괄지급을 동시에 진행할 수 없습니다.
+
+##### **일괄지급 내역 상세**
+
+##### 지급 내역이 확정되어 준비 완료 상태인 지급건의 일괄지급 내역 상세 페이지로 진입하여 세금계산서 발행 요청 또는 송금대행 지급을 실행할 수 있습니다.
+
+**지급 내역 상세**\
+해당 일괄지급 내역건에 대한 지급 내역을 조회하고 관리할 수 있습니다.
+
+
+
+#### 7. **지급내역 관리**
+
+지급 내역을 확인하고, 상태값을 실시간으로 확인할 수 있습니다.
+
+**일괄지급 내역 관리**\
+건별 지급 내역을 확인하며, 송금대행 일괄지급 서비스를 이용한 경우 각 지급 건의 상태값을 실시간으로 조회할 수 있습니다.
+
+지급이 실패한 경우, 실패 사유를 확인할 수 있습니다. 지급 실패 건에 대해 지급을 재시도하고자 하는 경우, \[정산 내역 관리] 페이지의 ‘지급실패’ 상태 탭에서 해당 지급 건을 확인한 뒤 새롭게 일괄지급을 실행할 수 있습니다.
+
+##### **일괄지급 내역 상세 이체 실행 및 재시도** : 선택한 건에 대해 이체를 실행하거나 재시도할 수 있습니다.
+
+##### &#xA;**지급 중단** : 지급대기 상태인 건의 지급을 중단할 수 있습니다.
+
+##### &#xA;**지급 취소** : 지급확정, 중단, 실패 내역을 취소 할 수 있습니다.
+
+##### &#xA;**예약 취소** : 송금 예약 건을 취소할 수 있습니다.
+
+##### &#xA;**세금계산서 발행 요청** : 해당 건의 세금계산서 발행을 요청합니다.
+
+
+
+#### **8. 세금계산서 역발행**
+
+- 세금계산서 역발행 페이지에서 공급받는자가 공급자 대신 세금계산서를 작성하여 발행 요청할 수 있습니다.
+- 공급자는 이메일로 발행 요청을 받은 후 세금계산서 내용을 확인하고 승인 또는 거부할 수 있습니다.
+- 세금계산서를 단건으로 작성하거나 CSV 파일을 통해 일괄 등록할 수 있습니다. 이메일 재발송 기능을 통해 공급자가 이메일을 놓친 경우에도 다시 발행 요청을 보낼 수 있습니다.
+

package/assets/docs/help/api-sdk-2025-05-14.md

@@ -0,0 +1,71 @@
+---
+title: '[릴리즈노트]2025-05-19 원 페이먼트 인프라 업데이트'
+category: 업데이트
+tags:
+  - OPI
+  - 업데이트
+searchTags:
+  - 결제 히스토리
+  - 캘린더
+  - OPI
+  - 업데이트
+  - 원페이먼트
+datetime: 2025-07-30T07:09:52.676Z
+---
+
+<Callout title="2025년 05월 19일 원 페이먼트 인프라 업데이트 소식을 안내드립니다." />
+
+
+
+<Callout content="안녕하세요 원 페이먼트 인프라팀입니다. 25년 5월 19일, 서비스 업데이트 사항 안내드립니다.
+
+이번 업데이트를 통해 통합 결제 내역 페이지가 새롭게 탈바꿈을 했습니다.
+
+개선 작업은 아래와 같습니다.
+
+1. 캘린더 UI 고도화
+2. 검색 조건 최적화
+3. 필터 최적화
+4. 결제 히스토리 파악가능" />
+
+## **주요 업데이트 사항**
+
+#### **✔️캘린더 UI 고도화**
+
+##### 상태 승인 시각, 결제 요청 시각을 기준으로 원하는 날짜를 쉽게 조회할 수 있습니다.
+
+- 시작일과, 종료일을 직접 입력하거나 캘린더에서 일자를 선택하여 날짜를 조회할 수 있습니다.
+- “오늘”, “어제”, “1주”, “1개월”, “3개월”, “6개월” 의 프리셋을 활용하여 직접 입력하지 않고도 간편하게 일자를 설정할 수 있습니다.
+
+
+
+#### **✔️검색 조건 최적화**
+
+검색을 쉽게 할 수 있도록 각 검색 조건마다 최적화 작업을 진행하였습니다.
+
+
+
+- 주문 정보
+  - 주문자명, 주문자 연락처, 주문명, 주문자 이메일, 주문자 주소로 더욱 정교화된 검색을 할 수 있습니다.
+- 거래번호
+  - 포트원 거래번호, 고객사 거래번호를 동시에 검색할 수 있습니다.
+- 승인번호
+  - 카드사 승인번호, 결제대행사 승인번호, PG결제취소 승인번호를 동시에 검색할 수 있습니다.
+
+#### **✔️ 필터 최적화**
+
+- 테이블 UI를 고도화함에 따라 테이블 헤더에 필터, 정렬 버튼이 추가되어 빠른 적용이 가능합니다.
+  - Tip) 실 운영 업무를 위해 결제 모드는 “실결제”로 필터가 기본 적용되어 있습니다. 테스트 결제 건을 확인하고 싶으시다면 결제 모드 필터를 해제해 주세요.
+
+
+
+#### **✔️ 결제 히스토리 파악 가능**
+
+기존에는 결제 상세 모달에서만 히스토리를 확인 가능했다면, 이제는 결제 내역에서 바로 확인할 수 있게 되었습니다. 결제 히스토리를 쉽게 확인하고 운영 업무에 활용하실 수 있습니다.
+
+- 결제대행사별 인사이트
+  - 결제대행사별로 구분하여 거래액 및 거래 건수를 쉽게 파악할 수 있습니다.
+
+
+
+##### [\[원 페이먼트 인프라 릴리즈노트\] 2025-05-19업데이트 보러가기↗](https://developers.portone.io/release-notes/api-sdk/2025-05-19)

package/assets/docs/help/applepay.md

@@ -25,7 +25,7 @@ datetime: 2023-04-03T15:00:00.000Z
 
 ### **\[지원 가능한 조건]**
 
-- 지원PG사 :  KCP , (구)토스페이먼츠 , (신)토스페이먼츠, KG이니시스, (신)나이스페이먼츠
+- 지원PG사 :  KCP , (구)토스페이먼츠 , (신)토스페이먼츠, KG이니시스, (신)나이스정보통신
 - 카드 : 현대카드 (그외 국내 발행 카드사 및 해외 발행카드 미지원)
 - 결제방식 : 일반결제 (정기결제 미지원)
 

package/assets/docs/help/content100002.md

@@ -21,7 +21,7 @@ datetime: 2021-08-02T15:00:00.000Z
 - 배포 일정 : 2021-08-04(수) 15:00 \~ 15:30
 - 목적 : 포트원 API Response 필드 추가
 - 상세내용
-  - emb\_pg\_provider : 허브형 결제 PG사 정보
+  - emb\_pg\_provider : PG 제휴 결제 PG사 정보
     - ex) \
       카카오페이 : kakaopay\
       네이버페이 : naverpay\

package/assets/docs/help/content100029.md

@@ -2,7 +2,7 @@
 title: '[공지] 나이스페이 자체 장애 대응 완료(종결)'
 category: 공지사항
 tags:
-  - 나이스페이먼츠
+  - 나이스정보통신
   - 공지사항
 pgCompanies:
   - null

package/assets/docs/help/content100060.md

@@ -21,7 +21,7 @@ datetime: 2024-04-16T07:55:25.448Z
 
 ✔️ 포트원 V2 신모듈에서 한국결제네트웍스(KPN) 결제를 지원합니다.
 
-이제 포트원 V2를 통해 한국결제네트웍스 일반결제 및 정기결제가 가능합니다. 이번 업데이트를 통해 다양한 결제수단을 제공하며, 일부 간편결제에 대해 허브형과 다이렉트 호출을 지원합니다.
+이제 포트원 V2를 통해 한국결제네트웍스 일반결제 및 정기결제가 가능합니다. 이번 업데이트를 통해 다양한 결제수단을 제공하며, 일부 간편결제에 대해 PG 결제창과 다이렉트 호출을 지원합니다.
 
 한국결제네트웍스에서 지원하는 결제수단은 아래와 같습니다.
 
@@ -29,7 +29,7 @@ datetime: 2024-04-16T07:55:25.448Z
 - 실시간 계좌이체
 - 가상계좌 (회전식)
 - 휴대폰 소액결제
-- 간편결제 (허브형/다이렉트)
+- 간편결제 (PG 결제창/다이렉트)
   - 카카오페이
   - 네이버페이 (다이렉트 호출 불가)
   - 페이코

package/assets/docs/help/content200015.md

@@ -25,7 +25,7 @@ datetime: 2024-07-08T05:47:06.710Z
 (기존 결제사정산 서비스 →  PG 거래대사 서비스로 업데이트)
 - 종료일 : 2024.06.30 
 
-**2. (구)토스페이먼츠 , 나이스페이먼츠 이용 시** 
+**2. (구)토스페이먼츠 , 나이스정보통신 이용 시** 
 - 결제대행사 내부정책에 따라 정산 ↔ 거래마감 데이터 동시제공 불가 
 - 업데이트 기간 동안 신규데이터 업로드 안됨 
 -  2024.07.08 ~ 07.22

package/assets/docs/help/content200019.md

@@ -44,7 +44,7 @@ datetime: 2024-06-02T15:00:00.000Z
 
 지원 결제대행사
 
-- 나이스페이먼츠
+- 나이스정보통신
 - KG이니시스
 - 토스페이먼츠
 - 스마트로

package/assets/docs/help/content200023.md

@@ -24,7 +24,7 @@ datetime: 2024-06-16T15:00:00.000Z
 ✔️ 포트원 V2 결제모듈에서 NHN KCP 결제를 지원합니다.
 
 이제 포트원 V2를 통해 NHN KCP 일반결제 및 정기결제가 가능합니다. \
-이번 업데이트를 통해 다양한 결제수단을 제공하며, 일부 간편결제에 대해 허브형과 다이렉트 호출을 지원합니다.
+이번 업데이트를 통해 다양한 결제수단을 제공하며, 일부 간편결제에 대해 PG 결제창 및 다이렉트 호출을 지원합니다.
 
 NHN KCP에서 지원하는 결제수단은 아래와 같습니다.
 
@@ -32,7 +32,7 @@ NHN KCP에서 지원하는 결제수단은 아래와 같습니다.
 - 가상계좌
 - 휴대폰 소액결제
 - 상품권 결제(컬쳐랜드/도서문화상품권)
-- 간편결제 (허브형/다이렉트)
+- 간편결제 (PG 결제창/다이렉트)
 
 <Indent level="1">
 

package/assets/docs/help/content200050.md

@@ -30,7 +30,7 @@ PG 거래대사 내의 거래 정산 내역 메뉴에서 정산일 또는 거
 
 ✔️ KSNET, KPN, 하이픈에서 발생한 거래 건도 PG 거래대사에서 데이터 확인이 가능해집니다.
 
-기존에 12개 PG사 (KCP, KG이니시스, 나이스페이먼츠, 토스페이, 네이버페이, 다날, 페이코, (구)토스페이먼츠, 토스페이먼츠, 카카오페이, 엑심베이, 헥토파이낸셜) 에서만 지원하던 PG 거래대사가 KSNET, KPN, 하이픈까지 확장하여 총 15개 PG사 데이터에 한하여 제공됩니다.
+기존에 12개 PG사 (KCP, KG이니시스, 나이스정보통신, 토스페이, 네이버페이, 다날, 페이코, (구)토스페이먼츠, 토스페이먼츠, 카카오페이, 엑심베이, 헥토파이낸셜) 에서만 지원하던 PG 거래대사가 KSNET, KPN, 하이픈까지 확장하여 총 15개 PG사 데이터에 한하여 제공됩니다.
 
 (참고 : PG 거래대사 메뉴의 경우 클로즈 베타로 운영되고 있으며, 사용을 원하시는 고객께서는 [PG거래대사 베타서비스 신청 바로가기 ↗](https://forms.gle/cZAqJLGqovC1STrS8)에서 신청해 주시길 바랍니다.)
 

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

@@ -42,7 +42,7 @@ datetime: 2024-02-22T15:00:00.000Z
 ---
 
 <Callout content="결제 연동을 위한 채널 설정 방법을 안내해 드립니다.
-결제 연동을 위해서 채널설정은 필수이며 결제대행사와 연동방식별로 설정하는 정보는 상이할 수 있습니다.
+결제 연동을 위해서 채널 설정은 필수이며 결제대행사와 연동방식별로 설정하는 정보는 상이할 수 있습니다.
 또한 채널 설정 없이 결제 연동을 하실 경우 정상적인 호출이 불가하며, 오류가 발생됩니다." />
 
 <Highlight url="#7_결제창-휴대폰결제-및-휴대폰-본인인증" text="다날 휴대폰 결제 및 본인인증 설정 바로가기 ↓" />
@@ -57,10 +57,10 @@ datetime: 2024-02-22T15:00:00.000Z
 
 - [테스트 연동 특징 보러가기↗](https://help.portone.io/category/procedure/payment-integration/test?page=1)
 
-<Callout content="1. 일반결제(신용카드,계좌이체,가상계좌) 모듈과 휴대폰 소액결제 모듈이 구분되어있어 별도로 설정이 필요합니다.
-2. 다날 테스트 모드의 경우 실제 결제 승인이 이루어지지만, PG사에서 일괄적으로 매일 자정이전 자동 취소가 이루어집니다.
-3. 다날 정책상 계좌이체/가상계좌는 테스트 결제가 제공되지 않습니다.
-4, 계약 후 실제 상점아이디로 테스트 하실 수 있습니다.테스트 모드에서 부분취소 테스트는 불가합니다." title="참고사항" icon="💡" />
+<Callout content="1. 일반 결제(신용카드, 계좌이체, 가상계좌) 모듈과 휴대폰 소액결제 모듈이 구분되어 있어 별도로 설정이 필요합니다.
+2. 다날 테스트 모드의 경우 실제 결제 승인이 이루어지지만, PG 사에서 일괄적으로 매일 자정이 전 자동 취소가 이루어집니다.
+3. 다날 정책상 계좌이체/가상계좌는 테스트 결제가 제공되지 않습니다.
+4, 계약 후 실제 상점 아이디로 테스트하실 수 있습니다. 테스트 모드에서 부분 취소 테스트는 불가합니다." title="참고사항" icon="💡" />
 
 
 
@@ -85,9 +85,7 @@ datetime: 2024-02-22T15:00:00.000Z
 
 - [실 연동 특징 보러가기↗](https://help.portone.io/category/procedure/payment-integration/real?page=1)
 
-<Callout content="1. 가상계좌와 실시간 계좌이체의 암호화 key는 동일하므로 포트원 관리자콘솔 내 설정시 같은 항목에 한번만 설정해주시기 바랍니다.
-2. **다날 가상계좌는 다날PG사 정책상 환불 서비스를 지원하지 않습니다.**
-" title="참고사항" icon="💡" />
+<Callout content="가상계좌와 실시간 계좌이체의 암호화 key는 동일하므로 포트원 관리자 콘솔 내 설정 시 같은 항목에 한 번만 설정해 주시기 바랍니다." title="참고사항" icon="💡" />
 
 
 

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

@@ -46,10 +46,13 @@ datetime: 2024-01-25T15:00:00.000Z
 
 [결제방식]
 - 일반결제 : 구매자의 결제정보를 저장하지 않는 일회성 결제 (단건결제)
-- 정기결제 : 구매자의 결제정보를 저장해놓고 재결제하는 결제 (정기 / 비 정기결제)
-" title="참고사항" icon="💡" />
+- 정기결제(V2) : 구매자의 결제정보를 저장해놓고 재결제하는 결제 (정기 / 비 정기결제)
 
-## <Highlight text="결제창 일반결제" />
+[기타]
+엑심베이 정책상 정기결제의 경우 빌링키 발급 과 동시에 첫결제 발생이 필요합니다. 
+(결제 후 취소 가능 합니다.)" title="참고사항" icon="💡" />
+
+## <Highlight text="결제창 일반결제 (V1)" />
 
 ### **테스트 연동**
 
@@ -57,6 +60,9 @@ datetime: 2024-01-25T15:00:00.000Z
 
 - [테스트 연동 특징 보러가기↗](https://help.portone.io/category/procedure/payment-integration/test?page=1)
 
+<Callout icon="💡" title="참고사항" content="테스트 결제는 엑심베이에서 제공하는 테스트 카드 정보로만 진행 가능합니다. 
+테스트를 진행하실 때 참고 부탁드립니다." />
+
 
 
 #### **설정경로**

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

@@ -65,7 +65,7 @@ datetime: 2025-03-03T15:00:00.000Z
 [휴대폰본인인증] 
 - NHN KCP 정책상 본인인증 테스트 연동정보가 제공되지 않습니다. 계약 후 실제 상점아이디로 테스트 하실 수 있습니다. " title="참고사항" icon="💡" />
 
-## <Highlight text="결제창 일반/수기결제 및 API 수기/정기결제" />
+## <Highlight text="결제창 일반/수기결제 및 API 수기/정기결제 (V1)" />
 
 ### **테스트 연동**
 
@@ -74,7 +74,7 @@ datetime: 2025-03-03T15:00:00.000Z
 - [테스트 연동 특징 보러가기↗](https://help.portone.io/category/procedure/payment-integration/test?page=1)
 
 <Callout content="1. NHN KCP 테스트 모드의 경우 결제시 실제 출금이 이루어지지 않습니다.
-2. NHN KCP의 허브형인 카카오페이, 네이버페이는 테스트 모드를 지원하지 않습니다.
+2. NHN KCP 제휴 카카오페이, 네이버페이는 테스트 모드를 지원하지 않습니다.
 (NHN KCP와 계약 후 서비스 이용가능)
 3. 카드사 심사 완료 후에는 NHN KCP에서 발급받은 실상점 정보로 설정 해야 합니다." icon="💡" title="참고사항" />
 
@@ -94,7 +94,7 @@ datetime: 2025-03-03T15:00:00.000Z
 - PG상점아이디 (사이트코드) 클릭
   - KCP 결제창 일반결제 : **AO09C** 선택
   - KCP API 정기결제 : **A52LD** 선택
-  - KCP 결제창 일반결제 (페이코 허브형) :  **AO0Q9** 선택
+  - KCP 결제창 일반결제 (페이코) :  **AO0Q9** 선택
 - 과세설정 : [포트원 결제사정산 서비스↗ ](https://admin.portone.io/reconciliation/summary)이용시 단순 과세계산을 위해 사용되는 항목으로 미 이용시 설정하지 않으셔도 무방합니다. 거래의 과세/면세 여부와는 관계없습니다.
 
 ### **실 연동**
@@ -120,11 +120,14 @@ datetime: 2025-03-03T15:00:00.000Z
 - PG상점아이디 (사이트코드) 클릭 : NHN KCP에서 계약완료 후 메일로 안내드립니다.
 - **배치결제그룹아이디 :  KCP 정기결제인 경우에만 설정하는 아이디이며, 정기결제 이용시 필수등록 항목입니다.**
   - 확인 방법 : 해당 아이디 확인을 위해서는 KCP에서 정기결제용으로 발급받은 사이트 코드로 KCP 상점관리 페이지 접속하여 희망하는 사용자명을 입력하고 패스워드를 등록하여 사설 인증서를 발급받습니다.
-  - 인증서 발급 경로 : [KCP 상점 관리자페이지↗](https://partner.kcp.co.kr/) > 접속 > 고객센터 > 인증센터 > 관리용 사설인증서 \
-    \> 인증서 발급 버튼 클릭
+  - 인증서 발급 경로 : [KCP 상점 관리자페이지↗](https://partner.kcp.co.kr/) > 접속 > 기술관리센터 > 인증센터 > KCP PG API 발급 버튼 클릭
   - 그룹 등록 경로 : [KCP 상점 관리자페이지↗](https://partner.kcp.co.kr/) > 결제관리 > 자동결제 > 그룹관리 > 그룹등록
+
+<Accordion title="▶KCP 관리자페이지>인증키 설정경로 이미지 참고" content="<>
+
+</>" image="https://help.portone.io/uploads/image (12).png" />
+
 - 과세설정 : [포트원 결제사정산 서비스↗ ](https://admin.portone.io/reconciliation/summary)이용시 단순 과세계산을 위해 사용되는 항목으로 미 이용시 설정하지 않으셔도 무방합니다. 거래의 과세/면세 여부와는 관계없습니다.
--
 
 <Callout title="V2 NHN KCP 개발가이드 보러가기↗" />
 
@@ -180,15 +183,79 @@ datetime: 2025-03-03T15:00:00.000Z
 - PG상점아이디(사이트코드) : NHN KCP에서 계약완료 후 메일로 안내드립니다.
 - 배치결제그룹아이디 :  KCP 정기결제인 경우에만 설정하는 아이디이며, 정기결제 이용시 필수등록 항목입니다.
   - 확인 방법 : 해당 아이디 확인을 위해서는 KCP에서 정기결제용으로 발급받은 사이트 코드로 KCP 상점관리 페이지 접속하여 희망하는 사용자명을 입력하고 패스워드를 등록하여 사설 인증서를 발급받습니다.
-  - 인증서 발급 경로 : [KCP 상점 관리자페이지↗](https://partner.kcp.co.kr/) > 접속 > 고객센터 > 인증센터 > 관리용 사설인증서 \
-    \> 인증서 발급 버튼 클릭
+  - 인증서 발급 경로 : [KCP 상점 관리자페이지↗](https://partner.kcp.co.kr/) > 접속 > 기술관리센터 > 인증센터 > KCP PG API 발급 버튼 클릭
   - 그룹 등록 경로 : [KCP 상점 관리자페이지↗](https://partner.kcp.co.kr/) > 결제관리 > 자동결제 > 그룹관리 > 그룹등록
 - 과세설정 : [포트원 결제사정산 서비스↗](https://admin.portone.io/reconciliation/summary) 이용시 단순 과세계산을 위해 사용되는 항목으로 미 이용시 설정하지 않으셔도 무방합니다. 거래의 과세/면세 여부와는 관계없습니다.
 
-## <Highlight text="휴대폰 본인인증" />
+## <Highlight text="결제창 일반/수기결제 및 API 수기/정기결제 (V2)" />
+
+### **테스트 연동**
+
+결제대행사와 계약 전에 미리 연동/개발이 가능한 테스트 연동환경입니다. 테스트 연동은 기본적인 결제 로직을 구현하실 수 있도록 미리 제공되는 범용적인 Key 입니다. 보다 자세한 테스트 연동 환경의 특징은 아래 가이드를 자세히 참조해주세요.
+
+- [테스트 연동 특징 보러가기↗](https://help.portone.io/category/procedure/payment-integration/test?page=1)
+
+<Callout content="1. NHN KCP 테스트 모드의 경우 결제시 실제 출금이 이루어지지 않습니다.
+2. NHN KCP의 허브형인 카카오페이, 네이버페이는 테스트 모드를 지원하지 않습니다.
+(NHN KCP와 계약 후 서비스 이용가능)
+3. 카드사 심사 완료 후에는 NHN KCP에서 발급받은 실상점 정보로 설정 해야 합니다." icon="💡" title="참고사항" />
+
+
+
+#### **설정경로**
+
+- [포트원 관리자콘솔↗](https://admin.portone.io/) > 결제 연동 > 채널관리 > + 채널 추가
+  - 연동 모드 : 테스트 연동
+  - 결제대행사 : NHN KCP
+  - 결제모듈 :  결제창 일반/수기결제 ㅣ API 수기/정기결제
+
+#### **설정방법**
+
+- 채널 이름 : 상점 정보만으로는 채널(PG)의 성격을 파악하기 어려워 채널(PG)의 이름을 설정하는 용도로 구분하기 위한 필수 설정값으로 임의값으로 설정이 가능합니다(단, 숫자, 공백, 글자, \_, - 만 가능)
+- 채널 속성 : 결제
+- PG상점아이디 (사이트코드) 클릭
+  - KCP 결제창 일반결제 : \*\*T0000 \*\*선택
+  - KCP API 정기결제 :  \*\*A52Q7  \*\*선택
+  - KCP 결제창 일반결제 (페이코 허브형) : **AO0Q9** 선택
+- 과세설정 : [포트원 결제사정산 서비스↗ ](https://admin.portone.io/reconciliation/summary)이용시 단순 과세계산을 위해 사용되는 항목으로 미 이용시 설정하지 않으셔도 무방합니다. 거래의 과세/면세 여부와는 관계없습니다.
 
-<Callout title="참고사항" content="1. **NHN KCP 정책상 본인인증 테스트 연동정보가 제공되지 않습니다.** 
-2. 계약 후 실제 상점아이디로 테스트 하실 수 있습니다." icon="💡 " />
+### **실 연동**
+
+<Callout content="1. 발급된 상점아이디의 **카드사 심사가 완료**되지 않았을 경우 결제가 실패 되오니 꼭! 확인 해주셔야 합니다.
+2. NHN KCP는 간편결제별로 사이트코드가 별도로 발급 되므로 채널을 여러 개 생성해 주셔야 합니다.
+3. 여러 개의 상점아이디를 설정한 경우 결제창 호출(IMP.request_pay) 시 pg파라미터로 상점아이디를 구분할 수 있습니다. 
+- pg: {pg 정의 값}.{상점 아이디}" title="참고사항" icon="💡" />
+
+
+
+#### **설정경로**
+
+- [포트원 관리자콘솔↗](https://admin.portone.io/) > 결제 연동 > 채널관리 > + 채널 추가
+  - 연동 모드 : 실 연동
+  - 결제대행사 : NHN KCP
+  - 결제모듈 :  결제창 일반/수기결제 ㅣ API 수기/정기결제
+
+#### **설정방법**
+
+- 채널 속성 : 결제
+- PG상점아이디 (사이트코드) : PG상점아이디(사이트코드) : NHN KCP에서 계약완료 후 메일로 안내드립니다.
+- 인증서 발급 경로 : [KCP 상점 관리자페이지↗](https://partner.kcp.co.kr/) > 접속 > 기술관리센터 > 인증센터 > KCP PG API 발급 버튼 클릭
+- 인증키 설정 경로 : [KCP 상점관리자페이지↗](https://partner.kcp.co.kr "KCP 상점관리자페이지↗")> 기술관리센터 > 인증센터 > 가맹점 인증키관리
+  -  [KCP 상점관리자페이지↗](https://partner.kcp.co.kr "KCP 상점관리자페이지↗") 에서 직접 암복호화키를 발급해 주셔야 하며, 암호화키 미발급 시 서비스 이용이 불가합니다.
+
+<Accordion title="▶KCP 관리자페이지>인증키 설정경로 이미지 참고" content="<>
+
+</>" image="https://help.portone.io/uploads/image_KCP_인증서.png" />
+
+- 정기자동결제 그룹아이디 확인 경로 : [KCP 상점관리자페이지↗](https://partner.kcp.co.kr "KCP 상점관리자페이지↗") > 자동결제 > 그룹관리 > 그룹등록 생성 > 생성된 그룹 ID 입력
+
+<Accordion title="▶KCP 관리자페이지>정기결제 그룹아이디 설정 경로 참고" content="<>
+
+</>" image="https://help.portone.io/uploads/image_KCP_정기결제 그룹아이디11.png" />
+
+- 과세설정 : [포트원 결제사정산 서비스↗ ](https://admin.portone.io/reconciliation/summary)이용시 단순 과세계산을 위해 사용되는 항목으로 미 이용시 설정하지 않으셔도 무방합니다. 거래의 과세/면세 여부와는 관계없습니다.
+
+## <Highlight text="휴대폰 본인인증" />
 
 ### **실 연동**
 
@@ -196,7 +263,7 @@ datetime: 2025-03-03T15:00:00.000Z
 
 - [실 연동 특징 보러가기↗](https://help.portone.io/category/procedure/payment-integration/real?page=1)
 
-![](</uploads/결제서비스/채널설정/\[실연동] 휴대폰_본인인증.png>)
+![](</uploads/결제서비스/채널설정/\[실연동] 휴대폰_본인인증.png>)
 
 #### **설정경로**
 
@@ -209,7 +276,7 @@ datetime: 2025-03-03T15:00:00.000Z
 
 - 채널 속성 : 본인인증
 - PG상점아이디 (사이트코드) : PG상점아이디(사이트코드) : NHN KCP에서 계약완료 후 메일로 안내드립니다.
-- 인증서 발급 경로 : [KCP 상점 관리자페이지↗](https://partner.kcp.co.kr/) > 접속 > 고객센터 > 인증센터 > 관리용 사설인증서 > 인증서 발급 버튼 클릭
+- 인증서 발급 경로 : [KCP 상점 관리자페이지↗](https://partner.kcp.co.kr/) > 접속 > 기술관리센터 > 인증센터 > KCP PG API 발급 버튼 클릭
 - 인증키 설정 경로 : [KCP 상점관리자페이지↗](https://partner.kcp.co.kr "KCP 상점관리자페이지↗")> 기술관리센터 > 인증센터 > 가맹점 인증키관리
   -  [KCP 상점관리자페이지↗](https://partner.kcp.co.kr "KCP 상점관리자페이지↗") 에서 직접 암복호화키를 발급해 주셔야 하며, 암호화키 미발급 시 서비스 이용이 불가합니다.
   - 통신 3사(SKT, KT, LG U+) 인증이 정상적으로 진행되는지 직접 인증 테스트 진행해 주시고, 인증이 안될 경우 NHN KCP 휴대폰본인인증 센터 ☎1666-6410(내선번호 1번)로 유선연락 바랍니다.