@portone/mcp-server 0.13.0

package/assets/docs/help/faq/payment-faq/cash-receipt-guide.md

@@ -0,0 +1,64 @@
+---
+title: 현금영수증은 어떻게 확인할 수 있나요?
+category: 자주 묻는 질문 (일반 문의) > 결제서비스 > 결제서비스
+tags:
+  - 공통
+  - 영수증
+pgCompanies:
+  - 공통
+searchTags:
+  - 현금영수증발행
+  - 자진발급
+  - 영수증발급방법
+  - 현금영수증
+---
+
+### **현금영수증 발급 방법**
+
+- 현금영수증 유형은 세가지 유형으로 구분될 수 있으며, 해당 설정은 결제대행사와 계약시 설정됩니다.
+- 현재 이용중이신 상점아이디에 설정된 사항은 이용하시는 결제대행사를 통해 확인가능합니다.
+
+#### **1. 구매자 요청등록**
+
+- 결제시 PG사 결제창내에서 고객이 입력한 정보로 현금영수증이 발급 됩니다.
+
+<Callout content="고객이 현금영수증 발급 체크 UI에서 현금영수증 정보를 입력하지 않는 경우에는 국세청이 지정한 코드 **&quot;010-000-1234&quot;**로 현금영수증이 발급됩니다.
+해당 경우에는 포트원 관리자콘솔 내에서 현금영수증 발급 조회가 되지 않습니다." icon="💡" title="참고사항" />
+
+#### **2. 직접 발행**
+
+- 결제대행사를 통해서는 자동발행 되지 않고, 필요시 고객사에서 현금영수증 발행요청(개별등록) 하여 별도 발급하는 경우입니다.
+
+<Callout content="포트원 현금영수증 발행/취소발행(삭제) API지원 : https://developers.portone.io/api/rest-v1/receipt
+(지원 PG사 확인필요)" title="참고사항" icon="💡" />
+
+#### **3. 자진발급**
+
+- 발급대상 거래건에 대해 현금영수증이 발급되고 발급 미신청 거래도 국세청에서 지정한 코드 "010-000-1234"로 발급이 됩니다.
+- "자진발급"의 경우 현금영수증 발급 체크 UI 가 노출된다 하더라도 고객이 현금영수증 발급 체크 UI에서 현금영수증 정보를 입력하시면 입력값으로 현금영수증 발급되고, 
+  고객이 현금영수증 발급 체크 UI에서 현금영수증 정보를 입력하지 않으시면 국세청이 지정한 코드 ‘010-000-1234’로 현금영수증 발급됩니다.
+- PG사별로 차이가 있을 수 있지만, 결제창 내 현금영수증 발급 항목을 노출/비노출 제어는 "자진발급"으로 신청하신 경우 가능합니다.
+
+<Callout content="PG사별로 차이가 있을 수 있지만, 결제창 내 현금영수증 발급 항목을 노출/비노출 제어는 &quot;자진발급&quot;으로 신청하신 경우 가능합니다." title="참고사항" icon="💡" />
+
+<Callout content="&quot;자진발급&quot;은 국세청에서 지정한 코드(가상의 휴대폰번호) &quot;010-000-1234&quot; 로  현금영수증이 발행되어 소득공제시에 공제 대상(구매자(고객))을 알 수 가 없어, 구매자(고객)이 현금영수증 발행하여 소득공제를 받으려면 010-000-1234로 발행했을 때 응답되는 발행번호를 국세청 사이트에 등록하면서 자기 실제 주민번호나 휴대폰번호를 등록하면 그 사람의 소득공제에 속하게 되는 구조 입니다.
+
+따라서, 자진발급 처리하게 되었을 때 &quot;현금영수증 발행 번호&quot;를 고객사에서 해당 고객에게 매번 알려줘야 하는 이슈가 있으므로(해당 고객이 실제 소득공제 등록을 하기 위해서) 고객사 입장에서는 번거로운 일이 될 수 있으니 참고부탁드립니다." title="유의사항" icon="❗" />
+
+### 포트원을 통해 현금영수증 발행/삭제/조회 하기
+
+1\. 포트원을 통한 결제 (포트원 관리자콘솔>현금영수증 발급내역> 포트원거래분)
+
+- 발행 API : [POST `/receipts/{imp_uid}`↗](https://developers.portone.io/api/rest-v1/receipt#post%20%2Freceipts%2F%7Bimp_uid%7D)
+- 삭제 API : [DELETE `/receipts/{imp_uid}`↗](https://developers.portone.io/api/rest-v1/receipt#delete%20%2Freceipts%2F%7Bimp_uid%7D)
+- 조회 API : [GET `/receipts/{imp_uid}`↗](https://developers.portone.io/api/rest-v1/receipt#get%20%2Freceipts%2F%7Bimp_uid%7D)
+- 지원 가능한 PG : <Tag text="KG이니시스" /> <Tag text="NHN KCP" /> <Tag text="나이스페이먼츠" /> <Tag text="KICC" /> <Tag text="헥토파이낸셜" /> <Tag text="토스페이먼츠(신모듈)" /> <Tag text="KSPAY" /> <Tag text="페이조아" />
+
+2\. 포트원과 별개의 현금결제 (포트원 관리자콘솔>현금영수증 발급내역>고객사 자체거래분)
+
+- 발행 API : [POST `/receipts/external/{merchant_uid}`↗](https://developers.portone.io/api/rest-v1/receipt#post%20%2Freceipts%2Fexternal%2F%7Bmerchant_uid%7D)
+- 삭제 API : [DELETE `/receipts/external/{merchant_uid}`↗](https://developers.portone.io/api/rest-v1/receipt#delete%20%2Freceipts%2Fexternal%2F%7Bmerchant_uid%7D)
+- 조회 API : [GET `/receipts/external/{merchant_uid}`↗](https://developers.portone.io/api/rest-v1/receipt#get%20%2Freceipts%2Fexternal%2F%7Bmerchant_uid%7D)
+- 지원 가능한 PG : <Tag text="KG이니시스" /> <Tag text="NHN KCP" /> <Tag text="나이스페이먼츠" /> <Tag text="KICC" /> <Tag text="헥토파이낸셜" /> <Tag text="토스페이먼츠(신모듈)" /> <Tag text="KSPAY" />
+
+<Callout title="영수증 API 가이드 보러가기↗" />

package/assets/docs/help/faq/payment-faq/content200022.md

@@ -0,0 +1,73 @@
+---
+title: 토스페이먼츠(신모듈)을 통한 간편결제 연동방법
+category: 자주 묻는 질문 (일반 문의) > 결제서비스 > 결제서비스
+tags:
+  - 연동
+  - 간편결제
+searchTags:
+  - 결제창
+  - 간편결제창
+  - 간편결제 연동
+  - 토스페이먼츠
+datetime: 2024-07-10T08:44:51.247Z
+---
+
+<Callout content="토스페이먼츠를 통하여 간편결제서비스를 이용하시는 경우,
+토스페이먼츠의 결제창안에서 간편결제를 이용하는 방법과 간편결제창을 직접 띄우는 방법이 있습니다.
+방법별로 연동방법은 아래를 참고해주시기 바랍니다." />
+
+<Tag text="결제서비스 V1" />
+
+#### 1. 결제창 내 간편결제 서비스 이용 (<Highlight text="결제창 안에서 선택!" />)
+
+- pg : tosspayments
+- pay\_method : 'card'
+
+#### 2. 직접 간편결제 모듈 호출하는 방식 이용 (<Highlight text="간편결제창 바로 호출!" />)
+
+- pg : tosspayments
+- pay\_method
+  \- kakaopay (카카오페이)
+  \- tosspay (토스페이)
+  \- naverpay (네이버페이)
+  \- payco (페이코)
+  \- lpay (Lpay)
+  \- ssgpay (SSG페이)
+  \- lgpay (LG페이)
+  \- samsungpay (삼성페이) \
+  (삼성페이는 카드수수료의 0.3%가 추가적으로 부과 됩니다\_삼성페이 정책)
+
+<Tag text="결제 서비스 V2" />
+
+#### 1. 결제창 내 간편결제 서비스 이용 (<Highlight text="결제창 안에서 선택!" />)
+
+- channelKey : 포트원 콘솔 > 결제연동 > 설정한 토스페이먼츠 “<Highlight text="채널 키 (Channel Key)" />”에서 조회 가능
+- payMethod : “<Highlight text="CARD" />” (대소문자 구분필요)
+
+<Callout icon="💡" title="참고사항" content="토스페이먼츠의 경우 일반카드와 애플페이만 동시 노출되며 그 외 간편결제는 다른 MID(간편결제용 MID)로 발급되기 때문에, 간편결제만 결제창 내 노출되는 점 참고부탁드립니다.
+
+1) 일반카드 / 애플페이 노출되는 결제창
+2) (설정된) 간편결제만 노출되는 결제창" />
+
+#### 2. 직접 간편결제 모듈 호출하는 방식 이용 (<Highlight text="간편결제창 바로 호출!" />)
+
+- channelKey : 포트원 콘솔 > 결제연동 > 설정한 토스페이먼츠 “<Highlight text="채널 키 (Channel Key)" />”에서 조회 가능
+- payMethod : "EASY\_PAY”
+- "easyPay" : 파라미터 값 "easyPayProvider": "간편결제 코드"
+
+<Indent level="1">
+
+- SAMSUNGPAY (삼성페이)
+- APPLEPAY (애플페이)
+- SSGPAY (SSGPAY)
+- KAKAOPAY (KAKAOPAY)
+- NAVERPAY (NAVERPAY)
+- LPAY (LPAY)
+- TOSSPAY (TOSSPAY)
+- LGPAY (LGPAY)
+
+</Indent>
+
+[V2 토스페이먼츠 연동 매뉴얼 보러가기 ↗](https://developers.portone.io/opi/ko/integration/pg/v2/tosspayments?v=v2)
+
+[V1 토스페이먼츠(신모듈) 연동 매뉴얼 보러가기 ↗](https://developers.portone.io/opi/ko/integration/pg/v1/newtoss/readme?v=v1)

package/assets/docs/help/faq/payment-faq/pg-max-min-amount.md

@@ -0,0 +1,158 @@
+---
+title: 최소, 최대 결제가 가능한 금액은 얼마인가요?
+category: 자주 묻는 질문 (일반 문의) > 결제서비스 > 결제서비스
+seo:
+  title: 최소, 최대 결제가능금액
+  description: >-
+    카카오페이, NHN KCP, KG이니시스, 다날, 토스페이먼츠, 페이코, KG모빌리언스, 네이버페이, 나이스페이먼츠, KICC
+    한국정보통신, 헥토파이낸셜 등 결제대행사별 최소, 최대 결제가능금액에 대한 가이드입니다.
+  keywords:
+    - 일반결제
+tags:
+  - 일반결제
+pgCompanies:
+  - KG모빌리언스
+  - 페이먼트월
+  - KICC
+  - 헥토파이낸셜
+  - 네이버페이(결제형)
+  - 페이코
+  - 토스페이먼츠
+  - 나이스페이먼츠
+  - 다날
+  - NHN KCP
+  - 카카오페이
+  - KG이니시스
+searchTags:
+  - 결제한도
+  - 한도
+  - 최대금액
+  - 최소금액
+  - 최대결제금액
+  - 최소결제금액
+datetime: 2024-01-25T15:00:00.000Z
+---
+
+<Callout content="결제대행사별로 기본적으로 설정되는 최소/최대 결제 가능금액을 안내드리며, 
+심사 결과에 따라 금액은 상이해질 수 있는 점 참고해주시기 바랍니다." />
+
+#### **카카오페이**
+
+- **실제 운영 환경**
+  - 신용카드
+    - 최소 : 100원
+    - 최대 : 200만원 미만
+  - 카카오머니
+    - 최소 : 100원
+    - 최대 : 1회 결제한도 200만원 (1회 충전한도는 200만원, 제한 한도 금액은 없음)
+- **테스트 운영 환경**
+  - 신용카드
+    - 최소 : 설정되어 있지 않음
+    - 최대 : 100만원 미만
+  - 카카오머니
+    - 최소 : 설정되어 있지 않음
+    - 최대 : 100만원
+
+#### **NHN KCP**
+
+- **실제 운영 환경**
+  - 신용카드 : 최소 1000원(별도 요청 시 100원까지 설정 가능합니다)
+  - 실시간 계좌이체 : 최소 400원
+  - 가상계좌 : 최소 301원
+  - 휴대폰 소액 결제 : 최소 400원
+  - 수기 및 간편결제도 동일하며, 카카오 머니와 SSG 머니는 최소 100원 이상
+- **테스트 운영 환경**
+  - 신용카드 : 최소 100원
+  - 실시간 계좌 이체 : 최소 100원
+  - 가상계좌 : 최소 1원
+  - 휴대폰 소액결제 : 최소 1원
+
+#### **KG이니시스**
+
+- **실제 운영 환경**
+  - 신용카드 : 최소 100원 / 삼성카드 100원 , 그 외 카드 10원
+    (다만, 최소결제 금액은 van사와 카드사 정책에 따라 변경될 수 있습니다)
+  - 실시간 계좌이체 : 최소 150원 (우리은행의 경우, 151원부터 결제 가능)
+  - 휴대폰 소액결제 : 최소 300원 (300원 미만 결제를 원할 경우, 원천사 별도 협의 필요)
+- **테스트 운영 환경**
+  - 휴대폰 결제 : 최소 1원 (테스트 MID라 별도 협의됨)
+
+#### **다날**
+
+- **실제 운영 환경**
+  - 신용카드 : 최소 100원
+  - 실시간 계좌이체 : 최소 301원
+  - 가상계좌 : 최소 301원
+  - 휴대폰 소액결제 : 최소 301원
+
+#### **토스페이먼츠**
+
+- **실제 운영 환경**
+  - 신용카드 : 최소 100원
+  - 실시간 계좌이체 : 최소 200원
+  - 가상계좌 : 최소 1원
+  - 휴대폰 소액결제 : 최소 300원
+
+#### **페이코**
+
+- **실제 운영 환경**
+  - 신용카드 : 최소 100원 (30만원 이상 결제 시 ARS 인증\_공인인증서 불필요)
+  - 간편계좌 : 최소 100원 (일 200만원 / 월 500만원 한도)
+  - 가상계좌 : 최소 100원
+  - 쿠폰 : 없음 (사용 가능한 결제 수단은 쿠폰별 상이)
+  - 포인트: 1원 ( ID 당 최대 200만 포인트까지만 보유 가능)
+
+#### **KG모빌리언스**
+
+- **실제 운영 환경**
+  - 휴대폰 소액결제 : 최소 301원
+
+#### **네이버페이**
+
+- **실제 운영 환경**
+  - 신용카드 : 최소 10원
+  - 간편계좌 : 최소 10원
+  - 포인트 : 최소 10원
+
+#### **나이스페이먼츠**
+
+- **실제 운영 환경**
+  - 신용카드 : 최소 100원
+  - 실시간 계좌이체 : 최소 200원
+  - 가상계좌 : 최소 1원
+  - 휴대폰 소액결제 : 최소 500원
+
+#### **페이먼트월**
+
+- **실제 운영 환경**
+  - 결제수단별로 각각 상이하며 아래 가이드에서 상세 확인 가능(Min Transaction Limit)
+  - [페이먼트월 결제수단별 상세 기준 보러가기↗](https://docs.paymentwall.com/payment-method/credit-card)
+
+#### **이지페이(KICC)**
+
+- **실제 운영 환경**
+  - 신용카드 : 최소 100원
+
+#### **헥토파이낸셜**
+
+- **실제 운영 환경**
+  - 신용카드 : 최대한도는 계약 시 심사 후 결정 (보통 1회 최대 승인한도 1\~2천만원)\
+    (심사결과에 따라 달라질 수 있음)
+  - 실시간 계좌이체 : 최대 2백만원
+  - 가상계좌 : 최대 1백만원
+
+#### 웰컴페이먼츠
+
+- **실제 운영 환경**
+  - 신용카드 (일반, 수기, 빌링 동일)
+    - 최소 : 1,000원이하로 설정가능
+    - 최대 : 999,999,999원 (단, RM과 협의 필요)
+  - 간편결제
+    - 신용카드와 동일
+  - 계좌이체
+    - 최소 : 300원 이상
+  - 가상계좌
+    - 최소 : 300원 이상
+  - 휴대폰
+    - 최소 : 없음
+    - 최대 : 200만원

package/assets/docs/help/faq/payment-faq/receipt-guide.md

@@ -0,0 +1,38 @@
+---
+title: 매출전표는 어떻게 확인하나요?
+category: 자주 묻는 질문 (일반 문의) > 결제서비스 > 결제서비스
+seo:
+  title: 영수증 확인방법
+  description: >-
+    포트원을 통한 영수증 확인방법을 안내드립니다. 포트원은 PG사에서 제공하는 매출전표 URL을 그대로 전달하고 있습니다. 현재 URL
+    형태로만 제공되며 PG사에 따라 URL 접속시 구매정보를 인증할 수도 있습니다.
+  keywords:
+    - 영수증
+tags:
+  - 공통
+  - 영수증
+pgCompanies:
+  - 공통
+searchTags:
+  - 승인전표
+  - 매출전표 조회
+  - 매출전표
+---
+
+<Callout content="포트원은 PG사에서 제공하는 매출전표의 URL을 그대로 전달드리고 있습니다.
+영수증은 현재 URL 형태로만 제공되고 있으며 PG사에 따라 URL 접속시 구매정보를 인증해야할 수 있습니다." />
+
+### **매출전표 확인방법**
+
+**1. 포트원 관리자콘솔 내 조회**
+
+- [포트원 관리자 콘솔](https://admin.portone.io/) > 결제내역 > 확인이 필요한 결제 행 클릭 > 결제내역 상세 > 승인영수증
+
+
+
+##### **2. API 호출 후 응답**
+
+##### API 호출하시면 매출전표 URL을 나타내는 receipt\_url 파라미터가 응답됩니다.
+
+- 결제정보 조회 API : GET /payments/`{imp_uid}`
+- 결제정보 조회 API : GET /payments/`{imp_uid}`

package/assets/docs/help/faq/payment-faq/tosspayments-cash-receipt.md

@@ -0,0 +1,32 @@
+---
+title: 토스페이먼츠 현금영수증 옵션을 제어할 수 있나요?
+category: 자주 묻는 질문 (일반 문의) > 결제서비스 > 결제서비스
+seo:
+  title: 토스페이먼츠 현금영수증 노출제어방법
+  description: >-
+    토스페이먼츠의 현금영수증 발행화면 제어 방법 안내입니다. 토스페이먼츠를 통해 현금영수증을 발행하시는 경우 결제수단별로 토스페이먼츠 결제창
+    내 현금영수증 발행여부의 노출여부를 제어할 수 있습니다.
+  keywords:
+    - 현금영수증
+tags:
+  - 토스페이먼츠
+  - 현금영수증
+pgCompanies:
+  - 토스페이먼츠
+searchTags:
+  - 현금영수증 노출
+  - 토스페이먼츠 현금영수증
+datetime: 2024-01-25T15:00:00.000Z
+---
+
+<Callout content="토스페이먼츠의 현금영수증 발행화면을 제어할 수 있는 방법을 안내드립니다." />
+
+### **토스페이먼츠 결제창 내 현금영수증 노출 제어**
+
+토스페이먼츠를 통해 현금영수증을 발행하시는 경우 결제수단별로 토스페이먼츠 결제창 내 ‘현금영수증 발행여부’ 노출여부를 제어할 수 있습니다.
+
+- 경로 : [토스페이먼츠 상점관리자페이지↗](https://app.tosspayments.com/) > 상점정보관리 > MID 검색 > 결제수단 관리에서 각 지불수단 선택 후 현금영수증 사용여부 확인
+
+현금영수증은 발행 유형과 관련하여 보다 자세한 안내는 아래에서 확인하실 수 있습니다.
+
+<Callout title="현금영수증 발행방법 보러가기↗" icon="" />

package/assets/docs/help/faq/payment-faq/vbank-info.md

@@ -0,0 +1,35 @@
+---
+title: 가상계좌 계좌정보는 어떻게 확인할 수 있나요?
+category: 자주 묻는 질문 (일반 문의) > 결제서비스 > 결제서비스
+tags:
+  - 공통
+  - 가상계좌
+pgCompanies:
+  - 공통
+searchTags:
+  - 가상계좌은행정보
+  - 계좌번호조회
+  - 가상계좌조회
+datetime: 2024-04-18T10:00:41.772Z
+---
+
+<Callout content="발급되는 가상계좌를 고객에게 보여주거나 따로 발송하기 위해서는 가상계좌정보를 가지고 계셔야 해요! 아쉽게도 계좌발급 이후 포트원에서 자동으로 구매자에게 계좌정보를 보내드리는 기능을 제공드리고 있지 않습니다" />
+
+#### 1. API 로 정보 받아오기
+
+아래 API 호출하여 가상계좌 관련된 응답값을 받아보실 수 있습니다.파라메터를 활용하시어 고객에게 문자발송 & 카카오톡 안내 & 마이페이지에 표기 등 원하시는 로직을 구현하실 수 있습니다.
+
+API : [`GET /payments/\{imp_uid\}`](https://developers.portone.io/api/rest-v1/payment#get%20%2Fpayments%2F%7Bimp_uid%7D)
+
+- 가상계좌 응답 파라메터
+  - vbank\_code (string) : 가상계좌 은행 표준코드 (금융결제원기준)
+  - vbank\_name (string): 입금받을 가상계좌 은행명
+  - vbank\_num (string) : 입금받을 가상계좌 계좌번호
+  - vbank\_holder (string) : 입금받을 가상계좌 예금주
+  - vbank\_date (integer) : 입금받을 가상계좌 마감기한 UNIX timestamp
+  - vbank\_issued\_at (integer) : 가상계좌 생성 시각 UNIX timestamp
+
+#### 2. 포트원 관리자콘솔에서 확인하기
+
+포트원 관리자콘솔 > 통합 결제 > 결제내역 상세 > 결제정보 ‘결제수단’ 에서 확인가능
+

package/assets/docs/help/faq/payment-faq/vbank-service-detail.md

@@ -0,0 +1,67 @@
+---
+title: 가상계좌는 어떤 방식으로 연동할 수 있나요?
+category: 자주 묻는 질문 (일반 문의) > 결제서비스 > 결제서비스
+seo:
+  title: 가상계좌 서비스 특징 상세 안내
+  description: >-
+    가상계좌를 이용한다면 필수적으로 알아야 할 가상계좌의 특성을 설명드립니다. 가상계좌 특성부터, 필수 설정, 연동가능 방식까지, 포트원이
+    준비한 가이드를 확인해보세요.
+  keywords:
+    - 일반
+tags:
+  - 공통
+  - 일반결제
+  - 가상계좌
+pgCompanies:
+  - 공통
+searchTags:
+  - API방식
+  - 결제창방식
+  - 회전식
+  - 고정식
+  - 무통장입금
+  - 입금통보
+  - 입금통지
+  - 웹훅
+  - 가상계좌연동
+  - 가상계좌환불
+  - 가상계좌
+datetime: 2024-01-25T15:00:00.000Z
+---
+
+<Callout content="포트원에서 제공해드리는 가상계좌의 특성과 연동시 유의사항까지 안내드립니다." />
+
+### **포트원에서 지원하는 가상계좌의 특성**
+
+가상계좌는 가상의 계좌를 먼저 발급받고 고객이 원하는 시간에 입금을 하는 결제수단입니다.
+
+입금시 사업자의 서버로 입금통지를 줌으로써 사업자에서는 입금완료에 대한 주문처리를 진행합니다. 입금된 결제금은 결제대행사(PG사)에서 가지고 있다가 추후 사업자의 계좌로 정산이 이루어지며, 고객이 사업자의 계좌로 직접 입금하는 무통장입금 서비스과는 다소 차이가 있습니다.
+
+포트원에서 제공드리는 가상계좌는 회전식 과 고정식이 있습니다.
+
+- **회전식 가상계좌** : 포트원은 매 결제 시도시마다 새로운 계좌정보가 발급되는 **회전식** 방식을 지원합니다.
+- **고정식 가상계좌** : 고객별로 고정된 가상계좌 정보를 부여하는 방식인 **고정식**은 현재  KCP, 나이스페이먼츠, 스마트로, kg이니시스, 토스페이먼츠 에서 지원합니다.
+
+### **가상계좌 연동시 필수 설정사항**
+
+계좌를 채번(발급)했을 때 부여되는 기본 결제상태는 **status : ready(미결제)** 이며 구매자가 입금을 했을 때 \*\*status: paid (결제완료)\*\*로 변경됩니다.
+
+구매자 입금에 대한 통지는 결제대행사 (PG사) > 포트원 > 사업자 순으로 전달되며 이를 위해 아래 2가지 사항을 반드시 설정해주셔야 합니다. 미설정시 구매자가 입금을 했음에도 결제상태가 '미결제'로 남아있게 되오니 유의하여 주시기 바랍니다.
+
+1. PG사 > 포트원으로 입금통지 : 가상계좌 입금통보 URL 설정\
+   (테스트용 상점아이디에는 자동으로 설정되어있습니다.)
+2. 포트원 > 고객사 서버로 입금통지: 결제알림(Webhook) 관리 설정\
+   (웹훅 설정방법 : 포트원 관리자콘솔 > 결제연동 > 결제알림(Webhook) 관리 > Endpoint URL 입력)
+
+
+
+
+
+### **가상계좌 연동 가능 방식**
+
+가상계좌 발급은 결제대행사의 결제창을 띄워 발급받는 결제창방식 과 API 호출로 발급받는 API 방식을 모두 지원합니다. 각 방식별로 지원가능한 결제대행사는 다음과 같습니다.
+
+- **결제창 방식** : NHN KCP, KG이니시스, KG모빌리언스, 나이스페이먼츠, 다날, 헥토파이낸셜(구 세틀뱅크), 토스페이먼츠, 다우데이타 , 스마트로, KSNET, 이지페이(KICC) , 웰컴페이먼츠
+- **API 방식** : 헥토파이낸셜(구 세틀뱅크) , 나이스페이먼츠, KG이니시스, 토스페이먼츠, KSNET, 스마트로(신모듈), 나이스페이먼츠(신모듈), 웰컴페이먼츠 , KCP(v2)
+
+<Callout title="REST API - V2 가상계좌 발급 API 연동 가이드 보러가기 ↗" />

package/assets/docs/help/faq/payment-faq/vbank-test-guide.md

@@ -0,0 +1,65 @@
+---
+title: 가상계좌는 어떻게 테스트 할 수 있나요?
+category: 자주 묻는 질문 (일반 문의) > 결제서비스 > 결제서비스
+seo:
+  title: 가상계좌 테스트 결제방법
+  description: 가상계좌 테스트 방법 및 가상계좌 테스트 강제환불 방법까지 중요한 체크사항에 대해 포트원이 안내드립니다.
+  keywords:
+    - 일반결제
+tags:
+  - 공통
+  - 일반결제
+  - 가상계좌
+pgCompanies:
+  - 공통
+searchTags:
+  - KC이니시스 가상계좌 테스트
+  - 가상계좌 테스트 환불
+  - 가상계좌
+  - 가상계좌 테스트
+datetime: 2024-01-25T15:00:00.000Z
+---
+
+<Callout content="가상계좌의 테스트 결제방법을 안내해 드립니다. 테스트 환경에서는 발급된 가상 계좌에 실제 입금하시면 환불이 불가하오니 실 입금은 지양해 주시기 바랍니다." />
+
+### **가상계좌 테스트 방법**
+
+결제대행사에서는 테스트 환경의 가상 계좌 환불 기능을 제공하고 있지 않습니다. 하지만, 입금이 되었음을 알리는 통지를 통해 임의로 결제 완료 응답을 받아보실 수가 있습니다.
+
+임의로 통지를 받아 결제상태가 ‘결제 완료' 로 변경된 경우 실 입금이 되지 않았기 때문에 취소 테스트가 불가하며 API 호출 시  '요청하신 건에 대해 입금된 내역이 없습니다' 등의 오류메시지가 응답되니 참고해주시기 바랍니다.
+
+- 웹훅 임의 통지 경로 : [포트원 관리자콘솔↗](https://admin.portone.io/) > 테스트 결제내역 클릭 > 결제내역 상세 > 테스트 입금웹훅통지 클릭
+
+
+
+### **체크사항**
+
+1. **포트원 내 웹훅 설정 여부 확인하기**
+
+
+
+**2. 테스트된 결제내역을 확인하기 위해 필터링 옵션 '테스트결제' 체크하기**
+
+
+
+**3. 실 운영환경의 경우 가상계좌 환불** 특약 **여부 체크하기**
+
+실 운영환경에서도 가상계좌 환불 서비스를 이용하시려면 PG 사를 통해 환불 특약을 맺어야 합니다.  (다날 PG사 예외 : 가상계좌 환불 미지원)
+
+#### **가상계좌 실 입금 거래 강제환불 방법**
+
+가상계좌는 실 입금에 대한 통지나 결제상태 동기화가 어려우며, 마찬가지로 환불도 불가합니다.
+
+만약 실수로 테스트 환경에서 발급받으신 계좌로 실 입금을 하셨다면 강제 환불 처리가 필요합니다. 포트원 고객센터로 거래 건의 정보를 아래의 형식으로 작성하여 전달해주시기 바랍니다. (<cs@portone.io>)
+
+- 가입 PG사명 :
+- 거래 고유번호(imp\_uid) :
+- 결제 금액 :
+- 환불 계좌 정보 : 은행 / 계좌번호 / 예금주명
+
+#### **KG이니시스 가상계좌로 실 입금을 하신 경우**
+
+KG이니시스의 경우 아래의 경로로 직접 강제환불 처리가 가능합니다.
+
+- 경로 : [KG이니시스 상점관리자페이지↗](https://iniweb.inicis.com/security/login.do) 로그인 (ID : INIpayTest / PW : inicis\~1111) > 거래내역 > 가상계좌 ‘입금결과조회’ > 주문번호 항목에 포트원 imp\_uid 입력 후 조회
+