@portone/mcp-server 0.13.0

package/assets/docs/opi/ko/etc/recon.md

@@ -0,0 +1,286 @@
+---
+title: PG 거래대사 가이드
+description: >-
+  PG 거래대사는 PG사와 간편결제사로부터 정산 받는 금액 및 상세내역을 포트원 콘솔에서 PG가 여러 개여도 한 번에 자동 대사된 데이터를
+  확인할 수 있는 통합 조회 서비스입니다.
+---
+
+## PG 거래대사 유의사항
+
+- 포트원을 통해 연동된 아래 12개의 PG사 내역을 조회할 수 있습니다.
+  - 지원 PG : **KCP, KG이니시스, 나이스페이먼츠, 토스페이, 네이버페이, 다날, 페이코, (구)토스페이먼츠, 토스페이먼츠, 카카오페이, 엑심베이, 헥토파이낸셜**
+  - 고객사가 포트원을 통하지 않고 PG 직연동한 경우 지원 불가
+  - 9/26 이후 지원 예정 PG사 : KPN, 하이픈, KSNET
+
+- 고객사 주문번호를 정확하게 확인하기 위해서는 **실제 사용하시는 주문번호의 연동**이 필요합니다.
+
+- 네이버페이를 연동하실 경우 정산 API 키 등록이 필요합니다.
+
+## 거래대사 및 정산/입금대사 소개
+
+### 1. 거래대사
+
+- 포트원을 통해 발생한 고객사 주문 데이터와 PG사의 결제 데이터를 비교하여 신뢰도 높은 데이터를 제공합니다.
+
+- **주요 기능**
+  - 일별로 고객사 거래 데이터와 PG 정산 데이터를 매칭합니다.
+  - 여러 PG사와 결제수단을 한 번에 관리할 수 있습니다.
+  - PG사 어드민에서 직접 취소한 거래 건도 확인하실 수 있습니다.
+
+### 2. 정산/입금대사
+
+- 입금된 정산금의 상세 내역을 확인할 수 있는 자료를 제공합니다.
+
+- **주요 기능**
+  - 해당일의 PG 정산금 상세내역을 통해 입금 금액의 상세내역을 쉽게 확인할 수 있습니다.
+
+### 3. 어떤 점이 좋나요?
+
+- 다양한 PG사와 결제수단, 통화를 통합하여 일관된 기준으로 거래 및 정산 데이터를 제공하므로,
+  매출 및 결제 내역의 일치성을 높여주고 매출 인식에 참조할 수 있습니다.
+
+- 거래대사를 통해 고객사 거래 데이터와 PG사의 데이터를 비교하고 정산이 확정된 정산금 데이터를 추가하므로,
+  데이터 오류를 최소화할 수 있습니다.
+
+## 상세 기능 설명
+
+### 1. 거래내역
+
+- 일 총거래건수와 거래금액, 총 거래 이상 건수, 거래이상금액을 확인 가능합니다.
+
+### 2. 정산내역
+
+- 일 정산금과 수수료를 확인 가능할 수 있습니다.
+
+### 3. 거래건별조회
+
+- 고객사 주문번호, PG 거래번호, 포트원 거래번호를 하나의 엑셀에서 볼 수 있습니다.
+- 결제수단별 상세내역을 확인할 수 있습니다.
+- 공급가액, 면세가액, 부가세, PG 정산 수수료, PG 정산 수수료 부가세
+
+## 메뉴별 기능 설명
+
+### 1. 거래 정산내역
+
+거래일 기준 고객사 거래데이터, 혹은 정산일 기준 정산데이터를 확인할 수 있습니다.
+
+- **정산내역**에서는 정산일 기준으로 데이터가 조회됩니다.
+
+- **거래내역**에서는 거래일 기준으로 데이터가 조회되고 이는 PG사와 동일한 기준입니다.
+
+- 조회 기간으로 기본 조회 후, 조회기간 내 상점아이디와 PG 고객 식별아이디, 그리고 대사상태값으로
+  필터링 가능합니다.
+  - 아무 것도 선택하지 않았을 경우 이번달 1일부터 어제까지의 기간이 선택됩니다.
+
+#### 1.1 거래 내역
+
+(관련 이미지 첨부)
+
+**(1) 요약대시보드**
+
+- 설정한 조건으로 조회한 거래 결과의 요약을 확인할 수 있습니다.
+
+- 총 거래건수와 거래금액 : 설정한 조건으로 조회한 총 거래 건수와 거래 금액을 확인할 수 있습니다.
+
+- 총 거래 이상건수와 총 거래 이상 금액 : 설정한 조건으로 조회한 총 거래 이상 건수와 거래 이상 금액을 확인할 수 있습니다.
+  - 통화를 선택하여 통화별로 확인하실 수 있으며 통화가 다른 경우 KRW 로 환산하지 않습니다.
+  - 거래 이상 금액 : PG사 결제 금액과 고객사가 포트원에 연동한 주문금액을 비교했을 때 불일치하거나, PG사와 고객사 정보 어느 한 쪽이 없어서 비교할 수 없는 경우의 금액의 합계
+
+**(2) 필터**
+
+- 대사상태, PG 고객식별아이디와 상점아이디로 필터링할 수 있습니다. (복수 선택 가능)
+- 필터 초기화 선택 시 조회기간과 필터가 모두 초기화됩니다.
+
+**(3) 표 설정**
+
+- 표시되는 항목을 선택하여 항목을 **커스터마이징** 할 수 있습니다.
+
+(관련 이미지 첨부)
+
+- 초기 설정값은 모두 선택사항으로 설정 화면에서 제외할 수 있습니다.
+- 초기화를 통해 초기 설정값으로 되돌아갈 수 있습니다.
+
+**(4) 엑셀 다운로드**
+
+- 조회 조건에 해당하는 **전체 데이터를 엑셀로 다운로드**할 수 있습니다.
+
+**(5) 테이블 조회**
+
+- 일별 합계 (해당 날짜에 대한 상점아이디, PG 고객 식별아이디의 전체 합계)
+  - 합계 내 PG 고객 식별 아이디로 상세 조회 가능
+
+- 개별 항목
+  - 거래내역 - 거래일, 대사상태(대사일치, 불일치, 불능, 수집이전거래건), 상점아이디,
+    PG 고객 식별아이디&결제대행사, 거래건수, 거래금액, 취소건수, 취소금액, 거래 이상 건수, 거래 이상 금액
+
+- 조회일자가 같고, 통화가 다를 경우 다음 열에 표시됩니다.
+
+- 참고 사항
+  - 수집이전 거래건 : 오래된 거래건이 늦게 정산되어, PG사에서 수집 가능한 거래정보가 없는 경우에 해당합니다.
+    정산정보 외에 일부 거래정보가 누락되어 있을 수 있습니다.
+
+#### 1.2 정산 내역
+
+(관련 이미지 첨부)
+
+**(1) 요약대시보드**
+
+- 설정한 조건으로 조회한 거래 결과의 요약을 확인할 수 있습니다.
+- 총 정산과 정산금액 : 설정한 조건으로 조회한 총 정산 건수와 정산 금액을 확인할 수 있습니다.
+
+**(2) 필터**
+
+- PG 고객식별아이디와 상점아이디로 적용 가능 (복수 선택 가능)
+- 필터 초기화 선택 시 조회기간과 필터가 모두 초기화됩니다.
+
+**(3) 표 설정**
+
+- 표시되는 항목을 선택하여 항목을 **커스터마이징** 할 수 있습니다.
+
+(관련 이미지 첨부)
+
+- 초기 설정값은 모두 선택사항으로 설정 화면에서 제외할 수 있습니다.
+- 초기화를 통해 초기 설정값으로 되돌아갈 수 있습니다.
+
+**(4) 엑셀 다운로드**  조회 조건에 해당하는 **전체 데이터를 엑셀로 다운로드**할 수 있습니다.
+
+**(5) 테이블 조회**
+
+- 일별 합계 (해당 날짜에 대한 상점아이디, PG 고객 식별아이디의 전체 합계)
+  - 선택하여 합계 내 PG 고객 식별 아이디로 상세 조회 가능
+  - 정산내역 - 정산일, 상점아이디, PG 고객식별아이디&결제대행사, 정산건수, 정산금액, 취소건수, 취소금액, 거래금액, PG 수수료, PG 수수료 부가세
+
+- 조회일자가 같고, 통화가 다를 경우 다음 열에 표시됩니다.
+
+### 2. 거래 건별조회
+
+고객사 거래정산데이터 상세내역을 확인할 수 있습니다.
+
+- 조회 기간으로 기본 조회 후, 조회기간 내 상점아이디와 PG 고객 식별아이디, 대사상태, 거래상태(승인, 부분취소, 취소, 기타 취소)값으로 필터링 가능합니다.
+  - 아무 것도 선택하지 않았을 경우 이번달 1일부터 어제까지의 기간이 선택됩니다.
+
+- 기타 취소는 식별할 수 없는 취소건(unclassified cancel) 에 해당합니다.
+
+(관련 이미지 첨부)
+
+**(1) 검색**
+
+- 설정한 조건에 해당하는 **조회 리스트**에서, 검색명과 정확히 일치하는 내역을 확인할 수 있습니다.
+  - 주문명 검색
+  - PG 거래 번호
+  - 고객사 거래 번호
+  - 포트원 거래 번호
+
+- 참고 사항 : 유사 검색 기능은 지원되지 않습니다.
+  ex) “포트원”을 검색하기 위해 “포트”를 검색하여도 “포트원”이 조회되지 않습니다.
+
+**(2) 요약대시보드**
+
+- 설정한 조건으로 조회한 거래 결과의 요약을 확인할 수 있습니다.
+
+- 총 거래금액 : 설정한 조건으로 조회한 총 거래 금액을 확인할 수 있습니다.
+
+- 총 거래 이상 금액 : 설정한 조건으로 조회한 총 거래 이상 금액을 확인할 수 있습니다.
+  - 거래이상금액 : PG사 결제 금액과 고객사가 포트원에 연동한 주문금액을 비교했을 때 불일치하거나,
+    PG사와 고객사 정보 어느 한 쪽이 없어서 비교할 수 없는 경우의 금액의 합계
+
+**(3) 조회기준일**
+
+- 거래일/정산일 을 선택할 수 있습니다.
+
+**(4) 필터**
+
+- 대사상태, 거래 구분, 거래 유형, PG 고객식별아이디와 상점아이디 적용 가능 (복수 선택 가능)
+- 필터 초기화 선택 시 조회기간과 필터가 모두 초기화됩니다.
+- 대사 상태 - “대사 불일치” 상태값의 종류
+
+|사유                |설명                                                                                                     |비고                                                                                                                                                         |
+|--------------------|---------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
+|결제 금액 불일치    |두 원장의 결제 금액이 불일치합니다.                                                                      |금액 차이가 있으면 무조건 불일치로 표시                                                                                                                      |
+|면세 금액 불일치    |두 원장의 면세금액이 불일치합니다.                                                                       |금액 차이가 있으면 무조건 불일치로 표시                                                                                                                      |
+|부가세 금액 불일치  |두 원장의 부가세 금액이 불일치합니다.                                                                    |금액 차이가 있으면 무조건 불일치로 표시                                                                                                                      |
+|에스크로 여부 불일치|두 원장에서 에스크로(안전결제)여부가 불일치합니다.                                                       |Y/N 다르면 불일치 표시                                                                                                                                       |
+|할부 개월 수 불일치 |두 원장의 카드 할부개월 수가 불일치합니다.                                                               |할부개월수 다르면 불일치 표시                                                                                                                                |
+|결제일자 불일치     |두 원장의 결제일시가 불일치합니다. 시스템으로 인해 차이날 수 있는 근소한 차이의 경우는 일치로 처리합니다.|두 원장의 결제일시가 다른 일자에 일어나면 불일치 표시 (자정 기점으로 PG와 포트원간의 전송시간에 의해 거래일자가 변경되는 경우도 다른 일자일 경우 불일치 표시)|
+
+**(5) 표 설정** 표시되는 항목을 선택하여 항목을 **커스터마이징** 할 수 있습니다.
+
+(관련 이미지 첨부)
+
+- 초기 설정값은 모두 선택사항으로 설정 화면에서 제외할 수 있습니다.
+- 초기화를 통해 초기 설정값으로 되돌아갈 수 있습니다.
+
+**(6) 엑셀 다운로드**
+
+- 조회 조건에 해당하는 **전체 데이터를 엑셀로 다운로드**할 수 있습니다.
+
+**(7) 테이블 조회**
+
+- 조회조건 반영
+  - 거래정산내역에서 검색을 원하는 리스트를 선택하여 거래건별조회로 진입했을 경우 해당 조건으로 조회된 결과가 보여집니다.
+    - 조회기준일, 조회기간, 필터가 반영됩니다.
+
+  - 사이드바 메뉴에서 직접 선택하여 거래건별조회로 진입했을 경우 이번달 1일부터 어제까지의 모든 데이터가 조회됩니다.
+
+- 개별 항목
+  - 거래일, 대사상태(대사일치, 불일치, 불능, 수집이전거래건), 상점아이디, PG 고객 식별아이디&결제대행사, 고객사 결제번호(주문번호), PG 결제번호, 포트원 결제번호, 주문명, 거래유형, 거래금액, 공급가액, 면세가액, 부가세, PG수수료, PG수수료 부가세, 정산금액, 거래 이상 금액, 에스크로
+
+**(8) 거래유형 상세정보**
+
+- 거래 유형에 마우스오버시 카드 형태로 상세 정보가 보여집니다.
+
+|거래유형   |상세내용                                      |
+|-----------|----------------------------------------------|
+|카드       |발급사, 매입사, 카드 승인번호, 카드 할부개월수|
+|상품권     |타입, 승인번호                                |
+|계좌이체   |은행이름, 승인번호                            |
+|가상계좌   |은행이름, 승인번호                            |
+|간편결제   |간편결제사 이름                               |
+|모바일 결제|통신사                                        |
+|기타       |기타                                          |
+
+## 수식 설명
+
+|금액                 |공식                                                                                                                          |
+|---------------------|------------------------------------------------------------------------------------------------------------------------------|
+|정산건수             |조회기간내 (승인 건수 - (취소) - (부분 취소)) + 기타정산건(수집이전거래건수; 승인과 취소, 부분 취소 데이터가 없는 정산 데이터)|
+|정산금액             |조회기간 내 (승인금액 - (취소 금액) - (부분 취소 금액) - (수수료) - 수수료 VAT)                                               |
+|거래 건수            |조회기간 내 (승인) 건수                                                                                                       |
+|거래 금액            |조회기간 내 승인 금액                                                                                                         |
+|취소 건수            |조회기간내 (취소) + (부분취소) + (기타취소) 건수                                                                              |
+|취소 금액            |조회기간 내 (취소 금액) + (부분취소) + (기타취소) 금액                                                                        |
+|공급가액             |거래금액-(할인금액)-(면세가액)-(부가세)                                                                                       |
+|과세사업자 면세가액=0|                                                                                                                              |
+|부가세               |(거래금액-면세가액)/11 후 반올림                                                                                              |
+|과세사업자 면세가액=0|                                                                                                                              |
+|거래 이상금액        |거래불일치 금액 절대값 + 거래대사 불능금액                                                                                    |
+|PG 수수료 부가세     |PG사에서 값을 주지 않을 경우 PG수수료/10 후 반올림                                                                            |
+
+## FAQ
+
+- 데이터는 전체 기간 조회 가능한가요?
+  - 최대 3개월까지 조회가능합니다.
+
+- 여러 PG사의 데이터를 통합할 때, 각 PG사별 특성이나 차이점을 어떻게 반영하나요?
+  - PG사 데이터를 모두 확인할 수 있는 통합 인터페이스를 만들었고, 공통으로 가져올 수 있는 값들을 기본값으로 반영하고,
+    PG사에 따라 제공하는 값들은 있는 경우 제공하고 있습니다.
+
+- 거래대사 작업 후 불일치하는 데이터가 발견될 경우, 어떤 프로세스로 해결하나요?
+  - 고객사가 인지할 수 있도록 어떤 건이 있는지, 총액은 얼마인지, 어디의 불일치인지 알려줍니다.
+    재무데이터를 임의로 수정하는 것은 서비스 제공사가 할 수 있는 일이 아닙니다.
+
+- 실시간 데이터 업데이트가 가능한가요? 아니면 일별 업데이트인가요?
+  - 전날 기준 거래, 정산데이터를 가져와서 매일 업데이트합니다.
+
+- 복합 결제(예: 신용카드+포인트)의 경우, 데이터 처리는 어떻게 이루어지나요?
+  - 별도로 구분되지 않고 간편결제로 표시됩니다.
+
+- 환불, 부분 취소 등의 예외 케이스는 어떻게 처리되나요?
+  - 거래 상태값에 부분취소, 취소가 있습니다.
+
+- 다국어 및 다중 통화 지원 계획은 어떻게 되나요?
+  - 데이터에 있으면 모든 통화를 보여줍니다.
+
+- 누락 시 대응 계획은 무엇인가요?
+  - 데이터 수집시 PG사에 데이터가 없거나, 타임 아웃 등으로 누락이 일어나면 포트원에서 자동으로 파악이
+    가능하여 개발팀이 확인하고 다시 수집합니다.

