@portone/mcp-server 0.13.0

package/assets/docs/help/core-service/payment-type/tosspayment-international.md

@@ -0,0 +1,54 @@
+---
+title: 토스페이먼츠 해외결제 서비스 이용안내
+category: 결제서비스 (채널설정 및 이용안내) > 결제유형 > 해외결제
+seo:
+  title: 토스페이먼츠 해외결제 서비스 이용안내
+  description: >-
+    토스페이먼츠의 해외카드결제 서비스를 통한 해외결제 이용방법 안내드립니다. 토스페이먼츠의 지원결제 수단 및 서비스 특징, 입점기준,
+    토스페이먼츠 MID추가 절차, 참고사항까지 자세한 정보를 확인해보세요.
+  keywords:
+    - 해외결제
+tags:
+  - 토스페이먼츠
+  - 해외결제
+pgCompanies:
+  - 토스페이먼츠
+searchTags:
+  - 해외카드 특약
+  - 해외카드
+  - 토스페이먼츠 해외결제
+  - 해외결제
+datetime: 2024-01-25T15:00:00.000Z
+---
+
+<Callout content="토스페이먼츠를 통한 해외결제 이용방법 안내드립니다." />
+
+#### **토스페이먼츠의 해외카드결제 서비스 이용안내**
+
+1. **지원 결제수단**
+
+- 해외카드 (VISA, MASTER, JCB)
+
+##### **2. 지원 서비스 특징**
+
+- 지원가능 통화 : KRW (승인/정산)
+- 결제방식 : 토스페이먼츠 결제창을 띄우는 방식으로만 가능
+- 지원가능언어 : 한국어, 영어, 중국어
+- 정산방식 : 원화정산
+
+##### **3. 입점기준**
+
+- 국내사업자로만 계약이 가능합니다. (해외 법인 사업자 계약불가)
+- 토스페이먼츠를 통해 해외카드 사용 특약을 맺은 후 서비스 사용이 가능합니다.
+- 컨텐츠 상품도 입점심사을 받아볼 수 있습니다.
+
+##### **4. 참고사항**
+
+- 토스페이먼츠의 경우에는 해외카드 결제 시 국내 카드 결제와 비슷하게 인증시스템(3D인증)을 거쳐야하기에 인증 절차가 없는 해외 결제자들에게는 결제를 하는데 불편함이 있습니다.
+
+##### **5. 신청방법**
+
+기존에 토스페이먼츠를 통해 국내결제만 이용하고 계셨다면 해외결제용 MID 추가발급이 필요합니다.\
+신규계약절차와 동일한 접수 프로세스로 진행 해주시기 바랍니다.
+
+<Callout title="토스페이먼츠 상점아이디 추가절차 보러가기 ↗" icon="" />

package/assets/docs/help/core-service/payment-type/tosspayments-easypay-hub-fee.md

