@portone/mcp-server 0.13.0

package/assets/docs/help/core-service/payment-type/billing-key.md

@@ -0,0 +1,72 @@
+---
+title: 정기결제의 '빌링키' 개념 안내
+category: 결제서비스 (채널설정 및 이용안내) > 결제유형 > 정기결제
+seo:
+  title: 정기결제의 '빌링키' 개념 안내
+  description: >-
+    정기결제 전 고객의 카드정보에 대응하는 결제용 암호화 key인 빌링키가 발급됩니다. 빌링키 발급 방식은 결제창 방식과 API 방식
+    2가지가 있으며, 향후 정기결제 진행시 이때 발급된 빌링키를 이용하여 결제가 이뤄지게 됩니다.
+tags:
+  - 공통
+  - 정기결제
+pgCompanies:
+  - 공통
+searchTags:
+  - 빌링키발급
+  - customer_uid
+  - 정기결제 빌링키
+  - 빌링키
+datetime: 2024-01-25T15:00:00.000Z
+---
+
+### **빌링키의 개념**
+
+- 고객이 정기결제를 시도하고 난 뒤 고객사에서는 고객의 결제정보를 저장할 수 있습니다.
+- 결제정보는 민감한 정보이기 때문에 카드사에서는 해당<Highlight text="카드 정보에 대응하는 결제용 암호화 key인 빌링키" />를 \
+  발급해 줍니다.
+- 포트원에서는 빌링키 발급 시 고객사에서 지정한 customer\_uid를 unique\_key로 포트원 서버에 저장합니다.
+- 보안상의 이유로 서버는 빌링키에 직접 접근하실 수 없기 때문에 빌링키와 대응하는 customer\_uid를 \
+  활용하셔야 합니다. 만약 고객이 여러 장의 카드를 등록하였다면 customer\_uid를 카드 한 장에 대응하도록 \
+  값을 구성해 주셔야 합니다.
+
+### **빌링키 발급 방식**
+
+###### **빌링키를 발급받는 방식은 총 2가지가 존재합니다.**
+
+1. 결제창 방식 : PG사의 결제창을 띄워 결제정보를 입력하여 빌링키를 발급받는 방식
+
+<Indent level="1">
+
+- PG사에서 제공하는 결제창 화면을 반드시 띄워야 합니다.
+- 결제창 호출(IMP.request\_pay) 시 customer\_uid 파라미터를 반드시 함께 지정해야 합니다.
+- PG사에서 요구하는 본인인증(공인인증) 절차가 존재할 수 있습니다.
+
+</Indent>
+
+
+
+2\. API 방식 : API 호출로 빌링키를 발급받는 방식
+
+<Indent level="1">
+
+- 고객이 카드정보를 입력하는 화면 UI를 직접 구현해야 합니다.
+- API 호출시 필요한 고객의 카드정보를 반드시 함께 호출해야 합니다.
+
+</Indent>
+
+
+
+### **빌링키 발급시 필요한 정보**
+
+###### **빌링키 발급 시에 기본적으로 필요한 정보는 다음과 같습니다.**
+
+<Indent level="1">
+
+- 카드번호
+- 유효기간(년/월)
+- 생년월일(6자리) 혹은 사업자번호 10자리 (무기명 법인 사업자의 경우에만 사업자 번호를 입력)
+- 비밀번호 앞 2자리
+
+</Indent>
+
+<Callout content="필요한 정보 갯수는 결제대행사별로 다소 상이할 수 있으나 대부분의 경우 위 4가지를 모두 요구합니다." title="참고사항" icon="💡" />

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