package/assets/docs/opi/ko/extra/confirm-process/readme-v1.md

@@ -0,0 +1,98 @@
+---
+title: 컨펌 프로세스
+description: 결제요청의 주체를 고객사 서버로 가져갈수 있는 서비스 입니다.
+targetVersions:
+  - v1
+versionVariants:
+  v2: /opi/ko/extra/confirm-process/readme-v2
+---
+
+## 해당 서비스는 결제요청직전에 고객사 측에 결제의사를 최종적으로 확인하는 서비스입니다.
+
+![](</gitbook-assets/ko/image (259).png>)
+
+(이미지 첨부: 컨펌 프로세스)
+
+<div class="hint" data-style="info">
+
+**해당 서비스가 반드시 필요한 고객사는 아래와 같은 경우입니다.**
+
+- 판매 제품이 재고적으로 소량인 경우
+- 선착순방식으로 결제가 진행되는 경우
+- 결제 요청전 마지막으로 고객사에서 처리하고 싶은 업무처리가 있는 경우
+
+</div>
+
+(이미지 첨부: 컨펌 프로세스)
+
+## 판매 제품이 재고적으로 소량인 경우
+
+고객사 판매 제품이 명품 또는 매우 인기가 높은 품목인 경우 결제 시 동시 접속자로 인해 경쟁이
+치열해지는 경우 결제 직전 고객사 서버에서 재고수량을 한번더 확인하고 수량이 있는 경우에만 결제가
+요청되도록 처리 할 수 있습니다. 만약 컨펌 프로세스를 설정하지 않는 경우 결제는 되었지만 재고가
+없어서 제품 발송을 약속된 일자에 처리하지 못하거나 혹은 이로인해 취소처리가 발생하여 고객 결제 만족
+경험도를 떨어트리는 상황이 발생됩니다.
+
+![](</gitbook-assets/ko/image (217).png>)
+
+## 선착순 방식으로 결제가 진행되는 경우
+
+마라톤 참가 신청, 인기 콘서트 티켓팅, OO Day 와 같은 특별 할인행사 처럼 특정 시간에 결제가
+활성화되는 결제방식을채택하고 있는 고객사인 경우 특정시간에 매우 많은 고객이 동시에 결제 요청이
+유입되며 이에따라 결제 요청 직전에 고객사 서버에서 재고수량 파악이 필요합니다.
+
+![](</gitbook-assets/ko/image (164).png>)
+
+## 결제 직전 고객사에서 업무로직을 한번 더 수행하고 싶은 경우
+
+이밖에 다른 사유로 고객사 측에서 결제 직전 자체업무 처리가 필요한 경우(결제 직전 고객사 서버 헬스체크 등) 해당 서비스를 이용합니다.
+
+![](</gitbook-assets/ko/image (262).png>)
+
+<div class="hint" data-style="info">
+
+**컨펌 프로세스 신청 방법**
+
+기술지원 메일(<support@portone.io>)로 **고객사 식별코드**를 기재하여 메일 발송
+
+(이미지 첨부: 포트원 콘솔 내 고객사 식별코드 확인 예시)
+
+포트원 콘솔 로그인 후 \[결제연동] → \[식별코드 ・ API Keys] → \[V1 API] 페이지에서 확인할 수 있습니다.
+
+</div>
+
+## 컨펌 프로세스 이용방법
+
+컨펌 프로세스 이용시 고객사는 Javascript request\_pay() 함수 호출시 **confirm\_url** 파라미터를
+정의하고 해당 파라미터의 고객사 EndPoint URL을 설정합니다.
+
+```json title="JavaScript SDK"
+{
+  //...중략
+  "confirm_url": "고객사 EndPoint URL 기재"
+  //...중략
+}
+```
+
+해당 URL이 설정되면 당사에서 결제 요청 직전 해당 URL 로 **HTTP 통신**이 진행되며 아래와 같은 Data가 POST로 요청됩니다. (Timeout : **10s**)
+
+> `imp_uid`: 결제번호
+>
+> `merchant_uid`: 주문번호
+>
+> `amount`: 결제 금액
+
+해당 요청에 대한 고객사 응답으로 HTTP Status **200** 응답을 주시는 경우 결제를 요청합니다.
+
+(**200응답이 아닌 경우 결제가 진행되지 않습니다**.(**`실패처리`**)
+
+**200** 외 응답을 통해 승인을 막음과 동시에 해당 사유를 함께 기록하고싶으실 경우 요청 응답 body에 `reason` 파라미터를 json 형태로 전달해주시면 되며
+
+```json
+{
+  "reason": "재고 부족"
+}
+```
+
+전달주신 `reason` 값이 `고객사 요청에 의해 결제를 중단합니다. (상세사유 : %s)`의 상세사유에 추가되어
+결제 실패 사유(fail\_reason)으로 기록됩니다. (기본값 : `알 수 없음`)

package/assets/docs/opi/ko/extra/confirm-process/readme-v2.md

@@ -0,0 +1,152 @@
+---
+title: 컨펌 프로세스
+description: 결제승인의 주체를 고객사 서버로 가져갈수 있는 서비스 입니다.
+targetVersions:
+  - v2
+versionVariants:
+  v1: /opi/ko/extra/confirm-process/readme-v1
+---
+
+**해당 서비스는 결제 승인 직전에 고객사에서 결제 의사를 최종적으로 확인하는 서비스입니다.**
+
+(관련 이미지 첨부)
+
+## 컨펌 프로세스란?
+
+- 결제 승인 직전 고객사에 결제 승인 요청 의사를 마지막으로 확인하는 서비스 입니다.
+
+- 기본적인 결제 플로우상 고객사에서 결제 요청 후 별도의 확인 없이 결제 승인되는 구조입니다.
+  하지만 해당 서비스 이용 시 고객사가 최종적으로 결제 승인 요청의 주체가 될 수 있습니다.
+
+(이미지 첨부: 컨펌 프로세스 플로우)
+
+<div class="hint" data-style="info">
+
+**해당 서비스가 반드시 필요한 고객사는 아래와 같은 경우입니다.**
+
+(관련 이미지 첨부)
+
+- 판매 제품의 재고가 소량으로 재고파악이 필요한 경우 (한정된 상품 또는 고가 제품 판매시)
+- 선착순 방식으로 결제가 진행되어야 하는 경우
+- 결제 승인 전 마지막으로 고객사에서 처리하고 싶은 로직이 존재하는 경우
+
+</div>
+
+## 컨펌 프로세스 사용 케이스
+
+### 판매 제품의 재고가 소량으로 재고파악이 필요한 경우
+
+고객사의 판매 제품이 재고가 충분하지 않을 경우 구매자가 동시에 구매를 요청할 수 있기 때문에
+결제 직전 고객사 서버에서 재고 수량을 한 번 더 확인하고 수량이 있는 경우에만 결제가 승인되도록
+처리할 수 있습니다.\
+만약 컨펌 프로세스를 설정하지 않는 경우 실제 결제 승인 후 재고가 부족하여 제품 발송이 늦어지거나
+주문을 취소 처리가 발생하여 고객의 결제 경험 만족도를 저하시키는 상황이 반복될 수 있습니다.
+
+![](</gitbook-assets/ko/image (217).png>)
+
+### 선착순 방식으로 결제가 진행되어야 하는 경우
+
+마라톤 참가 신청, 인기 콘서트 티켓팅 또는 OO Day 같은 특별 할인 행사처럼 특정 시간에 매우 많은 고객이
+동시에 결제 요청을 하는 경우 한정된 수량을 초과하지 않도록 고객사에서 최종적으로 수량을 확인한 후
+결제가 승인되도록 처리할 수 있습니다.
+
+![](</gitbook-assets/ko/image (164).png>)
+
+### 결제 승인 전 마지막으로 고객사에서 처리하고 싶은 로직이 존재하는 경우
+
+이밖에 다른 사유로 고객사에서 결제 승인 완료 직전 자체 업무 처리가 필요한 경우(결제 직전 고객사 서버 헬스체크 등) 해당 서비스를 이용할 수 있습니다.
+
+![](</gitbook-assets/ko/image (262).png>)
+
+<div class="hint" data-style="info">
+
+**컨펌 프로세스 신청 방법**
+
+기술지원 메일(<support@portone.io>)로 **상점 아이디**를 기재하여 메일 발송
+
+포트원 콘솔 로그인 후 \[결제연동] 페이지 상단에서 상점 아이디를 확인 하실 수 있습니다.
+
+</div>
+
+<div class="hint" data-style="warning">
+
+엑심베이의 경우 컨펌 프로세스 사용이 불가능합니다.
+
+</div>
+
+## 컨펌 프로세스 이용 방법
+
+컨펌 프로세스 이용시 고객사는 `PortOne.requestPayment()`, `PortOne.loadPaymentUI()` 함수 호출 시
+
+`confirmUrl` 파라미터를 정의하고 해당 파라미터에 고객사 EndPoint URL을 설정합니다.
+
+```json title="JavaScript SDK"
+{
+  //...중략
+  "confirmUrl": "고객사 EndPoint URL 기재"
+  //...중략
+}
+```
+
+## Payload Schema
+
+콘솔에서 설정하신 웹훅 버전에 따라 상이한 형식의 payload가 송신됩니다.
+
+### `2024-01-01` 사용 시
+
+- `payment_id`: 고객사에서 채번한 결제건의 고유 주문 번호입니다.
+- `tx_id`: 포트원에서 채번한 결제건의 고유 거래 번호입니다.
+- `total_amount`: 결제건의 결제 요청 금액입니다.
+
+**컨펌 웹훅 payload 예시:**
+
+```json
+{
+  "payment_id": "example-payment-id",
+  "tx_id": "55451513-9763-4a7a-bb43-78a4c65be843",
+  "total_amount": 1000
+}
+```
+
+### `2024-04-25` 사용 시
+
+- `type`: 웹훅을 트리거한 이벤트의 타입입니다. 컨펌 웹훅의 경우 `type`의 값은 `Transaction.Confirm`으로 고정됩니다.
+
+- `timestamp`: 해당 웹훅을 트리거한 이벤트의 발생 시각(RFC 3339 형식)입니다.
+
+- `data`: 웹훅을 트리거한 이벤트의 실제 세부 내용입니다. 컨펌 웹훅의 경우 해당 필드의 상세 스키마는 아래와 같습니다.
+  - `paymentId`: 고객사에서 채번한 결제건의 고유 주문 번호입니다.
+  - `transactionId`: 포트원에서 채번한 결제건의 고유 거래 번호입니다.
+  - `totalAmount`: 결제건의 결제 요청 금액입니다.
+
+**컨펌 웹훅 payload 예시:**
+
+```json
+{
+  "type": "Transaction.Confirm",
+  "timestamp": "2024-04-25T10:00:00.000Z",
+  "data": {
+    "paymentId": "example-payment-id",
+    "transactionId": "55451513-9763-4a7a-bb43-78a4c65be843",
+    "totalAmount": 1000
+  }
+}
+```
+
+## SDK 실패 응답에 특정 에러 메세지 포함시키기
+
+고객사는 재고 부족 등의 이유로 포트원이 보낸 컨펌 프로세스 요청에 실패 응답을 보낼 수 있고, 이러한 실패 사유를 서비스를 이용하는 고객들에게 보여주고 싶을 수 있습니다.
+이러한 경우 Response Body에 `errorMessage` 라는 필드를 포함하여 에러 응답을 보내주시면 해당 메세지를 포함해 SDK 응답으로 리턴해드리고 있습니다.
+
+**Error Response Body 예시:**
+
+```json
+{
+  "errorMessage": "재고가 모두 소진되었습니다. 관리자에게 문의하세요."
+}
+```
+
+## 컨펌 웹훅 요청 검증하기
+
+컨펌 프로세스 웹훅 또한 다른 일반적인 웹훅과 동일한 방식으로 검사하시는 것을 권장합니다.
+[웹훅 연동하기 - 웹훅 요청 검증하기](https://developers.portone.io/opi/ko/integration/webhook/readme-v2#웹훅-메시지-검증하기)를 참고하셔서 컨펌 웹훅을 신뢰할 수 있는지를 검사하세요.