@@ -0,0 +1,42 @@
+---
+title: 토스페이먼츠_허브형 간편결제 추가 방법 안내
+category: 결제서비스 (채널설정 및 이용안내) > 결제유형 > 간편결제
+seo:
+  title: 토스페이먼츠_허브형 간편결제 추가 방법 안내
+  description: |
+    토스페이먼츠에 이미 가입되어 있으신 경우,
+    토스페이먼츠측에 간편결제 추가계약 절차가 필요 합니다!
+tags:
+  - 간편결제
+  - 토스페이먼츠
+pgCompanies:
+  - 토스페이먼츠
+searchTags:
+  - 추가계약
+  - 간편결제 추가
+  - 간편결제
+  - 허브형
+  - 토스페이먼츠
+datetime: 2024-07-10T07:39:34.415Z
+---
+
+<Callout content=" 토스페이먼츠에 이미 가입되어 있으신 경우, 
+토스페이먼츠측에 간편결제 추가계약 절차가 필요 합니다!" />
+
+### 토스페이먼츠 추가계약 절차
+
+- 토스페이먼츠 홈페이지 <https://www.tosspayments.com/> 접속 > 기존 토스페이먼츠 계정 로그인
+- 로그인 후 화면 하단 "전자결제 신청" 선택
+- 사업자등록번호 입력
+- 호스팅사에서 제공하는 쇼핑몰 구축 서비스를 이용 중이신가요? > “네” 선택
+- 이용중인 호스팅사를 선택하세요 > "\[다른 업체 검색]" 선택 후 검색란에 "포트원(간편결제)" 입력
+- 검색된 리스트 중 "포트원(간편결제)" 선택
+
+신청접수가 완료되면 토스페이먼츠 담당자가 계약절차 및 계약서류 안내드릴 예정입니다. (약 3영업일 소요)
+
+
+
+- 토스페이먼츠는 일반결제와 허브형 간편결제용 MID가 개발 발급되므로, 추가 설정하시어 pg파라미터에 MID를 지정하여 요청하도록 구현 부탁 드립니다.
+- [허브형 간편결제 이용 방법 보러가기 ↗](https://help-center-portone.vercel.app/content/hub-service-fee)
+- [토스페이먼츠\_간편결제 연동 방법 ↗](https://guide.portone.io/67330b1b-24a9-444a-a394-a2783e8876a2)
+- [토스페이먼츠\_애플페이 이용 방법 보러가기 ↗ ](https://guide.portone.io/67330b1b-24a9-444a-a394-a2783e8876a2)

package/assets/docs/help/core-service/payment-type/webhook-re-send.md

@@ -0,0 +1,41 @@
+---
+title: 웹훅 재 발송 기능
+category: 결제서비스 (채널설정 및 이용안내) > 결제유형 > 정기결제
+seo:
+  description: 웹훅 재발송 기능을 설명하고 설정할 수 있는 방법에 대한 가이드입니다.
+tags:
+  - 공통
+pgCompanies:
+  - null
+searchTags:
+  - 웹훅
+  - 웹훅발송
+  - 웹훅재발송
+datetime: 2024-04-18T10:00:41.772Z
+---
+
+<Callout icon="" title="웹훅 관련 정보" content="웹훅은 최초 또는 재발송 통해 전송이 가능하며, 각각 타임아웃이 다릅니다.
+1.  최초 웹훅의 경우 &quot;Connection TimeOut 설정시각은 10초&quot;이며 가맹접 웹훅응답을 기다리는 &quot;Read TimeOut 시각은 30초&quot;입니다.
+2.  재발송 웹훅의 경우 &quot;요청에 대한 전체 타임아웃이 15초&quot; 입니다." />
+
+#### **1.** **자동** **재발송기능** **설정**
+
+포트원의 웹훅은 1회 발송을 기본으로 하나, 고객사의 일시적인 오류 등으로 인하여 오류코드 응답시 1분단위로 최대 5회까지 재 전송되도록 설정이 가능합니다. \
+아래 옵션 중 설정을 원하시는 경우를 선택하여 포트원 고객지원팀(<cs@portone.io>)으로 포트원 계정 주소와 함께 웹훅 재발송 기능적용을 요청 주시기 바랍니다.
+
+\[설정옵션]
+
+- 응답코드 : 0 혹은 500번대 일 때 발송
+
+<Callout icon="💡" title="참고사항" content="**웹훅 응답코드가 0번, 500번대 인 경우**
+웹훅 로그상 포트원→고객사로 정상적인 통지는 이루어졌으나, 응답 코드가 0번대 혹은 500번대로 오류가 발생된다면, 운영하시는 수신 서버(고객사 서버)에서 요청된 파라메터 데이터가 올바르지 않다고 판단하여 오류로 응답한 것입니다.
+오류로 응답하신 사유는 포트원에서 파악하기 어려우며, 내부적으로 로그를 확인해주셔야 확인이 가능합니다 😊" />
+
+#### **2.** **수기** **재발송** **기능**
+
+• [포트원 관리자콘솔](https://admin.portone.io/) > 결제내역 > 결제내역 상세 > 웹훅 재발송 >웹훅 관리 클릭!
+
+• 웹훅 로그에서 "웹훅 재발송처리" 도 가능 !
+
+
+

package/assets/docs/help/faq/console-faq/2-depth-auth.md

@@ -0,0 +1,53 @@
+---
+title: 관리자 콘솔은 2차 인증을 설정할 수 있나요?
+category: 자주 묻는 질문 (일반 문의) > 관리자콘솔 > 관리자콘솔 문의
+seo:
+  title: 관리자 콘솔은 2차 인증을 설정할 수 있나요?
+  description: 이중 보안을 위한 포트원 관리자콘솔의 2차 인증 설정방법 안내드립니다. 구글 OTP 앱 설치 방법까지 추가로 확인해보세요.
+  keywords:
+    - 관리자콘솔
+tags:
+  - 관리자콘솔
+pgCompanies:
+  - 공통
+searchTags:
+  - 구글OTP
+  - 콘솔인증
+  - 2차인증
+datetime: 2024-01-25T15:00:00.000Z
+---
+
+<Callout content="" title="포트원 관리자콘솔의 이중 보안이 가능한 2차 인증 설정방법을 안내드립니다." />
+
+#### **관리자콘솔 내 2차 인증 설정 경로**
+
+- 포트원 관리자콘솔 > 상점·계정 관리 > 내 정보 관리 > 2차 인증
+
+#### **구글 OTP 설치 방법**
+
+1. 앱스토어에서 "Google Authenticator(Google OTP)" 앱 설치
+   - [안드로이드 앱 설치 경로 ↗](https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2\&hl=ko)
+   - [아이폰 앱 설치 경로 ↗](https://apps.apple.com/kr/app/google-authenticator/id388497605)
+2. 설치한 앱의 오른쪽 '+'버튼 클릭
+   - 안드로이드의 경우 하단에 위치
+   - 아이폰의 경우 상단에 위치
+3. 'QR코드 스캔' 선택 후 [포트원 관리자콘솔 ↗](https://admin.portone.io/auth/signin) 내 QR코드 스캔
+4. 등록 완료!
+
+#### **참고사항**
+
+- QR코드는 페이지를 새로고침하는 경우 변경 됩니다. \
+  (등록 진행시 페이지를 새로고침하는 경우 다시 QR코드를 리딩 해야 함)
+- Google OTP앱에 발급되는 OTP 6자리 숫자는 30초마다 새로운 번호로 갱신 됩니다.
+- 로그인 계정을 제 3자와 공유하여 이용하는 경우 아래와 같은 방법으로 추가 등록 가능합니다.
+
+<Indent level="1">
+
+1. 최초 등록한 사용자가 포트원 관리자콘솔 로그인
+2. 관리자콘솔 > 시스템설정 > 의 하단 좌측 'TOTP 2차인증'의 QR코드를 새로운 기기로 스캔
+3. 구글 OTP앱 OTP 6자리 숫자 발급 (최초 등록된 사용자와 동일한 번호 발급
+
+</Indent>
+
+- 등록된 QR코드는 변경되지 않으므로 제 3자와 공유시 OTP코드는 동일한 코드로 발급 됩니다.
+- 최초 등록 후 2차 인증 기능 사용을 원하지 않는 경우, 등록된 사용자가 포트원 관리자콘솔 로그인을 한 후, 상점·계정 관리 > 내 정보 관리 2차인증 에 등록된 \[삭제] 버튼을 클릭하면 되며, 이후 로그인시 ID + PWD 만으로 로그인 가능 합니다.

package/assets/docs/help/faq/console-faq/add-admin-account.md

@@ -0,0 +1,42 @@
+---
+title: 관리자 계정은 몇 개까지 추가할 수 있나요?
+category: 자주 묻는 질문 (일반 문의) > 관리자콘솔 > 관리자콘솔 문의
+seo:
+  title: 관리자 계정은 몇 개까지 추가할 수 있나요?
+  description: >-
+    포트원 관리자콘솔 계정의 권한별 생성가능한 경로 및 갯수 안내입니다. 계정추가 경로, 권한별 설정가능 갯수, 권한별 이용 가능한 기능
+    모두 확인해보세요.
+  keywords:
+    - 관리자콘솔
+tags:
+  - 관리자콘솔
+pgCompanies:
+  - 공통
+searchTags:
+  - 권한추가
+  - 관리자권한추가
+  - 관리자권한
+  - 관리자계정
+datetime: 2024-01-25T15:00:00.000Z
+---
+
+<Callout content="" title="포트원 관리자콘솔의 계정의 권한별 생성가능한 경로 및 갯수를 안내드립니다." />
+
+#### **계정추가 경로**
+
+[관리자콘솔 상점·계정관리 ↗](https://admin.portone.io/merchant) > 관리자 계정관리 > 관리자계정 추가
+
+
+
+#### **권한별 설정가능 갯수**
+
+- admin : 1개
+- dev : 10개
+- manager / read only : 갯수 제한 없음
+
+#### **권한별 이용 가능한 기능**
+
+- admin : 전체 권한
+- dev : 연동, 내역 조회
+- manager : 내역 조회/수정, 리포트, 계정 관리
+- read only : 내역 조회/ 리포트

package/assets/docs/help/faq/console-faq/change-console-url.md

@@ -0,0 +1,51 @@
+---
+title: 관리자콘솔의 계정 주소를 변경할 수 있나요?
+category: 자주 묻는 질문 (일반 문의) > 관리자콘솔 > 관리자콘솔 문의
+seo:
+  title: 관리자콘솔의 계정 주소를 변경할 수 있나요?
+  description: 포트원 관리자콘솔 로그인 메일주소를 변경할 수 있는 방법 안내입니다. 로그인이 불가하신 경우에는 별도의 인증과정이 진행될 수 있습니다.
+  keywords:
+    - 관리자콘솔
+tags:
+  - 관리자콘솔
+pgCompanies:
+  - 공통
+searchTags:
+  - 메일주소변경
+  - 관리자콘솔계정
+  - 계정주소변경
+  - 계정변경
+datetime: 2024-01-25T15:00:00.000Z
+---
+
+<Callout content="로그인이 불가하신 경우 별도 인증과정이 진행될 수 있는 점 참고부탁드립니다." title="포트원 관리자콘솔 로그인 메일주소를 변경할 수 있는 방법을 안내드립니다." />
+
+#### **관리자콘솔 로그인이 가능한 경우**
+
+- [포트원 관리자콘솔 로그인↗](https://admin.portone.io/) > 설정 > 내 정보 관리 > 이메일 변경
+
+<Callout content=" 포트원 관리자콘솔 내 한번도 가입된 적 없는 계정으로만 변경이 가능합니다." icon="❗" title="유의사항" />
+
+
+
+
+
+#### **관리자콘솔 로그인이 불가한 경우**
+
+[포트원 관리자콘솔↗](https://admin.portone.io/) > 비밀번호 재설정 > 메일로 비밀번호 재설정 링크 수신 후 변경가능
+
+
+
+
+
+#### **관리자콘솔 로그인 & 메일 수신이 불가한 경우**
+
+아래 정보를 포트원 고객지원팀(<cs@portone.io>)으로 전달하신 후 강제로 포트원 메일주소를 변경합니다. \
+(변경된 메일주소로 비밀번호 재설정링크 수신하여 변경 가능합니다)
+
+- 상호명 :
+- 사업자번호 :
+- 대표자명 :
+- 대표자 생년월일 :
+- 고객사 식별코드 :
+- 이용하시는 결제대행사(PG사) / 상점아이디 :

package/assets/docs/help/faq/console-faq/impossible-login.md

@@ -0,0 +1,30 @@
+---
+title: 관리자 콘솔 로그인이 안될 땐 어떻게 하나요?
+category: 자주 묻는 질문 (일반 문의) > 관리자콘솔 > 관리자콘솔 문의
+seo:
+  title: 관리자 콘솔 로그인이 안될 땐 어떻게 하나요?
+  description: 포트원 관리자콘솔 로그인 관련 문제가 발생한 경우 체크하실 사항을 안내드립니다.
+  keywords:
+    - 관리자콘솔
+tags:
+  - 관리자콘솔
+pgCompanies:
+  - 공통
+datetime: 2024-01-25T15:00:00.000Z
+---
+
+#### **포트원 계정으로 메일 수신이 `가능`한 경우**
+
+- [포트원 관리자콘솔↗ ](https://admin.portone.io/auth/signin) > 비밀번호 재설정 > 메일로 비밀번호 재설정 링크 수신 후 변경가능
+
+#### **포트원 계정으로 메일 수신이 `불가능`한 경우**
+
+아래 정보를 포트원 고객지원팀(<cs@portone.io>)으로 전달하신 후 강제로 포트원 메일주소를 변경합니다.\
+(변경된 메일주소로 비밀번호 재설정링크 수신하여 변경가능)
+
+- 상호명 :
+- 사업자번호 :
+- 대표자명 :
+- 대표자 생년월일 :
+- 고객사 식별코드 :
+- 이용하시는 결제대행사(PG사) / 상점아이디 :

package/assets/docs/help/faq/console-faq/payment-list.md

@@ -0,0 +1,45 @@
+---
+title: 포트원 결제내역은 어떤 기준으로 집계되나요?
+category: 자주 묻는 질문 (일반 문의) > 관리자콘솔 > 관리자콘솔 문의
+seo:
+  title: 포트원 결제내역은 어떤 기준으로 집계되나요?
+  description: 관리자콘솔 결제 상세내역의 집계 기준 안내입니다. 상세내역조회 집계기준, 홈 대시보드 집계기준 등 상세한 정보를 확인해보세요.
+  keywords:
+    - 관리자콘솔
+tags:
+  - 관리자콘솔
+pgCompanies:
+  - 공통
+searchTags:
+  - 홈대시보드
+  - 상태승인시각
+  - 결제요청시각
+  - 결제상세내역
+  - 집계기준
+  - 결제내역
+datetime: 2024-01-25T15:00:00.000Z
+---
+
+<Callout content="" title="관리자콘솔 결제 상세내역의 집계 기준을 안내드립니다." />
+
+<Callout content="결제내역은 결제요청시각 / 상태승인시각 으로 집계기준이 구분됩니다." title="미리 알아두기" icon="💡" />
+
+
+
+#### **상세내역조회 집계기준**
+
+- 결제 요청 시각 : 결제가 처음 요청된 시각을 기준으로 조회합니다.
+- 상태 승인 시각 : 결제상태가 가장 최근에 변경된 시각을 기준으로 조회합니다.
+- ex) 결제 1/2 일 / 취소 1/4일 경우 > 조회 날짜를 1/4\~1/4일로 고정하면 \
+  **결제 요청 시각** 기준에서는 결과가 나오지 않고 **상태 승인 시각** 기준에서는 결과가 조회 됩니다.
+
+#### **홈 대시보드의 집계기준**
+
+- 기간 동안 승인된 금액을 합계 (그 사이에 결제만 됐다면 무조건 합계포함)
+- 기간 동안 취소된 금액을 합계 (그 사이에 결제만 됐다면 무조건 합계포함)
+- 순거래액 : 승인 - 취소 합계
+
+#### **홈(대시보드) 집계기준과 비교하기**
+
+- 홈(대시보드)는 **결제 요청 시각 기준**으로만 집계가 되고 있습니다.
+- 또한 집계기준과 별개로 홈 화면에는 테스트 결제내역 및 해외결제를 포함하고 있지 않아 (KRW기준으로만 표기) 결제내역과의 차이가 발생될 수 있으며 결제내역에는 필터링 옵션이 존재하므로 필터링에 따라 다르게 조회될 여지가 있습니다.

package/assets/docs/help/faq/console-faq/sub-store-mgnt.md

@@ -0,0 +1,97 @@
+---
+title: 하위상점은 어떻게 설정할 수 있나요?
+category: 자주 묻는 질문 (일반 문의) > 관리자콘솔 > 관리자콘솔 문의
+seo:
+  title: 하위상점 관리 기능 이용방법
+  description: >-
+    하위상점 기능을 소개하고 관리자콘솔에서 설정하는 방법을 안내드립니다. 하위상점 추가 및 채널 설정방법, 연동시 참고사항까지 자세한 정보를
+    확인해보세요.
+tags:
+  - 관리자콘솔
+pgCompanies:
+  - 공통
+searchTags:
+  - 'Agent '
+  - 티어코드
+  - 하위상점기능
+  - 하위상점
+datetime: 2024-01-25T15:00:00.000Z
+---
+
+<Callout content="하위상점 기능을 소개하고 관리자콘솔에서 설정하는 방법을 안내드립니다." title="" />
+
+### **하위상점이란?**
+
+- 포트원 관리자콘솔에서 회원가입을 하면 기본적으로 생성되는 계정은 상위상점입니다.
+- 만약 상위상점에서 관리하는 상점이 있거나, 상위상점의 하위로 연계된 상점이 있을 경우 상위상점에서 관리하는 \[대표상점] 외 상점을 추가할 수 있습니다.
+- 하위상점은 티어코드(tier code)로 구분할 수 있으며 이를 기준으로 결제 연동시에 분리하실 수 있습다. (하위상점에 대해 3자리 고유코드와 지점명 지정 가능)
+
+### **하위상점 추가 및 채널 설정방법**
+
+1. **포트원 관리자콘솔 로그인**
+
+<Indent level="1">
+
+- 아직 한번도 회원가입하신 적이 없을 경우 새롭게 회원가입을 하신 후 로그인해주시기 바랍니다.
+- 또한 이미 회원가입이 되어있을 경우 로그인하신 계정이 Owner 권한의 계정인지 확인해주시기 바랍니다.
+
+</Indent>
+
+
+
+##### 2. **하위상점의 PG상점정보 설정**
+
+<Indent level="1">
+
+- 설정 > 하위 상점 관리 > 하위 상점 선택 > 정보 수정 클릭 후 원하는 PG사의 결제채널을 설정합니다.
+
+</Indent>
+
+
+
+
+
+<Callout title="채널 설정방법 보러가기 ↗" icon="" />
+
+##### 3. **하위상점 추가**
+
+<Indent level="1">
+
+- 설정 > 하위 상점 관리 > + 하위상점 추가를 클릭합니다.
+
+</Indent>
+
+
+
+<Indent level="1">
+
+- 사용할 결제채널 선택 에서 앞서 설정한 상점정보를 선택합니다.
+- 상점명, 결제채널,티어코드는 필수값이며, 그 외는 선택항목입니다.
+
+</Indent>
+
+
+
+<Callout title="결제알림(Webhook)은 대표 상점과 동일하게 설정할게요" content="- 대표상점 계정에 설정된 웹훅 URL 과 동일하게 설정하고 싶으시다면 체크해주세요!
+- 결제연동 > 실 연동관리 > 대표상점의 웹훅(Endpoint URL)을 먼저 저장해주셔야 합니다." icon="💡" />
+
+4\. **최종 확인**
+
+<Indent level="1">
+
+- 설정 > 하위 상점 관리 메뉴에서 설정한 하위상점을 선택 후 실 결제 채널이 올바르게 설정되었는지 확인합니다.
+
+</Indent>
+
+
+
+### **연동시 참고사항**
+
+- Agent 권한의 경우, IMP.init(고객사식별코드) 로 결제요청하는 방식이 아닌 하위몰별로 결제요청시 스크립트 단에서는 다음과 같이 Tier를 구분하여 호출하실 수 있습니다.
+- IMP.agency(고객사식별코드, Tier(고유)코드 3자리)\
+  예시) IMP.agency('imp12345678', '001')
+
+<Callout content="REST API호출시에는 '**Header**'에 Tier정보를 같이 보내야 해당 Tier에 대한 접근이 가능합니다.
+
+(예시)
+`&quot;Tier&quot; : &quot;티어코드 3자리&quot;`" title="꼭 기억해주세요!" icon="❗" />

package/assets/docs/help/faq/general-inquiry/change-business-number.md

@@ -0,0 +1,32 @@
+---
+title: 사업자번호가 바뀌면 어떻게 하나요?
+category: 자주 묻는 질문 (일반 문의) > 일반 문의 > 자주 묻는 질문
+seo:
+  title: 사업자번호가 바뀌면 어떻게 하나요?
+  description: >-
+    결제대행사와의 계약은 사업자번호를 기준으로 이루어집니다. 사업자번호 변경 시에는, 결제대행사의 정책에 따라 포트원을 통해 결제대행사와의
+    계약을 신규로 진행해주시기 바랍니다.
+  keywords:
+    - 계약절차
+tags:
+  - 계약절차
+pgCompanies:
+  - 공통
+searchTags:
+  - 양도양수
+  - 폐업
+  - 사업자변경
+  - 법인변경
+  - 개인법인변경
+  - 사업자번호
+  - 사업자번호 변경
+datetime: 2024-01-25T15:00:00.000Z
+---
+
+사업자의 ①양도양수 ②법인사업자로의 전환 ③폐업 후 신규 서비스 등록 등 다양한 사유로 사업자번호가 변경되는 경우가 존재할텐데요! 기본적으로 결제대행사와의 계약은 사업자번호를 기준으로 이루어집니다.
+
+따라서 사업자번호가 변경된다면, 결제대행사의 정책에 따라 포트원을 통해 결제대행사와의 계약을 신규로 진행해주셔야 합니다.
+
+신규 계약과 동시에 기존 서비스가 정상 운영되어야 하는 경우 연동 과정을 세밀히 신경써주셔야 하므로 관련 가이드를 자세히 참고해주세요.
+
+<Callout content="" icon="" title="사업자 양도양수(변경) 절차 바로가기 ↗" />

package/assets/docs/help/faq/general-inquiry/confirm-process.md

@@ -0,0 +1,118 @@
+---
+title: 결제직전에 재고를 확인할 수 있나요? (Confirm process)
+category: 자주 묻는 질문 (일반 문의) > 일반 문의 > 자주 묻는 질문
+seo:
+  title: 결제직전에 재고를 확인할 수 있나요? (Confirm process)
+  description: |
+    최종 결제승인 직전 가맹점에서 승인에 대한 확정을 한번 더 진행하실 수 있습니다.
+  keywords:
+    - 'confirm_url '
+    - 재고확인
+    - Confirm process
+tags:
+  - 공통
+pgCompanies:
+  - KG이니시스
+  - 다날
+  - NHN KCP
+  - 나이스페이먼츠
+  - 스마트로
+  - 토스페이먼츠
+  - 웰컴페이먼츠
+  - KICC
+  - KSNET
+  - 한국결제네트웍스(KPN)
+  - KG모빌리언스
+  - 스마일페이
+  - 페이팔
+  - 헥토파이낸셜
+  - 카카오페이
+  - 네이버페이(결제형)
+  - 토스페이
+  - 페이코
+searchTags:
+  - confirm_url
+  - 재고확인
+  - Confirm process
+datetime: 2024-04-16T08:08:41.539Z
+---
+
+<Callout content="최종 결제승인 직전 가맹점에서 승인에 대한 확정을 한번 더 진행하실 수 있습니다." />
+
+#### **지원가능한 PG사 알아보기**
+
+- 다날
+- KG이니시스
+- NHN KCP
+- KCP 퀵페이
+- 나이스페이먼츠
+- 스마트로
+- 토스페이먼츠
+- 웰컴페이먼츠
+- 이지페이(KICC)
+- KSNET
+- 한국결제네트웍스(KPN)
+- KG모빌리언스
+- 스마일페이
+- 페이팔
+- 헥토파이낸셜 내통장결제
+- 카카오페이
+- 네이버페이 결제형
+- 토스페이
+- 페이코
+
+#### **지원 불가한 PG사 확인하기**
+
+- 네이버페이 주문형
+- 다날 상품권결제
+- 키움페이
+- 엑심베이
+
+<Callout content="인스타그램 웹뷰는 구조상 confirm process 적용이 불가하기 때문에 가맹점에서 별도 분기 처리 로직을 추가해 주셔야 합니다. " icon="💡" title="유의사항" />
+
+#### **연동 방식**
+
+포트원 서버에서 PG사로 최종 요청 보내기 직전 포트원→ 가맹점으로 HTTP 요청을 보내게 됩니다.\
+(POST)  요청을 받을 URL은 매 결제건마다 confirm\_url 이라는 파라미터로 지정하실 수 있으며, 지정하지 않는 경우 기존처럼 그냥 결제 진행됩니다.
+
+POST 요청에 대해서는 5초 내로 응답을 해주셔야 하며(Timeout) 결제진행은 200응답, 거절은 그 외의 응답을 해주시면 됩니다.  (confirm\_url이 요청된 거래에 대해 Timeout 이 발생하면 500응답을 받은 것으로 간주하고 결제는 중단됩니다)
+
+- **IMP.request\_pay(param) 호출시 confirm\_url 파라미터 지정**
+
+포트원에서 결제진행여부를 확인할 URL을 입력해주세요! \
+결제승인 직전 해당 URL로 아래와 같은 POST요청을 보내게 됩니다. (Content-Type은 application/json 으로 보내게 됩니다)
+
+<Indent level="1">
+
+- imp\_uid
+- merchant\_uid
+- amount
+
+</Indent>
+
+```javascript
+IMP.request_pay({
+
+  //다른파라미터 생략
+
+  confirm_url: '
+
+  [https://test.com/payments/confirm](https://test.com/payments/confirm)
+
+  '
+
+})
+```
+
+- **포트원에서 confirm URL로 POST요청을 보냈을 때 결제를 진행하려면 HTTP Status 200 응답을, 그렇지 않으면 그 외의 응답을 보내시면 됩니다 (ex. 500)**\
+  응답본문 Json 에 reason 이라는 필드가 있으면 해당 정보를 결제실패사유로 기록하고 고객에게도 출력하게 됩니다.
+
+```javascript
+{
+
+  "reason" : "재고수량부족"
+
+}
+```
+
+<Callout content="이용을 원하시면 포트원 기술지원팀(support@portone.io)로 포트원 계정과 함께 confirm process 설정요청을 주시기 바랍니다." title="참고사항" icon="💡" />

package/assets/docs/help/faq/general-inquiry/content200004.md

@@ -0,0 +1,55 @@
+---
+title: 웹훅(Webhook)이 무엇인가요?
+category: 자주 묻는 질문 (일반 문의) > 일반 문의 > 자주 묻는 질문
+tags:
+  - 공통
+pgCompanies:
+  - null
+searchTags:
+  - webhook
+  - 웹훅
+datetime: 2024-05-29T15:00:00.000Z
+---
+
+## 웹훅(Webhook)이란?
+
+특정 이벤트가 발생하였을 때 타 서비스나 응용프로그램으로 알림을 보내는 기능입니다.
+
+- Webhook 프로바이더는 해당 이벤트가 발행하면 HTTP POST 요청을 생성하여 callback URL(endpoint)로 이벤트 정보을 보냅니다.
+- 주기적으로 데이터를 폴링(polling)하지 않고 원하는 이벤트에 대한 정보만 수신할 수 있어서 webhook은 리소스나 통신측면에서 훨씬 더 효율적입니다.
+- Webhook을 활용하면 커스텀 기능이나 다른 애플리케이션과 연동하여 기능을 확장할 수 있습니다.
+- 포트원에서는 결제 완료 등 이벤트가 발생했을 때 고객사의 서버에 전송하고 있습니다.
+- 이벤트가 발생하면 포트원 콘솔에 등록된 웹훅 URL로 HTTP POST 요청을 보냅니다.\
+  고객사에서는 이 요청을 받아 최신 결제 정보로 동기화 하도록 구현해야 합니다.
+
+## 웹훅 연동이 꼭 필요한가요?
+
+안정적인 결제 처리를 위해 웹훅 연동을 강력히 권장합니다. \
+인터넷 연결 끊김, 브라우저 자동 새로고침 등의 이유로 클라이언트에서 결제 완료에 대한 응답을 받지 못하는 경우가 간헐적으로 발생합니다. 이런 경우 연동한 웹훅을 통해 누락 없이 결제 정보를 동기화할 수 있습니다.
+
+## 웹훅 발생 이벤트
+
+포트원 웹훅은 다음과 같은 이벤트에 발생됩니다.
+
+- 결제가 승인되었을 때(모든 결제 수단) - (status : paid)
+- 가상계좌가 발급되었을 때 - (status : ready)
+- 가상계좌에 결제 금액이 입금되었을 때 - (status : paid)
+- 예약결제가 시도되었을 때 - (status : paid or failed)
+- 관리자 콘솔에서 결제 취소되었을 때 - (status : cancelled)
+
+<Callout icon="⚠" title="결제 실패 시에는 웹훅이 호출되지 않아요!" content="" />
+
+## 웹훅 URL 설정
+
+웹훅 URL을 설정하면 포트원에서 이벤트 발생 시 해당 URL로 웹훅을 전송합니다. URL은 관리자 콘솔에서 두 가지 형태로 지원하고 있습니다. 콘솔에서 설정했더라도 결제 시에 notice\_url파라미터로 지정하여 호출하는 경우 해당 URL로 전송됩니다.
+
+<Callout title="V2 웹훅 URL 설정 방법 보러가기↗" />
+
+<Callout title="V1 웹훅 URL 설정 방법 보러가기↗" />
+
+## 웹훅 재 전송이 가능한가요?
+
+웹훅은 기본적으로 1회 전송되도록 설정되어 있습니다. \
+네트워크 에러가 발생하거나 고객사 응답(HTTP 상태 코드)이 500번대인 경우, 재발송 설정을 원하신다면 웹훅이 최대 5회까지 1분 간격으로 재시도될 수 있습니다.
+
+<Callout title="웹훅 재발송 방법 보러가기 ↗" />