@portone/mcp-server 0.13.0

package/assets/docs/help/core-service/how-to-use/naverpay-review-items.md

@@ -0,0 +1,199 @@
+---
+title: 네이버페이(결제형) 검수요청 항목
+category: 결제서비스 (채널설정 및 이용안내) > 이용안내 > 결제대행사 계약
+seo:
+  title: 네이버페이(결제형) 검수요청 항목
+  description: >-
+    네이버페이 심사를 위한 검수 과정을 진행하기 위해 포트원 기술지원팀으로 전달해 주실 정보입니다. 사업정보와 질의 사항을 작성하시어 포트원
+    기술지원팀으로 검수 정보를 전달해 주세요.
+  keywords:
+    - 네이버페이
+    - 결제형
+    - 검수
+tags:
+  - 네이버페이(결제형)
+  - 결제대행사 계약
+pgCompanies:
+  - 네이버페이(결제형)
+searchTags:
+  - 검수방법
+  - 검수 방법
+  - 검수
+  - 검수 요청
+  - 검수 절차
+  - 검수 요청서
+  - 검수요청서
+  - 검수절차
+  - 검수요청
+  - 네이버페이 결제형 검수
+  - 네이버페이결제형 검수
+  - 네이버페이검수
+  - 결제형검수
+  - 결제형 검수
+  - 네이버결제형 검수
+  - 네이버 검수
+datetime: 2024-01-25T15:00:00.000Z
+---
+
+<Callout content="네이버페이(결제형)은 다른 결제대행사와 다르게 별도의 검수절차가 존재합니다.
+검수 진행은 포트원 기술지원팀을 통하여 진행해주셔야 하므로 아래 1번, 2번의 내용을 포트원 기술지원팀(support@portone.io)로 네이버페이 결제형 검수를 요청 주시기 바랍니다.  (3번 내용은 참고) 
+참고로 아래(1,2번) 정보는 네이버페이(결제형) 검수 진행시에 네이버페이에서 필수로 요구하는 정보입니다. " />
+
+### **1. 사업자 및 계약정보**
+
+- 상호명 :
+- 사업자번호 :
+- 포트원 계정 :
+- 네이버페이 연동 개발자 연락처(이메일/전화번호) : _담당자님 정보를 적어주세요_
+- 네이버페이 연동 검수 담당자 연락처(이메일/전화번호) : _담당자님 정보를 적어주세요_
+- 네이버페이 결제형 파트너ID : _단건/반복(정기) 이용하실 방식에 따라 구분하여 전달 주세요_.
+- 검수 진행가능한 URL :
+- 테스트 가능한 로그인계정 :
+
+### **2. 질의사항**
+
+- 적립금 적립방식(자체적립/네이버페이적립) :
+- 현금영수증 발급 방식(자체발행/네이버페이대행발행) :
+- 판매상품 과/면세 여부:
+- 에스크로 사용여부:
+- 모바일앱 보유 여부:
+- 부분취소 제공여부:
+- IMP.request\_pay 함수 호출 시 naverProduct 파라미터 설정 셋팅 예시:
+- 개발진행 완료여부 : [포트원 연동가이드 바로가기↗](https://developers.portone.io/opi/ko/integration/pg/v1/naver?v=v1)
+- 금액위변조 기능 개발 여부 :
+
+<Indent level="1">
+
+판매 상품의 실제 구매금액이 화면표시부터 네이버페이 도달까지 금액이 위변조 되지 않도록 조치 해야 합니다. \
+금액변조 방지 기능을 내부적으로 구현하기 어려우신가요?\
+포트원 에서 참조 및 제공할 수 있는 기능이 있어 소개드립니다.\
+(네이버페이) 결제창을 띄우기 직전에 결제금액을 미리 사전에 등록하는 api를 사용하실 수 있습니다. \
+인증방식의 결제를 진행할 때 결제금액 위변조시 결제진행자체를 block하기 위해 결제예정금액을 사전등록하는 기능입니다.
+
+- [POST /payments/prepare](https://developers.portone.io/api/rest-v1/payment.validation#post%20%2Fpayments%2Fprepare)
+
+**단, 해당 기능을 이용하실 때는  server-side에서 구현하시는 것이 바람직합니다.**\
+추가적으로 포트원 연동 가이드의 결제정보 검증을 통해 취소 및 실패처리 로직을 구현하시는 것을 권해 드립니다.
+
+</Indent>
+
+### **3. 검수요청서 작성 가이드**
+
+<Callout content="아래 내용은 검수 요청서 작성 시 자세히 참고하실 수 있는 가이드입니다.
+검수요청서 파일은 네이버페이로부터 안내받으실 수 있으며, 검수요청서 다운받기 링크를 통해서도 다운로드 가능합니다. (직접 편집 불가 하며 다운로드 후 이용가능)" title="참고사항" icon="💡" />
+
+[단건결제  요청서 바로가기 ↗︎](https://docs.google.com/spreadsheets/d/1dBndmiwqGngqEQS8ybuQoxRC2vbS2cyK5KDfUrG1Nbc/edit?gid=1775428011#gid=1775428011)
+
+[정기결제  요청서 바로가기 ↗︎](https://docs.google.com/spreadsheets/d/1mgp6-BHC1AFVkrrOPEiO_PxGgpLoGnDx2OucBuUQoMM/edit?gid=2068324091#gid=2068324091)
+
+**연동 담당자**
+
+- 연동 담당자(개발/검수 담당자):검수 요청 메일을 보낸 고객사 담당자의 이름<이메일 주소>형태로 기재합니다.
+
+**검수 환경**
+
+- 계정: 고객사 담당자로부터 전달 받은 테스트 계정 / 테스트 계정 비밀번호를 기재합니다.
+- 과/면세 기준: IMP.request\_pay 호출시 tax\_free 파라미터 전달 여부로 판단합니다. \
+  (전달시 면세 , 비 전달시 과세)
+- 가맹점 타입: IMP.request\_pay 호출시 escrow 파라미터 값으로 판단합니다. \
+  (true시 에스크로, false시 비 에스크로)
+- 포인트 적립 타입, 현금영수증 발행: 가맹점이 네이버페이와 계약한 내용을 기반으로 하므로 고객사 에서 포트원으로 검수 요청시 해당 정보를 제공합니다.
+- PC, Mobile Web, Mobile App, 관리자페이지: 제공하는 각 환경에 대해 테스트 가능한 URL, 지원하는 종류와 버전, 부분취소 제공 여부를 파악해 기재합니다.
+
+**간편 결제 플랫폼 연동 현황**
+
+- 현금영수증 발행대상 금액조회, 거래완료, 네이버페이 포인트 적립 요청은 위 검수환경에 작성된 내용을 기반으로 작성합니다.
+
+**결제창 호출(NaverPay javascript SDK) 연동 현황**
+
+- PC와 모바일에서 결제창이 호출되는 방식을 파악하고 맞는 값에 O 표시를 합니다.
+- layer 방식은 더이상 지원하지 않습니다.
+- page 방식이란, 네이버페이 URL로 리디렉션 되는 방식을 의미합니다.
+
+**productItems(상품 상세 정보) parameter 연동 현황**
+
+<Indent level="1">
+
+네이버페이 - 결제형의 경우, \
+결제창 호출(IMP.request\_pay 함수)시 상품 정보를 의미하는 naverProducts 파라미터를 필수로 전달해야 합니다. 이 값이 없다고 해서 결제가 안되는 것은 아니지만, 네이버페이 측에서 데이터 수집을 위해 필수로 전달할 것을 요구하고 있습니다.  naverProducts 파라미터는 상품 정보(객체)를 담고 있는 배열이며, 각 상품 정보는 아래 6가지 속성을 갖고 있습니다.
+
+</Indent>
+
+<Callout content="" title="네이버페이 공식 매뉴얼 보러가기 ↗" />
+
+- categoryType (필수) : BOOK, MUCIC, MOVIE, PROCUCT 등등 (공식매뉴얼 참고)
+- categoryId (필수) : (공식매뉴얼 참고)
+- uid (필수) : 가맹점 내부의 상품 고유 ID를 활용하는 것이 일반적입니다만, 네이버페이 가이드 참고가 필요합니다.   (공식매뉴얼 참고)
+- name (필수) : 주문상품의 명칭
+- count (필수) : 상품 주문 개수
+- payReferrer (선택) : 네이버 플랫폼의 타 서비스와 제휴계약 후 유입분석을 진행하는 경우에만 입력
+
+해당 파라미터값을 “코드 예” 항목에 넣어주시면 됩니다.
+
+**사전 준비 항목**
+
+- 자체 앱 보안 설정 항목을 제외한 모든 부분은 포트원에서 이미 처리하고 있으므로 확인 결과를 모두 "O"로 설정합니다.
+- 앱을 검수하는 경우에는 자체앱 보안 설정 항목이 처리되어 있는지 직접 확인하며, 웹을 검수하는 경우에는 모두 \*(해당 사항 없음 의미) \*로 설정합니다.
+
+**name 파라미터**
+
+name 파라미터는 주문명을 의미합니다. \
+간혹 2개 이상의 상품을 구매하는 경우, name값을 “XX외 X건”과 같은 형식으로 전달하는 경우가 있습니다. \
+네이버페이 - 결제형의 경우 2개 이상의 상품 구매시 주문명을 위와 같이 자동으로 생성하기 때문에 name 파라미터는 항상 naverProducts\[0].name값과 동일한 값으로 설정해야 합니다.
+
+해당 파라미터가 정상적으로 설정된 경우, 간편결제 API > 결제창 호출 > “**No.6 productName(대표 상품명)은 상품명만 전달하는지 확인**”에 정상으로 체크해주시면 됩니다.
+
+**에러 메시지 비 가공**
+
+결제창 호출(IMP.request\_pay 함수)후 결제창 하단의 “취소" 버튼 클릭 등으로 결제 프로세스가 중단되거나 잔액 부족, 한도 초과, 10원 미만 결제 등의 사유로 결제에 실패하면 콜백 함수(popup 방식)/m\_redirect\_url(리디렉션 방식)로 전달되는 결제 결과(response 객체/쿼리 파라미터)에 실패 사유(error\_msg)가 전달됩니다. \
+이 에러 메시지는 사용자에게 가공 없이 그대로 노출되어야 합니다.
+
+ex) error\_msg가 “잔액 부족"이라고 가정할때, "결제에 실패하였습니다. 실패 사유:" + "잔액 부족"과 같은 형태로 가공되면 안됨
+
+해당 내용이 정상적으로 반영되어있는 경우, 결제 화면 > “**No.3 실패 응답에 대한 resultMessage를 받은 경우 서비스 시나리오에 따라 적절하게 처리되었는지 확인**”에 정상으로 체크해주시면 됩니다.
+
+**10원 미만 결제 처리**
+
+네이버페이 - 결제형의 최소 결제 금액은 10원이기 때문에, 10원 미만 결제 요청에 대해 예외 처리가 되어있어야 합니다.
+
+ex) 사용자에게 최소 결제 금액이 10원이라 결제를 할 수 없다는 의미를 담는 에러 메시지가 노출되어야 함
+
+해당 내용이 정상적으로 반영되어있는 경우, 간편결제 API > “**No.8 totalPayAmount 최소 결제금액(10원)에 대한 예외 처리 확인**”에 정상으로 체크해주시면 됩니다.
+
+**결제 금액 위/변조**
+
+프론트엔드에서 javascript 함수를 호출해 결제창이 렌더링되는 만큼 결제 금액이 얼마든지 위/변조 될 수 있습니다. 결제 금액 위/변조시 승인 완료 후 가맹점 웹서버가 이를 감지해 주문 처리를 하지 않는지 체크해야 합니다. 정상적인 프로세스는 아래와 같습니다.
+
+<Indent level="1">
+
+결제 금액 위/변조하여 결제창 호출 → 승인 완료 → 콜백 함수 호출(또는 m\_redirect\_url로 리디렉션) → 가맹점 웹서버로 HTTP 리퀘스트 → 전달된 포트원 번호(imp\_uid)로 실제로 결제 된 금액(amount)을, 주문 번호(merchant\_uid)로 결제를 의도한 금액(예) amountToBePaid)을 조회 → amount와 amountToBePaid가 일치하는 경우에만 주문 완료 처리 → 일치하지 않는 경우 위/변조 된 결제이므로 해당 결제 건을 취소하고 사용자에게 위/변조 된 결제라는 점 안내
+
+</Indent>
+
+해당 내용이 정상적으로 반영되어있는 경우, 결제로직 취약성 > No.3(총 결제금액은 동일하고, 수량만 변경하였을 경우 변조 유무를 체크하는지 확인), No. 4(결제금액과 관련된 기타 파라미터 변경시 결제금액이 변경되는지 확인)에 정상으로 체크해주시면 됩니다.
+
+**결제 취소 API 호출시 요청 본문**
+
+네이버페이 - 결제형 결제건의 경우, 결제 취소 API(POST /payments/cancel) 호출시 추가적으로 전달해야할 요청 본문 파라미터가 있습니다. 해당 파라미터는 아래와 같습니다.
+
+- reason: 결제 취소 사유, 실제 사유와 같아야 함
+- extra: `{ requester: “admin” 또는 “customer” }`: 결제 취소 대상자를 구분하는 값으로 admin은 가맹점을, customer는 가맹점 고객을 의미
+
+### **4. 연동시 참고사항**
+
+네이버페이는 크게 아래의 3단계에 걸쳐 심사가 완료됩니다.
+
+1. 네이버페이로부터 (결제형) 입점심사 결정
+2. 네이버페이(결제형) 연동 완료
+3. 네이버페이 심사
+
+<Indent level="1">
+
+심사단계에서는 네이버페이가 여러 가지 UI/UX적인 체크와 기능 체크를 하게 됩니다.
+
+- 네이버페이 버튼이 네이버 내부의 디자인 가이드에 맞게 적용되어있는지
+- 결제금액을 변조해서 결제를 해봤을 때 주문완료처리를 하지 않고 걸러내는지
+- 부분취소 기능은 잘 동작하는지 등등 을 전반적으로 사이트 검수하게 됩니다.\
+  (네이버페이와 관련된 디자인 및 기능들을 점검하는데 통상적으로 2주 정도 소요되는 경향이 있습니다)
+
+</Indent>

package/assets/docs/help/core-service/how-to-use/nice-contract.md

@@ -0,0 +1,81 @@
+---
+title: 나이스페이먼츠 상세 계약절차
+category: 결제서비스 (채널설정 및 이용안내) > 이용안내 > 결제대행사 계약
+seo:
+  title: 나이스페이먼츠 상세 계약절차
+  description: >-
+    나이스페이먼츠의 전자결제 계약절차는 가입신청서 제출 - 계약안내 - 계약진행 - 계약완료 - 포트원 관리자콘솔 채널설정 - 개발진행 -
+    카드사 심사 진행으로 이뤄집니다. 각 계약절차를 확인해보세요.
+  keywords:
+    - 나이스페이먼츠
+    - 계약절차
+tags:
+  - 나이스페이먼츠
+  - 결제대행사 계약
+pgCompanies:
+  - 나이스페이먼츠
+searchTags:
+  - NICEPAYMENTS
+  - NICE페이먼츠
+  - nice계약
+  - 나이스계약
+  - 나이스페이먼츠계약절차
+  - 나이스페이먼츠계약
+  - 나이스
+datetime: 2024-02-27T15:00:00.000Z
+---
+
+<Callout content="" title="나이스페이먼츠와 계약을 맺으시기 위한 절차를 순서대로 알려드립니다." />
+
+### **가입신청서 제출**
+
+[포트원 관리자콘솔↗](https://admin.portone.io/) 안에서 나이스페이먼츠의 가입신청서를 제출합니다.
+
+- 경로 : [포트원 관리자콘솔↗](https://admin.portone.io/) 회원가입 및 로그인 > 좌측 상단 \[전자결제 신청] 버튼 클릭 > 사업자등록증 업로드 > 원하는 결제수단 & 결제대행사 선택 후 제출
+
+<Callout icon="" title="전자결제 신청방법 보러가기 ↗" />
+
+![](/uploads/결제서비스/이용안내/결제대행사계약/홈_전자결제신청.png)
+
+![](/uploads/결제서비스/이용안내/결제대행사계약/나이스페이먼츠.png)
+
+### **나이스페이먼츠의 계약 안내**
+
+포트원으로 접수해 주신 신청건은 즉시 나이스페이먼츠로 전달되며, 가입 신청서를 제출해 주신 이후 2\~3영업일 내 나이스페이먼츠 계약부서로부터 자세한 안내를 받습니다.
+
+계약안내 메일은 모두 1번의 절차에서 적어주신 담당자님 메일 주소로 발송됩니다.(스팸함으로 종종 누락되기도 하니 스팸함까지 확인해 주세요)
+
+### **계약진행**
+
+메일 내용에 따라 필요한 구비서류 및 계약서 작성을 진행해 주세요.
+
+결제대행사에서 요구하는 기본적인 구비서류는 아래를 통해 참고해 주시기 바라며 자세한 준비서류는 결제대행사로부터 안내받으실 메일에 기재되어 있습니다.
+
+<Callout title="계약 구비서류 보러가기 ↗" icon="" />
+
+### **계약완료**
+
+계약서 작성 및 보증보험 가입 등을 마치시면 계약이 완료됩니다. 다음 절차인 카드사 심사를 준비합니다.\
+(혹시 상점 정보가 미리 안내되었다고 하더라도 카드사 심사 전에는 운영환경 결제가 불가합니다. (결제 실패 발생))
+
+### **포트원 관리자콘솔 채널설정**
+
+포트원 관리자콘솔에서 사용하실 PG사와 테스트용 MID를 설정합니다.
+
+<Callout icon="" title="나이스페이먼츠 채널설정방법 보러가기 ↗" />
+
+### **개발진행**
+
+포트원의 개발 연동 가이드를 참고하셔서 사이트 내 개발을 진행합니다.
+
+심사를 받으실 사이트 내에서 결제 서비스 연동을 완료해 주셔야 하며, 모든 항목들이 최종 완성본 형태로 구현되어 있진 않아도 심사에 필요한 항목은 필수적으로 노출 · 동작되어야 합니다.
+
+참고로 결제 이후 로직까지는 심사하지 않고 결제창이 정상적으로 노출되는지, 결제창 안에 카드사가 잘 노출되는지 등을 검수합니다.
+
+<Callout title="서비스 필수 구축요건 보러가기 ↗" icon="" />
+
+### **카드사 심사 진행**
+
+최종적으로 카드사 심사를 진행하셔야 실 결제 서비스 사용이 가능합니다.
+
+개발이 완료되 결제대행사(PG)로 카드사 심사를 요청하면, 결제대행사에서 각 카드사별로 심사를 요청하여 진행합니다. 카드사 심사는 각 카드사별로 진행되므로 완료일자가 정확하진 않으나 보통 2주 정도 소요됩니다.

package/assets/docs/help/core-service/how-to-use/open-immediately.md

@@ -0,0 +1,60 @@
+---
+title: 바로오픈 서비스 안내
+category: 결제서비스 (채널설정 및 이용안내) > 이용안내 > 결제대행사 계약
+seo:
+  title: 바로오픈 서비스 안내
+  description: >-
+    바로오픈 서비스란 PG 계약 시 ‘카드사 심사 절차’(약 2주 소요) 전에 우선적으로 빠른 결제 서비스 도입이 필요한 경우에 이용 가능한
+    서비스입니다.
+  keywords:
+    - 바로오픈서비스
+tags:
+  - KG이니시스
+  - NHN KCP
+  - 토스페이먼츠
+  - 결제대행사 계약
+pgCompanies:
+  - KG이니시스
+  - 토스페이먼츠
+  - NHN KCP
+searchTags:
+  - 토스페이먼츠
+  - NHN KCP
+  - KG이니시스
+datetime: 2024-01-25T15:00:00.000Z
+---
+
+<Callout content="**바로오픈 서비스란?**
+PG 계약 시 카드사 심사 절차(약 2주 소요) 전,
+우선적으로 빠르게 결제 서비스 도입이 필요한 경우 이용 가능한 서비스입니다." />
+
+### **지원 PG사**
+
+**KG이니시스 / NHN KCP / 토스페이먼츠**
+
+- 신청 즉시 이용 가능 : KG이니시스
+- PG 입점 심사 완료 후 이용 가능 : NHN KCP , 토스페이먼츠
+  - 참고 : 토스페이먼츠의 경우 “국내에서 7일 이내에 배송되는 실물 유형 제품” 한에서 바로오픈(미리오픈)서비스 이용이 가능하여, 희망하시는 경우 토스페이먼츠 고객센터를 통해 문의 부탁드립니다. \
+    (토스페이먼츠에서 사이트 검토 후 가능 여부 안내드리고 있습니다.)
+
+### **지원 결제수단**
+
+- KG이니시스 : 카드(일시불만 지원) , 실시간 계좌이체, 가상계좌
+- 토스페이먼츠 : 카드(일시불만 지원)
+- NHN KCP : 카드(일시불만 지원)
+
+### **수수료 및 정산**
+
+바로오픈 서비스용의 별도 수수료가 발생되지 않으며 원래 결제대행사를 통한 결제 시 부과되는 일반 결제 수수료율만 발생됩니다.
+
+**결제수수료율(부가세별도)**
+
+- 카드 (일반사업자 기준) : 3.2%
+- 실시간계좌이체 : 1.80%
+- 가상계좌 : 건당 300원 (기본 수수료율과 동일 적용)
+- 정산 주기 : 월 1회 (카드사 심사완료 후 변경 가능)
+- 참고 : PG사 입점 가능한 업종에 한 해 이용이 가능하며 카드사 심사 시 반려된 경우 PG 서비스 이용이 중단될 수 있습니다. (PG사측로부터 입점 불가 업종으로 안내받으신 경우 결제 서비스는 중단됩니다)
+
+<Callout content="1. 바로오픈 서비스는 정기결제 방식, 허브형 간편결제, 카드 할부 결제를 지원하지 않습니다. 
+2. 추후 카드사 심사가 완료되면 신청 후 서비스 이용이 가능합니다.
+3. 정기결제 서비스가 필요하신 경우 PG사 측과 빌링 특약/심사 절차가 필요합니다." icon="💡" title="참고사항" />

package/assets/docs/help/core-service/how-to-use/other-hosting-company.md

@@ -0,0 +1,38 @@
+---
+title: 타 호스팅사 이용 시 포트원 사용방법
+category: 결제서비스 (채널설정 및 이용안내) > 이용안내 > 호스팅 제휴
+seo:
+  title: 타 호스팅사 이용 시 포트원 사용방법
+  description: >-
+    호스팅사 정책상 해당 호스팅사를 통해 PG사 계약을 맺어야만 하는 경우, 포트원 연동 서비스(API) 이용 방법 안내를 드립니다. 반드시
+    포트원을 통해 계약을 맺어야 하며, 기존 호스팅사 서비스 이용 중이라면 정책 충돌을 방지하기 위해 포트원의 가이드를 체크해 주시기
+    바랍니다.
+pgCompanies:
+  - 공통
+searchTags:
+  - 호스팅제휴
+  - 호스팅사
+datetime: 2024-01-25T15:00:00.000Z
+---
+
+<Callout content="간혹 호스팅사 정책상 반드시 해당 호스팅사를 통해 PG사와의 계약을 맺어야만 하는 경우도 존재합니다.
+포트원도 연동 서비스(API) 이용 시 반드시 포트원을 통해 계약을 맺으셔야 하므로, 기존에 호스팅사의 서비스를 이용 중이시라면 정책 충돌을 유의하시어 아래 내용을 먼저 체크해 주셔야 합니다.
+" title="" />
+
+### **이용하는 서비스 파악하기**
+
+**이용중인 호스팅사를 통해 이용하는 서비스 파악이 필요합니다.**\
+호스팅사에서 제공되는 서비스별로 적용되는 정책의 범위가 다를 수 있으니 어떤 서비스를 이용 중이신지 먼저 체크 바랍니다.
+
+이용 중인 호스팅사로 포트원을 통해 PG 계약 및 서비스 이용이 가능할지 확인해 주시면 정확합니다.
+
+- 서버만 이용하는 경우 → 반드시 해당 해당 호스팅사를 통해 PG 계약을 맺을 필요가 없음
+- 홈페이지 자체를 호스팅사 통해 구축한 경우 → 반드시 해당 호스팅사를 통해 PG 계약을 맺어야 함
+
+### **홈페이지 자체 개발 예정인 경우**
+
+기존에는 호스팅사의 서비스 사용 중이지만 추후 홈페이지를 직접 개발하실 예정이라면 포트원 연동이 가능합니다.
+
+물론 포트원 정책상 포트원용 상점 아이디를 하나 더 발급받으셔야 하며, 포트원 도입 후에는 그전까지 이용하시던 상점 아이디 이용이 불가한다는 점 유의 바랍니다.
+
+<Callout icon="" title="결제대행사별 특징 > 서비스추가/변경 ↗" content="" />

package/assets/docs/help/core-service/how-to-use/payco-contract.md

@@ -0,0 +1,74 @@
+---
+title: 페이코 상세 계약절차
+category: 결제서비스 (채널설정 및 이용안내) > 이용안내 > 결제대행사 계약
+seo:
+  title: 페이코 상세 계약절차
+  description: >-
+    페이코의 전자결제 계약절차는 가입신청서 제출 - 계약안내 - 계약진행 - 계약완료 - 포트원 관리자콘솔 채널설정 - 개발진행 - 카드사
+    심사로 이뤄집니다. 각 계약절차를 확인해보세요.
+  keywords:
+    - 페이코
+    - 결제대행사 계약
+tags:
+  - 페이코
+  - 결제대행사 계약
+pgCompanies:
+  - 페이코
+searchTags:
+  - 페이코계약
+  - 페이코 가입신청
+  - '페이코계약절차 '
+datetime: 2024-01-25T15:00:00.000Z
+---
+
+<Callout content="" title="페이코와 계약을 맺으시기 위한 절차를 순서대로 알려드립니다." />
+
+### **가입신청서 제출**
+
+[포트원 관리자콘솔↗](https://admin.portone.io/) 안에서 페이코의 가입신청서를 제출합니다.
+
+- 경로 : [포트원 관리자콘솔↗](https://admin.portone.io/) 회원가입 및 로그인 > 좌측 상단 \[전자결제 신청] 버튼 클릭 > 사업자등록증 업로드 > 원하는 결제수단 & 결제대행사 선택 후 제출
+
+<Callout icon="" title="전자결제 신청방법 보러가기↗" />
+
+
+
+
+
+### **페이코의 계약 안내**
+
+- 포트원으로 접수해 주신 신청건은 당사에서 1차 검수 후 페이코로 전달되며,가입 신청서를 제출해 주신 이후 2\~3영업일 내 페이코 계약부서로부터 자세한 안내를 받습니다.
+- 계약안내 메일은 모두 1번의 절차에서 적어주신 담당자님 메일 주소로 발송됩니다.\
+  (스팸함으로 종종 누락되기도 하니 스팸함까지 확인해 주세요)
+
+### **계약진행**
+
+- 메일 내용에 따라 필요한 구비서류 및 계약서 작성을 진행해 주세요.
+- 결제대행사에서 요구하는 기본적인 구비서류는 아래를 통해 참고해 주시기 바라며 자세한 준비서류는 결제대행사로부터 안내받으실 메일에 기재되어 있습니다.
+
+<Callout title="계약 구비서류 보러가기 ↗" icon="" />
+
+### **계약완료**
+
+- 계약서 작성 및 보증보험 가입등을 마치시면 계약이 완료됩니다. 다음 절차인 카드사 심사를 준비합니다.
+- 상점정보가 미리 안내되었다고 하더라도 카드사 심사 전에는 운영환경 결제가 불가합니다. (결제실패발생)
+
+### **포트원 관리자콘솔 채널설정**
+
+- 포트원 관리자 콘솔에서 사용하실 PG사와 테스트용 MID를 설정합니다.
+
+<Callout icon="" title="페이코 채널설정방법 보러가기 ↗" />
+
+### **개발진행**
+
+- 포트원의 개발 연동 가이드를 참고하셔서 사이트 내 개발을 진행합니다.
+- 심사를 받으실 사이트 내에서 결제 서비스 연동을 완료해 주셔야 하며, 모든 항목들이 최종 완성본 형태로 구현되어 있진 않아도 심사에 필요한 항목은 필수적으로 노출 · 동작되어야 합니다.
+- 참고로 결제 이후 로직까지는 심사하지 않고 결제창이 정상적으로 노출되는지, 결제창 안에 카드사가 잘 노출되는지 등을 검수합니다.
+
+<Callout title="서비스 필수 구축요건 보러가기 ↗" icon="" />
+
+### **카드사 심사 진행**
+
+- 최종적으로 카드사 심사를 진행하셔야 실 결제 서비스 사용이 가능합니다.
+- 개발이 완료되 결제대행사(PG)로 카드사 심사를 요청하면, 결제대행사에서 각 카드사별로 심사를 요청하여 진행합니다.
+- 카드사 심사는 각 카드사별로 진행되므로 완료일자가 정확하진 않으나 보통 2주 정도 소요됩니다.

package/assets/docs/help/core-service/how-to-use/payment-settlement-method.md

@@ -0,0 +1,30 @@
+---
+title: 결제대행사 정산 방법
+category: 결제서비스 (채널설정 및 이용안내) > 이용안내 > 결제대행사 계약
+seo:
+  title: 결제대행사 정산 방법
+  description: >-
+    정산은 계약을 맺은 PG사에서 고객사로 직접 이뤄집니다. 서비스 업종/유형 등에 따라 PG사와 계약 시 정산 일자, 정산한도금액 등이
+    결정됩니다. PG사 관리자 페이지에서 자세한 상점 정보를 확인하세요.
+  keywords:
+    - 정산
+tags:
+  - 공통
+  - 결제대행사 계약
+pgCompanies:
+  - 공통
+searchTags:
+  - 정산한도
+  - 정산주기
+  - 정산방법
+datetime: 2024-01-25T15:00:00.000Z
+---
+
+<Callout content="정산은 계약을 맺으신 PG사에서 고객사로 직접 이뤄집니다." title="" />
+
+PG사와 계약을 맺으실 때 서비스 업종/유형 등에 따라  정산 일자, 정산한 도금액 등이 결정됩니다.
+
+이미 PG사와 계약을 맺으셨다면, \
+PG사의 관리자 페이지에서 자세한 상점 정보(결제수단, 수수료율, 정산 정보 등)을 확인하실 수 있습니다.
+
+PG사와 계약 시 결정된 정보이기 때문에 포트원에서는 정산 정보를 알 수 없으며 임의로 변경하는 것도 불가합니다.

package/assets/docs/help/core-service/how-to-use/paymentwall-contract.md

@@ -0,0 +1,85 @@
+---
+title: 페이먼트월 상세 계약절차
+category: 결제서비스 (채널설정 및 이용안내) > 이용안내 > 결제대행사 계약
+seo:
+  title: 페이먼트월 상세 계약절차
+  description: >-
+    페이먼트월의 전자결제 계약절차는 가입신청서 제출 - 페이먼트월 상점관리자페이지 접수 - 계약진행 - 계약완료 - 포트원 관리자콘솔
+    채널설정 - 개발진행 - 카드사 심사 -서비스 오픈으로 이뤄집니다. 각 계약절차를 확인해보세요.
+  keywords:
+    - 페이먼트월
+    - 결제대행사 계약
+tags:
+  - 페이먼트월
+  - 결제대행사 계약
+pgCompanies:
+  - 페이먼트월
+searchTags:
+  - 페이먼트월이용
+  - 페이먼트월계약방법
+  - 페이먼츠월가입방법
+  - 페이먼트월가입절차
+  - 페이먼트월 이용방법
+  - 페이먼트월 이용절차
+  - 페이먼트월계약
+  - 페이먼트월가입
+datetime: 2024-01-25T15:00:00.000Z
+---
+
+<Callout content="" title="페이먼트월과 계약을 맺으시기 위한 절차를 순서대로 알려드립니다." />
+
+### **가입신청서 제출**
+
+[포트원 관리자콘솔↗](https://admin.portone.io/)안에서 페이먼트월의 가입신청서를 제출합니다.
+
+- 경로 : [포트원 관리자콘솔↗](https://admin.portone.io/) 회원가입 및 로그인 > 좌측 상단 \[전자결제 신청] 버튼 클릭 > 사업자등록증 업로드 > 전자결제 직접 신청 > 해외결제 > 페이먼트월 > 결제방식을 선택해주세요.
+
+<Callout icon="" title="전자결제 신청방법 보러가기↗" />
+
+
+
+
+
+### **페이먼트월 상점관리자페이지 접수** <Highlight text="(중요)" />
+
+- 가입신청서 제출 완료가 되면 즉시 담당자님 메일로 안내메일을 발송드립니다. (포트원에서 발송)
+- 해당 메일 내 링크 버튼을 클릭하여 페이먼트월 페이지로 접속하여 신청서를 추가작성합니다.
+- **[페이먼트월 상점관리자(클릭) ](https://api.paymentwall.com/pwaccount/?source=import)페이지 접수를 진행하지 않으시는 경우 계약이 진행되지 않으므로 반드시 포트원에서 안내드린 링크로 꼭! 접속해주셔야 합니다.**
+
+### **계약진행**
+
+- 페이먼트월 상점관리자페이지 신청서 제출 이후 3영업일 내 페이먼트월 계약부서를 통해 상세 계약안내를 받으실 수 있습니다.
+- 메일 내용에 따라 필요한 구비서류 및 계약서 작성을 진행해 주세요.
+- 결제대행사에서 요구하는 기본적인 구비서류는 아래를 통해 참고해 주시기 바라며 자세한 준비서류는 결제대행사로부터 안내받으실 메일에 기재되어 있습니다.
+
+<Callout title="계약 구비서류 보러가기 ↗" icon="" />
+
+### **계약완료**
+
+- 계약서 작성 및 보증보험 가입등을 마치시면 계약이 완료됩니다.
+- 다음 절차인 카드사 심사를 준비합니다.
+- 상점정보가 미리 안내되었다고 하더라도 카드사 심사 전에는 운영환경 결제가 불가합니다. (결제실패발생)
+
+### **포트원 관리자콘솔 채널설정**
+
+- 심사를 위해 연동 테스트를 미리 준비합니다.
+- 먼저 포트원 관리자 콘솔에서 사용하실 결제대행사와 발급받으신 페이먼트월 KEY를 설정합니다.
+
+<Callout icon="" title="페이먼트월 채널설정방법 보러가기 ↗" />
+
+### **개발진행**
+
+- 포트원의 개발 연동 가이드를 참고하셔서 사이트 내 개발을 진행합니다.
+- 심사를 받으실 사이트 내에서 결제 서비스 연동을 완료해 주셔야 하며, 모든 항목들이 최종 완성본 형태로 구현되어 있진 않아도 심사에 필요한 항목은 필수적으로 노출 · 동작되어야 합니다.
+- 참고로 결제 이후 로직까지는 심사하지 않고 결제창이 정상적으로 노출되는지, 결제창 안에 카드사가 잘 노출되는지 등을 검수합니다.
+
+### **카드사 심사 진행**
+
+- 최종적으로 카드사 심사를 진행하셔야 실 결제 서비스 사용이 가능합니다.
+- 개발이 완료되 결제대행사(PG)로 카드사 심사를 요청하면, 결제대행사에서 각 카드사별로 심사를 요청하여 진행합니다.
+- 카드사 심사는 각 카드사별로 진행되므로 완료일자가 정확하진 않으나 보통 2주 정도 소요됩니다.
+
+### **서비스 오픈**
+
+- 심사가 완료되면 실 운영 상점정보로 연동하시어 이용하실 수 있습니다.
+- 실 운영환경에서도 충분한 테스트를 진행하신 이후에 서비스를 오픈하여 주시기 바랍니다.

package/assets/docs/help/core-service/how-to-use/paypal-contract.md

@@ -0,0 +1,66 @@
+---
+title: 페이팔 상세 계약절차
+category: 결제서비스 (채널설정 및 이용안내) > 이용안내 > 결제대행사 계약
+seo:
+  title: 페이팔 상세 계약절차
+  description: >-
+    페이팔의 전자결제 계약절차는 가입신청서 제출 - 페이팔 홈페이지를 통한 추가 온보딩과정 진행 - 포트원 관리자콘솔 채널설정 - 개발진행
+    및 서비스 오픈으로 이뤄집니다. 각 계약절차를 확인해보세요.
+  keywords:
+    - 페이팔
+    - 결제대행사 계약
+tags:
+  - 페이팔
+  - 결제대행사 계약
+pgCompanies:
+  - 페이팔
+searchTags:
+  - 페이팔계약문의
+  - 페이팔계약방법
+  - 페이팔가입방법
+  - 페이팔가입
+  - 페이팔등록
+  - 페이팔가입절차
+  - 페이팔사용
+  - 페이팔계약
+  - 페이팔이용방법
+datetime: 2024-01-25T15:00:00.000Z
+---
+
+<Callout content="" title="페이팔의 경우 별도 계약절차가 없어 하기 절차를 진행하신 뒤 즉시 운영 서비스 사용이 가능합니다." />
+
+### **가입신청서 제출**
+
+[포트원 관리자콘솔↗](https://admin.portone.io/) 안에서 페이팔의 가입신청서를 제출합니다.\
+(접수시 페이팔(SPB/RT) 서비스를 기준으로 적용되어 제출됩니다)
+
+- 경로 : [포트원 관리자콘솔↗](https://admin.portone.io/) 회원가입 및 로그인 > 좌측 상단 \[전자결제 신청] 버튼 클릭 > 사업자등록증 업로드 > 페이팔 선택 후 제출
+
+<Callout icon="" title="전자결제 신청방법 보러가기↗" />
+
+
+
+
+
+### **페이팔 홈페이지를 통한 추가 온보딩 과정 진행**
+
+가입신청사 제출까지 진행하시면 담당자님 메일로 메일이 발송됩니다. 메일 내 \[<Highlight text="페이팔 가입하러가기" />] 버튼을 클릭하여 온보딩 과정을 완료합니다. (이미 페이팔 비즈니스 계정이 있는 경우 링크 내에서 바로 로그인합니다.)
+
+#### **포트원 온보딩 절차**<Highlight text="(필수)" />
+
+[포트원 관리자콘솔↗](https://admin.portone.io/) 전자결제 신청 > 담당자님 메일로 수신받으신 메일 내 링크로 접속하여 로그인 및 회원가입하여 아래와 같이 PortOne와 연동되도록 합니다.
+
+<Callout title="포트원 전자결제 신청방식 보러가기 ↗" content="일반결제와 정기결제를 모두 이용하신다면, 각각 선택하여 접수해주시기 바랍니다." icon="" />
+
+
+
+### **포트원 관리자콘솔 채널설정**
+
+- 포트원 관리자 콘솔 테스트채널 혹은 실 운영 채널을 선택하여 설정해주세요.
+- 페이팔(SPB/RT) 테스트환경의 경우 당사에서 제공드리는 KEY를 사용하시면 되며, 실 운영환경의 경우 운영하시는 고객사 페이팔 계정의 key를 설정해주셔야 합니다.
+
+<Callout title="페이팔 채널설정방법 보러가기 ↗" />
+
+### **개발진행 및 서비스 오픈**
+
+포트원의 [개발 연동 가이드↗](https://developers.portone.io/opi/ko/integration/pg/v1/spb/readme?v=v1)를 참고하셔서 사이트 내 개발을 진행하시고 개발연동이 완료된 경우 서비스를 오픈하실 수 있습니다.