@@ -0,0 +1,39 @@
+---
+title: 정기결제 again 과 schedule API의 차이가 있나요?
+category: 결제서비스 (채널설정 및 이용안내) > 결제유형 > 정기결제
+tags:
+  - 정기결제
+searchTags:
+  - 정기결제 api
+  - 정기결제
+  - 스케줄 API
+  - 스케줄
+  - schedule API
+datetime: 2024-05-09T08:20:14.620Z
+---
+
+<Callout content="schedule api는 again api를 가맹점 대신에 
+**포트원이 대신 수행해주고 결제 결과를 가맹점측에 웹훅으로 알려주는 API 입니다.**" />
+
+포트원을 통해 schedule API를 활용하실 경우,
+결제 결과는 설정하신 웹훅으로 보내 드리기 때문에 정기결제를 구현함에 있어 그 로직이나 과정이 복잡하지 않습니다.
+
+정해진 일자에 단순하게 결제가 이루어지기만 하면 될 경우 schedule  API를 쓰셔서 웹훅으로 받은 결제 결과의 실패/성공에 따른 처리만 하시면 됩니다.\
+반면, 가맹점의 정기결제 서비스 로직 전/후에 수행해야하는 특별한 로직이 있거나 정기결제가 이루어지는 과정을 자유롭게 커스터마이징 하고 싶으시다면 cronjob을 직접 수행하여 again api 를 사용하셔도 무방합니다.
+
+포트원에서는 가맹점의 정기결제 로직이 복잡하지 않다면 schedule api를 사용하시길 권장드리고 있습니다.
+
+### **schedule API의 처리 순서**
+
+1.최초 카드정보 등록으로 빌링키 발급 및 발급된 빌링키에 customer\_uid로 1:1대응 후 포트원 내 저장       
+
+2.결제일자가 확정되는 시점에 schedule API로 일정 / 금액 / 결제할 customer\_uid 등 지정       
+
+3.해당 시각에 처리가 완료되면 성공/실패 여부를  웹훅으로 POST요청       
+
+4.결제 성공이면 webhook에서 크레딧 증가 후 다음 schedule등록 API추가
+(실패될 경우 원하는 일자에 다시 재결제 되도록 로직을 구현해주셔야 합니다.)     
+
+<Callout icon="💡" title="참고사항" content="날짜는 서비스 특성에 따라 다소 달라질 것 같기는 합니다만, 날짜 문제를 없애기 위해 +N day 식으로 처리를 하고 있습니다." />
+
+<Callout title="웹훅에 대하여 자세히 보러가기 ↗" />

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

@@ -0,0 +1,176 @@
+---
+title: '글로벌_페이레터 해외결제 서비스 안내 '
+category: 결제서비스 (채널설정 및 이용안내) > 결제유형 > 해외결제
+tags:
+  - 페이레터
+  - 크로스보더
+  - 해외결제
+pgCompanies:
+  - null
+searchTags:
+  - 해외 정기결제
+  - 해외결제
+  - '크로스보더 '
+  - '글로벌 정기결제 '
+  - 글로벌
+datetime: 2024-06-11T06:06:47.384Z
+---
+
+<Callout content="" title="글로벌 페이레터를 통한 해외결제 이용시 아래 특징을 참고해주세요!" />
+
+### **글로벌 페이레터 서비스 이용안내**
+
+- 글로벌 서비스 확장 시, 현지 국가 결제 수단 기능 추가 연동 개발 없이 이용 가능
+- 간편한 DCC(Dynamic Currency Conversion) 기능 지원
+- 다양한 기능을 제공하는 관리자 콘솔 지원
+- 링크 생성 결제 기능 지원
+- 코리아포트원 설정 없이 글로벌 포트원 콘솔 설정/연동 가능
+
+#### **서비스 이용절차**
+
+- 포트원 해외결제서비스 [도입문의](https://go.portone.io/l/1047343/2023-11-27/6rv/?_gl=1*19xamm*_gcl_au*MTk3NzM1MTQzMC4xNzE3NzMwMDU0*_ga*OTE5ODY1NzY1LjE3MDY3Nzk5MDA.*_ga_PD0FDL16NZ*MTcxODE4MDYwMy4xNDEuMS4xNzE4MTgyOTkzLjAuMC4w) 신청
+- 페이레터 사전 심사 진행
+- 포트원 서비스 이용 계약 진행
+- 페이레터 계약 진행 (가입신청/카드사 심사)
+
+#### **지원 결제 수단**
+
+- 해외 발행 글로벌 카드 : VISA, Master, JCB/AMEX/UnionPay
+
+#### **지원 결제 방식**
+
+- 해외카드 일반(인증) 결제창 방식
+- 해외카드 정기(비인증) 결제창 방식 : 유니온페이 제외
+
+#### **지원 하는 통화**
+
+- 결제통화
+
+<Indent level="1">
+
+- 해외카드 VISA, Master, JCB : USD, KRW, JPY
+- 해외카드 Amex : USD, KRW
+- 해외카드 UnionPay : USD, KRW
+
+</Indent>
+
+- 정산통화
+
+<Indent level="1">
+
+- 정산 가능 통화 : KRW, USD
+
+</Indent>
+
+- DCC(Dynamic Currency Conversion) 서비스
+
+<Indent level="1">
+
+DCC는 고객이 카드를 발급받은 국가에 따라 결제시 자국의 화폐로 결제할 수 있는 고객편의 서비스 입니다. 
+
+- 페이레터가 지원하는 결제통화에 대해서 DCC 기능 이용이 가능합니다.
+- 포트원의 DCC의 경우 결제(승인)통화와 결제자의 국가코드를 기준으로 두 가지의 통화에 대해 사용자에게 선택권을 부여합니다.
+- 따라서 스토어의 기본통화 외에 ‘자국 화폐’로 신용카드 결제를 진행하게 하며, 자국통화로만 진행되는 간편결제(Alternative Payment Method) 들도 이용이 가능합니다.
+- 예를 들어, 스토어 상품을 USD로 설정하였고, 결제자를 한국으로 인식하셨다면 USD와 KRW 간에 DCC 가 이루어지며, KRW로 변환 시 KRW를 지원하는 PG사와 한국의 간편결제사를 결제창에 동적으로 노출 시킵니다.
+
+</Indent>
+
+#### **결제 수수료(VAT별도)**
+
+- 페이레터 PG 수수료
+
+<Indent level="1">
+
+1. 해외카드(VISA, Master, JCB)
+
+- 객단가 USD50.00 이상\_인증결제: 4.20% / 비인증결제: 4.40%
+- 객단가 USD50.00 미만\_인증결제: 6.30% / 비인증결제: 6.50%
+
+2\. 해외카드(Amex): 4.50%
+
+3\. 해외카드(UnionPay): 4.10%
+
+</Indent>
+
+- 페이레터 가입비 (VAT별도)
+
+<Indent level="1">
+
+20만원 (페이레터 정책/ 최초 1회 과금)
+
+</Indent>
+
+#### **포트원 이용요금(VAT별도)**
+
+<Indent level="1">
+
+0.50% (minimum 500 USD)
+
+- 코리아 포트원과 별도 계약이 필요 합니다.
+- 전월 발생된 거래액 기준으로 청구 됩니다.
+
+</Indent>
+
+#### **정산주기**
+
+- 해외카드(Visa, Master, JCB, Amex, UnionPay) : 매주 목요일 정산(익익주 전 일요일\~토요일 거래)
+- 정산시 , 환율기준 : 정산 전 일 국민은행 10회차 고시 환율(전신환 매입율) 적용
+- 롤링 리저브 : 10%, 180일\
+  (일반 PG사의 보증보험의 개념으로, 정산금액의 10%를 180일동안 가지고 있다가 이후에 정산해주는 개념입니다)
+
+#### 📌 결제대행사별 위험 업종유형을 참고 하세요!
+
+- 결제대행사(PG) 계약을 위해서는 온라인 결제시 판매하는 서비스(상품) 유형을 1차적으로 심사를 하고 입점 가능여부가 결정됩니다.
+- 결제대행사(PG)별 입점 심사 기준(RM)정책은 카드사 등록불가 업종 기준을 바탕으로 적용됩니다.
+
+<Callout title="글로벌_페이레터_해외결제 제한 업종 보러가기 ↗" />
+
+#### **글로벌\_페이레터 연동방법**
+
+- [글로벌 포트원 가입 ↗ ](https://admin.portone.cloud/register) > 가입 후 테스트 연동을 위한 \[[글로벌 포트원 콘솔 ↗](https://admin.portone.cloud/)] 채널(PSP)정보 설정 및 결제 테스트 진행
+- 참고가이드
+
+<Indent level="1">
+
+- [글로벌 포트원 콘솔 채널(PG) 정보 설정 방법  보러가기↗](https://www.docs.portone.cloud/docs/cross_border/cross_border_integration)
+- [글로벌 포트원 결제 연동 메뉴얼 보러가기↗](https://www.docs.portone.cloud/docs/cross_border/cross_border_integration)
+- [글로벌 포트원\_페이레터 테스트 연동정보 보러가기↗](https://www.docs.portone.cloud/docs/cross_border/cross_border_integration)
+- [글로벌 포트원\_통합 콘솔 가이드 보러가기↗](https://docs.portone.cloud/docs/getting-started-2)
+
+</Indent>
+
+<Callout title="참고사항" content="1. 페이레터는 이용하실 결제(승인) 통화별로 PG상점아이디(MID)를 발급이 필요 합니다.
+2.정기결제서비스 이용시, 실운영(Live)용 상점아이디(MID)를 페이레터로부터 발급받은 후 페이레터 측에서 포트원의 서버 아이피를 등록해야 하는 절차가 필요하고, (글로벌 포트원 서버 아이피-13.228.32.0)
+3. 결제통화를 여러개 사용을 원하시면 “마스터-서브 머천트” 구조로 포트원의 계정을 개설하신 다음에, 
+결제통화 별로 서브 머천트 형태로 계정을 설정해야 하니 이용에 참고 부탁 드립니다.
+4. 카드사 심사시 영문/현지어 사이트와 해외카드 연동이 되어 있어야 합니다. " icon="💡" />
+
+### **글로벌 포트원 콘솔 설정 및 결제창 예시**
+
+- 글로벌 포트원 콘솔 설정화면 예시
+
+
+
+
+
+- **글로벌 포트원 페이레터 결제창 예시**
+
+<Indent level="1">
+
+- ‘페이레터’ 에서 제공하는 결제창이 호출 됩니다.
+- 페이레터 결제창 내의 \[CreditCard(3DS]를 클릭하시면 일반(인증)결제 방식으로 결제가 진행되고,\
+  \[CreditCard]클릭시 비인증결제 모듈로 카드정보 입력하는 화면이 보여지고 빌링키 발급이 가능합니다.
+
+</Indent>
+
+
+
+
+
+- **글로벌 포트원 DCC 설정 및 결제창 기능 적용예시**
+
+
+
+
+
+<Callout title="글로벌_해외결제 대행사별 위험업종 유형 보러가기 ↗" />

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

@@ -0,0 +1,37 @@
+---
+title: '나이스페이먼츠_허브형 간편결제 추가방법 '
+category: 결제서비스 (채널설정 및 이용안내) > 결제유형 > 간편결제
+tags:
+  - 허브형
+  - 간편결제
+pgCompanies:
+  - 나이스페이먼츠
+searchTags:
+  - 허브형 간편결제
+  - 나이스페이먼츠 간편결제
+  - 나이스페이먼츠
+  - 간편결제
+  - 허브형
+datetime: 2024-09-24T05:40:12.616Z
+---
+
+<Callout content="나이스페이먼츠에 이미 가입되어 있으신 경우, 
+나이스페이먼츠측에 간편결제 추가계약 절차가 필요 합니다!" />
+
+### 나이스페이먼츠 추가계약 절차
+
+- 나이스페이먼츠 계약부서(TEL : 1661-7335 > 3)를 통해, 간편결제 서비스 추가 계약 요청
+- 나이스페이먼츠 서비스 추가 계약/심사 진행
+  \- 간편결제용 MID 발급을 위한 \[아이디 추가 신청서] 및 \[간편결제 신청서] 접수 필요
+  \- 별도 심사 후 이용가능, 일부 유의업종 서비스 제공 불가
+- 나이스페이먼츠 간편결제 서비스 입점 심사 진행 및 가맹점 심사 결과 안내
+- 나이스페이먼츠 간편결제 서비스 사용 설정
+- 서브몰 심사 요청(원천사(간편결제사) 심사 요청)
+- 서브몰 심사 완료
+
+추가 계약 요청 후 나이스페이먼츠 담당자가 계약절차 및 계약서류 안내드릴 예정입니다. (약 3영업일 소요)
+
+- [허브형 간편결제 이용 방법 보러가기 ↗](https://help-center-portone.vercel.app/content/hub-service-fee)
+- [나이스페이먼츠\_간편결제 연동 방법 ↗](https://help.portone.io/content/nice-easypay-hub-fee)
+
+<Callout title="참고사항" content="나이스페이먼츠는 일반결제와 허브형 간편결제용 MID가 별도 발급되므로, 추가 설정하시어 pg파라미터에 MID를 지정하여 요청하도록 구현 부탁 드립니다." />

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

@@ -0,0 +1,150 @@
+---
+title: 애플페이 서비스 이용안내
+category: 결제서비스 (채널설정 및 이용안내) > 결제유형 > 간편결제
+tags:
+  - 간편결제
+searchTags:
+  - 간편결제
+  - apple pay
+  - 애플페이
+datetime: 2024-11-11T05:59:07.351Z
+---
+
+### **이제 포트원을 통해 Apple pay 이용이 가능합니다**
+
+<Callout content="이제 포트원을 통해서도 애플페이 결제를 이용하실 수 있습니다.
+포트원을 통해 KCP, 토스페이먼츠, KG이니시스에서 제공하는 Apple pay를 바로 경험해보세요!" />
+
+### **\[지원 가능한 조건]**
+
+- 지원PG사 :  KCP , (구)토스페이먼츠 , (신)토스페이먼츠, KG이니시스, (신)나이스페이먼츠
+- 카드 : 현대카드 (그외 국내 발행 카드사 및 해외 발행카드 미지원)
+- 결제방식 : 일반결제 (정기결제 미지원)
+
+### **\[PG사별 이용방법]**
+
+<Callout content="현재 워드프레스는 직접 호출방식 지원이 어렵습니다." icon="💡" />
+
+<Highlight text="KCP" />
+
+<Indent level="1">
+
+- **수수료**\
+  \- 카드 결제수수료율과 동일\
+  (기존 가맹점의 경우 카드결제수수료율과 동일하게 적용)
+- **연동 지원방식**\
+  \-  KCP 결제창 내 선택가능\
+  \- 애플페이 직접 호출 가능
+- **신청방법**\
+  \- 기존 가맹점 : [기존 KCP 상점관리자페이지](https://admin8.kcp.co.kr/assist/login.LoginAction.do) > (우측상단) \[질문하기] > 추가서비스 > 결제수단:신용카드 or ’고객센터 > 질문하기 > 추가서비스 > 결제수단 : 신용카드’ (_신청시 결제창을 통한 방식인지, 직접호출 방식인지 KCP측으로 전달필요_)\
+  \- 신규 가맹점 : PG 서비스 가입 신청 시, 간편결제를 포함하여 신청
+- **연동 유의사항**\
+  \- `Mobile Safari 한하여 지원가능`
+- **연동방식**\
+  \- PG사 결제창 화면 내에서 이용 \
+  **<결제창 호출시 pay method : card>**\
+  \- 애플페이 직접 호출\
+  **<결제창 호출시 pay method : `applepay`>**
+
+</Indent>
+
+<Highlight text="(구)토스페이먼츠" />
+
+<Indent level="1">
+
+- **수수료**\
+  \- 카드 결제수수료율과 동일\
+  (기존 가맹점의 경우 카드결제수수료율과 동일하게 적용)
+- **연동 지원방식**\
+  \-  토스페이먼츠 결제창 내 선택가능\
+  \- 애플페이 직접 호출 가능
+- **신청방법**\
+  \- 기존 가맹점 : 상점관리자(신용카드사 셋팅된 MID 기준) > 이용정보 > 결제⋅부가서비스 > 이용서비스, 간편결제 변경하기를 통해 신청\
+  \- 신규 가맹점 : PG 서비스 가입 신청 시, 간편결제를 포함하여 신청
+- **연동 유의사항**\
+  \- `PC, Mobile 모두 Safari 한하여 지원가능`
+- **연동방식**\
+  \- PG사 결제창 화면 내에서 이용 \
+  **<결제창 호출시 pay method : card>**\
+  \- 애플페이 직접 호출\
+  **<결제창 호출시 pay method : `applepay`>**
+
+</Indent>
+
+<Highlight text="(신)토스페이먼츠" />
+
+<Indent level="1">
+
+- **수수료**\
+  \- 카드 결제수수료율과 동일\
+  (기존 가맹점의 경우 카드결제수수료율과 동일하게 적용)
+- **연동 지원방식**\
+  \-  토스페이먼츠 결제창 내 선택가능\
+  \- 애플페이 직접 호출 가능
+- **신청방법**\
+  \- 기존 가맹점 : 상점관리자(신용카드사 이용중인 MID 기준) > 이용정보 > 결제⋅부가서비스 > 이용서비스, 간편결제 변경하기를 통해 신청\
+  \- 신규 가맹점 : PG 서비스 가입 신청 시, 간편결제를 포함하여 신청
+- **연동 유의사항**\
+  \- `PC, Mobile 모두 Safari 한하여 지원가능`
+- **연동방식**\
+  \- PG사 결제창 화면 내에서 이용 \
+  **<결제창 호출시 pay method : card>**\
+  \- 애플페이 직접 호출\
+  **<결제창 호출시 pay method : `applepay`>**
+
+</Indent>
+
+<Highlight text="(신)나이스페이먼츠" />
+
+<Indent level="1">
+
+- **수수료**\
+  \- 카드 결제수수료율과 동일\
+  (기존 가맹점의 경우 카드결제수수료율과 동일하게 적용)
+- **연동 지원방식**\
+  \-  나이스페이먼츠 결제창 내 선택가능\
+  \- 애플페이 직접 호출 가능
+- **신청방법**\
+  \- 기존 가맹점 : 나이스페이 고객센터 혹은 포트원 고객센터를 통해 애플페이 서비스 별도 신청\
+  \- 신규 가맹점 : 포트원 관리자콘솔 내 신청시 ‘메모’란에  애플페이 서비스 신청  기입
+- **연동 유의사항**\
+  \- `Mobile Safari 한하여 지원가능`
+- **연동방식**\
+  \- PG사 결제창 화면 내에서 이용 \
+  **<결제창 호출시 pay method : card>**\
+  \- 애플페이 직접 호출\
+  **<결제창 호출시 pay method : `applepay`>**
+
+</Indent>
+
+<Highlight text="KG이니시스" />
+
+<Indent level="1">
+
+- **수수료**\
+  \- 카드 결제수수료율과 동일\
+  (기존 가맹점의 경우 카드결제수수료율과 동일하게 적용)
+- **연동 지원방식**\
+  \-  토스페이먼츠 결제창 내 선택가능\
+  \- 애플페이 직접 호출 가능
+- **신청방법**\
+  \- 기존 가맹점 : [KG이니시스 상점관리자](https://iniweb.inicis.com/security/login.do) (신용카드 이용중인 MID 기준) > 변경/추가 > 정보변경 및 서비스 추가 > 1.2 지불수단 추가 및 변경 > 1.2.1 지불수단 추가 및 변경 > 6. 간편결제 > Apple pay \[사용] 선택 후 신청하기\
+  \- 신규 가맹점 : PG 서비스 가입 신청 시, 간편결제를 포함하여 신청
+- **연동 유의사항**\
+  \- `PC, Mobile 모두 Safari 한하여 지원가능`
+- **연동방식**\
+  \- PG사 결제창 화면 내에서 이용 \
+  **<결제창 호출시 pay method : card>**\
+  \- 애플페이 직접 호출\
+  **<결제창 호출시 pay method : `applepay`>**
+
+</Indent>
+
+### **\[연동방식별 화면 미리보기]**
+
+- PG사 결제창을 통해 연동하기
+
+
+
+- 애플페이 직접 호출하기
+