@portone/mcp-server 0.13.0

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

@@ -0,0 +1,60 @@
+---
+title: NHN KCP 해외결제 서비스 이용방법
+category: 결제서비스 (채널설정 및 이용안내) > 결제유형 > 해외결제
+seo:
+  title: KCP 해외결제 서비스 이용안내
+  description: >-
+    KCP의 해외카드 서비스를 통한 해외결제 이용방법 안내드립니다. KCP의 지원결제 수단 및 특징, 입점기준, 특약 신청방법, 참고사항까지
+    자세한 정보를 확인해보세요.
+  keywords:
+    - 해외결제
+tags:
+  - 'NHN KCP '
+  - 해외결제
+pgCompanies:
+  - NHN KCP
+searchTags:
+  - 해외결제
+  - 해외카드특약
+  - 해외카드
+  - 'kcp해외카드 '
+  - kcp해외결제
+datetime: 2024-01-25T15:00:00.000Z
+---
+
+<Callout content="NHN KCP를 통한 해외결제 이용방법을 안내 드립니다." />
+
+### **NHN KCP의 해외카드결제 서비스 이용안내**
+
+1. **지원결제수단**
+
+- 해외카드 (VISA, MASTER, JCB, DINERS)
+
+**2. 지원서비스 특징**
+
+- 지원가능 통화 : KRW (승인/정산) , USD (NHN KCP측과 별도 협의필요)
+- 결제방식 : NHN KCP결제창을 띄우는 방식으로만 가능
+- 지원가능언어 : 한국어, 영어
+- 정산방식 : 원화결제 - 원화정산 / 달러결제 - 달러정산 (NHN KCP측과 별도 협의 필요)
+- USD 결제의 경우 입점이 어려운 편이며 대부분의 경우 KRW를 지원합니다.
+
+**3. 입점기준**
+
+- NHN KCP와 계약을 맺으실 사업자의 서비스가 비실물 서비스인 ‘컨텐츠’ 일 경우 입점이 불가합니다.
+- 국내사업자로만 계약이 가능합니다.
+- 해외 법인 사업자 계약불가
+- NHN KCP를 통해 해외카드 사용 특약을 맺은 후 서비스 사용가능
+
+**4. 참고사항**
+
+- NHN KCP의 경우에는 해외카드 결제 시 국내 카드 결제와 비슷하게 인증시스템(3D인증)을 거쳐야하기에 인증 절차가 없는 해외 결제자들에게는 결제를 하는데 불편함이 있습니다.
+
+**5. 특약 신청방법**
+
+- [NHN KCP 상점관리자페이지 ↗](https://partner.kcp.co.kr/auth/login) > 고객센터 > 질문하기 > 해외카드 신청 > 내용입력 후 문의하기
+
+
+
+<Callout title="V2 NHN KCP 연동가이드 보러가기↗" />
+
+<Callout title="V1 NHN KCP 연동가이드 보러가기↗" />

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

@@ -0,0 +1,72 @@
+---
+title: 나이스페이먼츠를 통한 간편결제 연동방법
+category: 결제서비스 (채널설정 및 이용안내) > 결제유형 > 간편결제
+tags:
+  - 나이스페이먼츠
+  - 간편결제
+pgCompanies:
+  - 나이스페이먼츠
+searchTags:
+  - 간편결제창 바로 호출
+  - 나이스페이
+  - 결제창
+  - 나이스페이먼츠
+  - 간편결제
+datetime: 2024-07-08T05:47:06.710Z
+---
+
+**나이스페이를 통하여 간편결제서비스를 이용하시는 경우 아래 두가지 방법으로 연동이 가능합니다.**\ <Highlight text="나이스페이는 (구)모듈과 (신)모듈에 따라 지원가능한 간편결제" /> **가 상이하오니 유의하시어 연동부탁드립니다.**
+
+**1) 나이스페이 결제창 안에서 간편결제를 이용**\
+**2) 간편결제창을 직접 띄우는 방법**
+
+## **(구)나이스페이먼츠**
+
+#### **1.  나이스페이먼츠 결제창 내 간편결제 서비스 이용**
+
+- pg : nice.상점아이디
+- pay\_method : '**card**'
+
+<Callout content="꼭 확인해주세요!
+위 예시 화면은 범용적으로 모든 가맹점이 사용할 수 있도록 제공되는 결제창으로, 
+포트원를 통한 (구)나이스페이 이용시 간편결제는 ‘카카오페이’ 만 지원가능합니다." icon="💡" title="참고사항 " />
+
+
+
+#### **2. 직접 간편결제 모듈 호출하는 방식 이용(**<Highlight text="간편결제창 바로 호출!" />**)**
+
+- pg : nice.상점아이디
+- pay\_method
+
+<Indent level="1">
+
+- kakaopay
+
+</Indent>
+
+## **(신)나이스페이먼츠**
+
+#### **1.  나이스페이먼츠 결제창 내 간편결제 서비스 이용**
+
+- pg : nice\_v2.상점아이디
+- pay\_method : '**card**'
+
+#### **2. 직접 간편결제 모듈 호출하는 방식 이용 (**<Highlight text="간편결제창 바로 호출!" />**)**
+
+- pg : nice\_v2.상점아이디
+- pay\_method 
+
+<Indent level="1">
+
+- naverpay\_card (네이버페이 - 카드)
+- naverpay\_point (네이버페이 - 포인트)
+- kakaopay (카카오페이)
+- payco (페이코)
+- samsungpay (삼성페이는 카드수수료의 0.3%가 추가적으로 부과 됩니다(삼성페이 정책))
+- skpay (SKPAY)
+- ssgpay (SSGPAY)
+- ssgpay\_bank (SSGPAY 은행계좌)
+- lpay (LPAY)
+- applepay (애플페이)
+
+</Indent>

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

@@ -0,0 +1,51 @@
+---
+title: 나이스페이먼츠 해외결제 서비스 이용안내
+category: 결제서비스 (채널설정 및 이용안내) > 결제유형 > 해외결제
+seo:
+  title: 나이스페이먼츠 해외결제 서비스 이용안내
+  description: >-
+    나이스페이먼츠의 해외카드결제 서비스를 통한 해외결제 이용방법 안내드립니다. 나이스페이먼츠의 지원결제 수단 및 특징, 입점기준, 특약
+    신청방법, 참고사항까지 자세한 정보를 확인해보세요.
+  keywords:
+    - 나이스페이먼츠
+    - 해외결제
+tags:
+  - 나이스페이먼츠
+  - 해외결제
+pgCompanies:
+  - 나이스페이먼츠
+datetime: 2024-01-25T15:00:00.000Z
+---
+
+<Callout content="나이스페이먼츠를 통한 해외결제 이용방법 안내드립니다." />
+
+### **나이스페이먼츠의 해외카드결제 서비스 이용안내**
+
+1. **지원 결제수단**
+
+- 해외카드 : VISA, MASTER, Unionpay
+
+##### **2. 지원 서비스 특징**
+
+- 지원가능 통화 : KRW (승인/정산) , USD (나이스페이측과 별도 협의필요)
+- 결제방식 : KCP결제창을 띄우는 방식으로만 가능
+- 지원가능언어 : 한국어, 영어, 중국어
+- 정산방식 : 원화결제 - 원화정산
+
+##### **3. 입점기준**
+
+- 국내사업자로만 계약이 가능합니다. (해외 법인 사업자 계약불가)
+- 나이스페이먼츠를 통해 해외카드 사용 특약을 맺은 후 서비스 사용이 가능합니다.
+- 컨텐츠 상품도 입점심사을 받아볼 수 있습니다.
+
+##### **4. 참고사항**
+
+나이스페이먼츠의 경우에는 해외카드 결제 시 국내 카드 결제와 비슷하게 인증시스템(3D인증)을 거쳐야하기에\
+인증 절차가 없는 해외 결제자들에게는 결제과정이 다소 불편할 수 있습니다.
+
+<Callout content="나이스페이 고객센터로 문의하여 해외카드 서비스 신청
+나이스페이 신규계약부서 : 1661-7335 - 3 혹은 pghelp@nicepay.co.kr 로 문의" title="특약 신청방법" icon="💡" />
+
+<Callout title="V2 나이스페이먼츠 연동가이드 보러가기↗" />
+
+<Callout title="V1 나이스페이먼츠 연동가이드 보러가기↗" />

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

@@ -0,0 +1,84 @@
+---
+title: 페이먼트월 해외결제 서비스 이용안내
+category: 결제서비스 (채널설정 및 이용안내) > 결제유형 > 해외결제
+seo:
+  title: 페이먼트월 해외결제 서비스 이용안내
+  description: >-
+    해외 각국의 결제수단을 다양하게 제공하는 페이먼트월 서비스 안내드립니다. 가입방법, 입점기준, 결제 수수료, 결제 수단, 지원통화,
+    정산, 문의처, 연동가이드, 결제 한도, 결제취소 금액, 정산환율, 취소 수수료까지 모두 확인해보세요.
+  keywords:
+    - 해외결제
+tags:
+  - 페이먼트월
+  - 해외결제
+pgCompanies:
+  - 페이먼트월
+searchTags:
+  - 'RR '
+  - PR
+  - 페이먼트월 정기결제
+  - 페이먼트월 일반결제
+  - 페이먼트월
+  - 해외결제
+datetime: 2024-01-25T15:00:00.000Z
+---
+
+<Callout content="각국의 결제수단을 다양하게 제공하는 PG사인 '페이먼트월'의 서비스를 자세히 안내드립니다." />
+
+### **페이먼트월 해외결제 서비스**
+
+
+
+- 가입방법 : [포트원 관리자콘솔↗](https://admin.portone.io/auth/signin) 에서 '전자결제신청' 클릭하여 신청서 접수 \
+  ('현지 결제수단' 이용시 체크 후 이용하실 국가명 선택 필수)
+- 입점기준 : 최소 월 매출액 : $10,000 이상 입점 가능
+  - 가입접수 > 매출 발생여부 확인 > 증빙(주문/결제내역) 제출
+  - 국내 결제 $10,000 이상 발생시 심사 가능
+- 이용료 : 월 관리비 적용 : 100USD / Monthly
+  - 월 매출액 기준 없음(2023년 1월 1일 가입건 부터))
+- 결제수수료 : [해외결제 수수료 표 보러가기↗](https://help.portone.io/category/pricing?location=oversea)
+- 결제방식 : 페이먼트월 결제창을 통한 일반결제 방식
+- 결제수단 : 글로벌 결제 , 해외 현지국가 결제
+- 통화
+  - 결제통화
+    - 한국매입사 지원 통화(결제) : USD/JPY/KRW/EUR/RUB/HKD/AUD/GBP/CAD/THB
+    - 현지 결제 : 현지 국가 별 현지통화만 지원
+    - Alipay (CNY/USD 결제 가능)
+  - 정산 통화 : USD / EUR
+  - 정산방법 : 정산금액 지급은 월 1회에서 2회 자동으로 진행되며 매월 1일 혹은 15일에 약 1일에서 5일정도의 시간이 소요되어 진행됩니다.
+    금액정산 및 지급은 고객사에서 선택하신 정산 방식에 따라 소요시간에 차이가 있으며 금액정산 예정일 및 정산률을 포함한 보고서 조회가 가능합니다
+    - [페이먼트월 정산 QnA 보러가기↗](https://www.paymentwall.com/kr/faq/payouts/194)
+  - 결제요청 한도기준 : 결제요청 가능한 최대 건별 한도 : USD 500 제공 , 한도 상향이 필요한 경우, 페이먼트월 요청하여 페이먼트월 내부 검토 후 상향 조정 안내.
+  - 최소 결제 요청 가능한 금액 : 최소 결제금액 0.3 EUR (약 $0.5)  해외카드 단건/정기 모두 동일
+  - 정산환율 :
+    - 달러(USD) 정산 시에는 적용되는 환율은 없습니다. 다만, 결제 시 USD로 전환되는 환율은 있고 결제사별로 다르게 환율이 적용되므로, 페이먼트월 계약시 체크 필요합니다.
+    - 일부 결제사는 결제 당일 실시간 고시환율로 USD 환전 정산 됩니다.
+    - 일부 결제사는 일단 현지 통화로 결제 및 대금 수납 후 페이먼트월쪽에 정산하는 날짜의 환율로 USD 환전 적용 됩니다.
+    - ‘대체결제 수단(현지결제/간편결제)’의 경우, 페이먼트월 결제 파트너사의 정산일의 환율 적용되며, ‘신용카드’ 같은 경우 매입사는 실시간 은행사 환율이 적용 됩니다.
+    - ‘국내(발행)카드’는 결제는 KRW로 되지만 모든 정산은 USD로 처리되고 환율 기준은 결제사 별로 상이 합니다.
+  - 참고사항 : 페이먼트월 정책상 결제를 시도하는 국가IP에 따라 결제수단이 노출됩니다. (국내에서 해외결제를 테스트하고자 하실 경우, 해당 국가의 vpn을 이용하여 IP변경 후 시도해주시면 됩니다)
+  - 문의처 :  02-577-8474 / [seoul@paymentwall.com](mailto:seoul@payementwall.com) / paymentwall 홈페이지 내 질의가능
+    - [페이먼트월 문의 페이지 보러가기↗](https://www.paymentwall.com/contacts)
+  - 결제 취소(환불) 수수료 적용 기준 : 페이먼트월에서는 카드결제 취소 시 취소 수수료가 발생되지는 않습니다.
+    - 매입 전(당일) 취소
+      - 매입 전(당일) 취소 기준: 결제 당일 오후 11시 59분까지만 적용 가능.(국내 매입사 시스템 적용 기준 반영)
+      - 매입 전(당일) 취소 시, 결제 수수료는 발생하지 않음. 이때 0.30USD도 발생하지 않음.
+    - 매입 후 취소
+      - 결제 당일 23시 59분 이후에는 환불로 프로세싱되며, 결제수수료 발생 및 환불에 시일 소요될 수 있습니다.
+      - (매입 후 취소 시)결제 수수료 발생(반환 불가) 및 취소가 아닌 환불로 진행 필요하여 시간이 걸릴 수 있음.
+      - X% + 0.30USD 반환 불가
+
+### **페이먼트월 사이트 구현 기준**
+
+<Callout title="페이먼트월 사이트 심사 가이드라인 보러가기↗" />
+
+1. 웹사이트 내 모든 메뉴가 정상적으로 작동하여야 하며, 메뉴를 클릭했을 때 상품이나 콘텐츠가 확인되어야 합니다.
+   리스트된 상품이 없는 메뉴 카테고리는 삭제를 권유 드립니다.
+2. 테스트 결제 가능한 상품이 하나 이상 업로드되어 있어야 합니다.(테스트 상품 무방)
+3. 웹사이트 하단에 법인 정보, 고객센터(CS)연락처, Terms of Services, Refund Policy, Privacy Policy, Shipping Policy가 모두 명시되어 있어야 합니다. (서비스 약관, 환불 정책, 개인 정보 보호 정책, 배송 정책)
+4. 페이먼트월은 보증보험이 없으며, RR (Rolling Reserve) 으로 운영되고 있습니다.
+
+<Callout content="**RR이란?**
+해외PG는 한국 결제사처럼 보증보험 신청이나 선보증금을 받고 있지 않으나, 실결제 건 별 5%의 금액을 Rolling Reserve(RR)이라고 하여 리스크 대비 비용으로 약 6개월(차지백 소송 가능 기간) 동안 키핑해두었다가 돌려드리는 구조의 보증금 방식을 사용하고 있습니다." title="참고사항" icon="💡" />
+
+<Callout title="페이먼트월 연동가이드 보러가기↗" />

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

@@ -0,0 +1,86 @@
+---
+title: 페이팔 해외결제 서비스 이용안내
+category: 결제서비스 (채널설정 및 이용안내) > 결제유형 > 해외결제
+seo:
+  title: 페이팔 해외결제 서비스 이용안내
+  description: >-
+    해외 각국의 결제수단을 다양하게 제공하는 페이팔 서비스 안내드립니다. 가입방법, 결제방식, 결제수단, 입점기준, 결제 수수료, 지원통화,
+    정산방법, 문의처, 연동가이드, 고위험 산업(STC) 연동까지 모두 확인해보세요.
+  keywords:
+    - 해외결제
+tags:
+  - 페이팔
+  - 해외결제
+pgCompanies:
+  - 페이팔
+searchTags:
+  - 페이팔 서비스
+  - 페이팔 정기결제
+  - 페이팔 일반결제
+  - 페이팔 해외결제
+  - 해외결제
+datetime: 2024-01-25T15:00:00.000Z
+---
+
+<Callout content="페이팔을 통한 해외결제 이용방법 안내드립니다." />
+
+#### **페이팔의 해외결제 서비스 이용안내**
+
+- 지원 결제방식 : 일반결제(Smart Payment Buttons) / 정기결제(Reference Transaction)
+- 결제수단 : 카드. 페이팔 머니
+- 지원통화 : 페이팔이 지원하는 화폐범위 결제가능
+  - [페이팔 지원 통화 보러가기↗](https://developer.paypal.com/docs/reports/reference/paypal-supported-currencies/)
+- 결제수수료 : 2.9%\~4.4% + $0.30 USD (수수료는 페이팔 내부정책에 따름)
+- 정산방법 : 페이팔 정산은 언제든지 계정의 잔고를 본인의 계좌로 직접 이체하여 출금하는 방법으로 이용할 수 있습니다.
+- 페이팔 국내 고객센터 : 02-3483-1131
+- 참고사항 : 페이팔은 판매자계정과 구매자계정의 국가가 모두 한국일 경우 결제실패가 발생됩니다. \
+  따라서, 국내 사업자로 설정되어있는 고객사일 경우 해외고객들을 대상으로한 결제만 이용하실 수 있습니다.  단, RT(정기결제)방식은 ‘국내 판매자’인 경우 ‘해외 구매자’만 이용 가능합니다.
+
+#### **페이팔 STC(고위험 산업) 연동 안내**
+
+페이팔 내부적으로 “고위험 산업”(게임과 같은 디지털 상품, 중고거래)의 경우에는 페이팔의 STC API를 통해 판매자 보호 정책을 적용하는 것을 페이팔에서 필수로 요구하고 있습니다.
+
+판매자 보호 정책에 관한 자세한 내용과 협의가 필요하시다면 페이팔 측에 직접 문의를 주셔야 하니 이용에 참고 부탁 드립니다. (’고위험 산업’이 아닌 경우에도 STC API를 연동하는 것을 권장하고 있습니다)
+
+고위험 산업 에 해당하는 산업군
+
+1. 이벤트/티켓 판매 산업
+
+2\. 연료 산업
+
+3\. 게임/디지털 상품 산업
+
+4\. 마켓플레이스 사업
+
+5\. 온라인 여행 산업(렌터카, 숙박, 여행 패키지, 교통)
+
+6\. P2P 산업
+
+7\. 소매, 식품 산업
+
+<Indent level="1">
+
+- ‘소매, 식품 산업’의 연동이 필요한 유형
+- 모바일 기기를 통해 매장 내 구매가 가능한 산업
+- ‘소매, 식품 산업’의 연동이 필요하지 않은 유형
+  - 타사 배송업체를 통해 주소로 실물 상품을 배송하는 산업
+  - 자체 배송 트럭을 통해 주소로 실물 상품을 배송하는 산업
+  - 소비자가 수령할 수 있도록 자체 매장에서 실물 상품을 배송하는 산업
+
+</Indent>
+
+8\. 택시, 공유 이동수단 사업
+
+9\. 통신사
+
+10\. 결제 시스템 보안 서비스 산업
+
+#### **페이팔 STC(고위험 산업) 연동 가이드**
+
+- [고위험 거래 상세 정보(산업군별 파라미터) 연동 가이드 보러가기↗](https://developers.portone.io/opi/ko/integration/pg/v1/spb/stc?v=v1)
+
+<Callout title="V2 페이팔 연동가이드 보러가기↗" />
+
+<Callout title="V1 페이팔(Smart Payment Button) 연동가이드 보러가기↗" />
+
+<Callout title="V1 페이팔(Referenct Transaction) 연동가이드 보러가기↗" />

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

@@ -0,0 +1,55 @@
+---
+title: 페이팔 결제상태 변경케이스 안내
+category: 결제서비스 (채널설정 및 이용안내) > 결제유형 > 해외결제
+tags:
+  - 페이팔
+  - 해외결제
+pgCompanies:
+  - 페이팔
+searchTags:
+  - Pending
+  - 페이팔 결제상태
+  - 페이팔
+  - 페이팔(Express Checkout)
+  - 페이팔(Smart Payment Button)
+  - 페이팔(Reference Transaction)
+datetime: 2024-01-25T15:00:00.000Z
+---
+
+<Callout content="페이팔의 경우 결제상태가 즉시 반영되지 않고 검토 후
+최종 결제완료로 결정되는 경우가 존재합니다. 이런 경우의 처리 프로세스를 안내드립니다." />
+
+### **발생 케이스**
+
+페이팔의 경우 구매자 / 판매자 보호정책에 의해 결제가 승인된 시점에는 Pending(보류) 상태로 처리한 다음, 페이팔 자체적으로 내부 검토 후 최종 paid(결제완료)되었다고 변경하는 케이스가 존재합니다.
+
+이는 **최초 승인 시점에는 해당 결제에 대해 review가 필요하다고 Paypal이 판단하여 결제실패로 포트원에 응답을 보내고 추후에 완료 처리하는 프로세스**로 보여지는데, 보통 **eCheck 결제수단 혹은 구매자의 Paypal 계정이 명확하지 않을 때 보통 Pending 상태**로 만들게 됩니다.
+
+### **대응 방법**
+
+1. 결제 시점에는 Paypal이 Pending상태의 거래건으로 응답\
+   (포트원에서는 이 거래건을 status : failed로 기록합니다 / 페이팔에 한함)
+2. (통상적으로 2\~3일 후) 해당 결제건에 대한 이슈가 해결되어 IPN으로 결제승인되었음을 Paypal -> 포트원으로 통지
+3. 포트원에서 거래건 status : paid 로 변경 후 거래건에 설정된 Webhook 발송
+
+<Callout content="포트원은 거래상태값을 정의할 때 한국 결제수단 위주로 진행되다보니 Paypal 이 추후 추가되었을 때
+해당되는 상태값이 없는 경우가 있어 pending 과 같은 상태를 failed 로 처리하고 있었습니다.
+이 부분에 대해서 Paypal Original 상태값을 별도로 조회하실 수 있도록 추가 메타정보를 제공드리고 있습니다." title="포트원에서는 페이팔의 pending을 failed로 처리합니다." icon="💡" />
+
+- 대상 : 포트원 거래상태 (status) 가 failed 인 거래건 중
+- 방법 : [https://api.iamport.kr/payments/`{imp_uid}`](https://developers.portone.io/api/rest-v1/payment#get%20%2Fpayments%2F%7Bimp_uid%7D)API 를 통한 조회 시 query string 으로 extension=true 옵션을 추가
+  - 예시 : [https://api.iamport.kr/payments/`{imp_uid}`?extension=true](https://developers.portone.io/api/rest-v1/payment#get%20%2Fpayments%2F%7Bimp_uid%7D)
+  - 응답 : 응답속성 내 extension 객체가 추가됨
+    - extension.PaymentStatus : Paypal 로부터 응답된 주문상태를 의미하는 값으로, Pending 이라는 값인지 체크. PaymentStatus 는 None, Canceled-Reversal, Completed, Denied, Expired, Failed, In-Progress, Partially-Refunded, Pending, Refunded, Reversed, Processed, Voided, Completed-Funds-Held 중 하나입니다.
+    - extension.PendingReason : Pending 거래건인 경우 그 사유에 대해 나타내는 코드입니다. none, address, authorization, echeck, intl, multi-currency, order, paymentreview, regulatoryreview, unilateral, verify, other 중 하나입니다.
+    - extension.ReasonCode : Pending 거래와는 관련이 없습니다만, 정산금 지급이 홀드된 경우 그 사유를 의미하는 코드입니다. none, chargeback, guarantee, buyer-complaint, refund, other 중 하나입니다.
+
+포트원에서 거래데이터를 조회할 수 있는 API 중 /payments/`{imp_uid}` 에만 현재 extension=true query string 옵션이 동작하므로 참고 부탁드립니다.
+
+<Callout title="V2 페이팔 연동가이드 보러가기↗" />
+
+<Callout title="V1 페이팔(Smart Payment Button) 연동가이드 보러가기↗" />
+
+<Callout title="V1 페이팔(Referenct Transaction) 연동가이드 보러가기↗" />
+
+<Callout title="페이팔(Express Checkout) 연동가이드 보러가기↗" />

package/assets/docs/help/core-service/payment-type/schedule-logic-guide.md

@@ -0,0 +1,49 @@
+---
+title: 정기결제 로직 구현 방법
+category: 결제서비스 (채널설정 및 이용안내) > 결제유형 > 정기결제
+seo:
+  title: 정기결제 로직 구현 방법
+  description: 최초 결제정보 저장 이후 재결재가 이뤄지는 정기결제 로직과 구현 방법을 확인해보세요.
+tags:
+  - 공통
+  - 정기결제
+  - V1
+pgCompanies:
+  - 공통
+searchTags:
+  - schedule API
+  - again API
+  - 예약결제
+  - 재결제
+  - 빌링키
+  - 정기결제로직
+  - 정기결제구현
+  - 정기결제
+datetime: 2024-01-25T15:00:00.000Z
+---
+
+<Callout content="최초에 결제정보를 저장(빌링키 발급)한 이후 재결제는 아래의 두 가지 방식으로 구현하실 수 있습니다.
+두 가지 방식 모두 매 결제시마다 포트원으로 재결제에 대한 API를 호출해 주셔야 합니다.
+" title="" />
+
+### **정기결제 로직 도식화**
+
+
+
+- 고객사에서 원하는 일자에 재결제를 요청하시는 방식 **(again API)**
+  [POST /subscribe/payments/again](https://developers.portone.io/api/rest-v1/nonAuthPayment#post%20%2Fsubscribe%2Fpayments%2Fagain)
+- 포트원에서 재결제(스케쥴러)를 요청하는 방식 **(schedule API)**
+  [POST /subscribe/payments/schedule](https://developers.portone.io/api/rest-v1/nonAuthPayment.subscribe#post%20%2Fsubscribe%2Fpayments%2Fschedule) \
+  재결제가 발생되는 로직은 고객사의 내부 정책에 맞게 직접 요청을 주셔야 합니다.
+
+<Callout content="" icon="" title="schedule API와 again API의 차이점 보러가기 ↗" />
+
+#### **결제와 취소는 모두 고객사의 요청으로 인하여 진행됩니다.**
+
+- 결제와 취소는 포트원에서 자체적으로 진행하지 않고 고객에서 포트원으로 요청된 건에 대하여 진행합니다.
+- 정기결제의 재결제 또한 마찬가지로 고객께서 포트원으로 결제 요청을 전달 주셔야 합니다.
+
+#### **정기결제는 정기적인 결제가 아닐 수도 있습니다.**
+
+- 정기결제는 결제정보를 고객사에서 저장하고 있다는 특징이 있습니다.
+- 고객사에서는 저장된 결제정보를 활용하여 원하는 때에 결제를 요청할 수 있습니다.

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

@@ -0,0 +1,111 @@
+---
+title: 정기결제의 인증 과정 필수 여부
+category: 결제서비스 (채널설정 및 이용안내) > 결제유형 > 정기결제
+seo:
+  title: 정기결제의 인증 과정 필수 여부
+  description: >-
+    PG사의 정기결제 서비스에 본인인증 및 공인인증 단계가 포함되어있는 경우를 안내해 드립니다. PG사 별로 본인인증을 요구하는 방법과
+    조건은 상이할 수 있습니다.
+  keywords:
+    - 정기결제
+tags:
+  - 정기결제
+pgCompanies:
+  - 나이스페이먼츠
+  - 다날
+  - 토스페이먼츠
+  - KICC
+  - NHN KCP
+  - KG이니시스
+searchTags:
+  - 비인증
+  - 공인인증
+  - 인증필수
+  - 정기결제 인증
+datetime: 2024-01-25T15:00:00.000Z
+---
+
+<Callout content="" title="정기결제는 빌링키를 발급받는 단계에서 아래 2가지로 분류됩니다." />
+
+### **빌링키 발급 방식에 따른 인증과정 구분**
+
+1. **PG사의 결제창을 띄우는 방식**
+
+<Indent level="1">
+
+- PG사의 결제창 안에서 '공인인증(본인인증)' 절차를 요구하게 됩니다
+
+</Indent>
+
+**2. API 호출 방식**
+
+<Indent level="1">
+
+- API 호출만으로 빌링키 발급이 가능하기 때문에 인증 절차가 없습니다.
+
+</Indent>
+
+<Callout title="정기결제 연동방식 보러가기 ↗" />
+
+### **결제대행사별 인증과정 포함 여부**
+
+- **KG이니시스**
+
+<Indent level="1">
+
+- PC환경에서는 공인인증을 필수로 요구하나, 모바일 환경에서는 생략됩니다.
+
+</Indent>
+
+- **KCP**
+
+<Indent level="1">
+
+- 공인인증 생략이 기본값이나, 내부 설정 및 입점 기준 등 PG사 정책에 따라 공인인증 과정이 포함될 수 있습니다.
+
+</Indent>
+
+- **KICC**
+
+<Indent level="1">
+
+- 정기결제 시 별도의 추가 인증 절차는 거치지 않고 있습니다.
+
+</Indent>
+
+- **다날**
+
+<Indent level="1">
+
+- 정기결제시 본인인증 절차를 생략하고자 하실 경우 다날측으로 요청하시어 설정하실 수 있습니다. \
+  신규계약시 다날측으로 본인인증이 생략되도록 소통해주시거나,\
+  이미 사용중이실 경우 아래 문의처를 통해 본인인증절차 생략을 문의해주시기 바랍니다!
+- 다날 문의처
+  - 1566-3355 (고객센터)
+  - 031-697-1280 (포트원 계약 담당부서)
+
+</Indent>
+
+- **토스페이먼츠**
+
+<Indent level="1">
+
+- 본인인증 절차를 생략하기 위해서는 토스페이먼츠 측을 통해 요청을 주셔야 하나, 토스페이먼츠 내부 심사를 통해 생략 가능 여부가 확정되오니 참고 부탁드립니다.
+
+</Indent>
+
+- **나이스페이먼츠 (신모듈)**
+
+<Indent level="1">
+
+- 결제창 방식은 PC/모바일 상관없이 빌링키 발급 시 본인인증 절차가 필수입니다.
+
+</Indent>
+
+- 한국결제네트웍스(KPN)
+
+<Indent level="1">
+
+- API 연동방식 진행 시  본인인증 절차는 별도로 진행 해주셔야 하오니 참고 부탁드립니다.
+
+</Indent>

package/assets/docs/help/core-service/payment-type/schedule-validity-guide.md

@@ -0,0 +1,68 @@
+---
+title: 정기결제 카드 유효성 검증 방법
+category: 결제서비스 (채널설정 및 이용안내) > 결제유형 > 정기결제
+seo:
+  title: 정기결제 카드 유효성 검증 방법
+  description: >-
+    정기결제 카드 유효성 검증 방법에 대해 안내드립니다. 존재하는 카드를 체크하는 방법, 카드의 결제 가능 여부, 카드번호가 15자리일
+    경우, 카드 실 소유주 체크방법 등을 포함하고 있습니다.
+  keywords:
+    - 정기결제
+tags:
+  - 공통
+  - 정기결제
+pgCompanies:
+  - 공통
+searchTags:
+  - 정기결제유효성
+  - 유효성검증
+  - 카드유효성
+  - 유효성
+datetime: 2024-01-25T15:00:00.000Z
+---
+
+<Callout content="PG사별/카드사별로 카드 유효성을 검증하는 기준이 모두 상이할 수 있습니다.
+(ex : 카드번호 + 유효기간만 확인, 카드번호 앞 6자리 + 유효기간만 확인 등)" title="" />
+
+### **존재하는 카드인지만 체크하는 방법**
+
+- 비인증 결제 <Highlight text="(POST /subscribe/custormers/{customer_uid})" /> 시도 시 카드 등록이 정상적으로 이뤄지면 유효성 체크가 된 것입니다.
+- 다만, 이 경우 등록하는 시점에 분실정지, 잔액부족 카드인 경우 결제 승인은 불가능한 상태이지만 \
+  카드번호+유효기간+생년월일+비밀번호(앞 2자리) 4가지 정보는 실제 존재하는 카드가 맞으므로 정상적으로 등록 처리가 되는 점을 참고해 주시기 바랍니다.
+
+### **존재하는 카드 & 현재 결제가 가능한 카드인지 체크하는 방법**
+
+- 결제 가능 체크를 위해서는 실제로 결제하여 카드사 응답을 받아 이용 가능한 카드 여부 체크가 가능합니다.
+- 등록 시점에 테스트 결제 1,000원을 해보고 곧바로 취소 성공하는 행위가 미래 시점에도 문제없이 결제가 될 것이라는 보장을 할 수는 없으나, 그 기능 자체만으로도 악성 사용자는 일부 필터링이 가능할 것으로 보입니다.
+
+### **카드번호가 15자리일 경우**
+
+- 고객 카드번호 등록 시 자릿수 제한 없이 포트원에서 정규화 과정을 거치므로 포맷과 무관하게 카드번호만 잘 전달되면 됩니다.
+
+<Indent level="1">
+
+- ex : 1234-1234-1234-123 또는 12341234.1234.123 등 모두 가능
+
+</Indent>
+
+### **카드 실 소유주 체크방법**
+
+- 정기결제 등록은 카드번호 + 유효기간 + 생년월일 + 비밀번호 2자리만 알면 되다 보니 타인의 카드를 등록하는 것이 기술적으로 가능합니다.
+- 따라서, 카드 실 소유주 즉 본인 카드로 만 제한하기 위해서는 본인인증 서비스와 연계하여 활용할 수 있습니다.
+  '휴대폰 본인인증’과 ‘통합 본인인증’ 서비스를 활용해 다음과 같이 처리해 주셔야 합니다.
+
+<Indent level="1">
+
+**\[처리방법]**
+
+1\. '휴대폰 본인인증’ 또는 ‘통합본인인증’ 먼저 진행
+
+2\. 본인인증 후 수신되는 결괏값 중 생년월일을 고객사 내부에 저장 (타사 서비스 이용 시에는 타사 서비스를 통한 본인인증 응답 값 활용)
+
+3\. 빌링키 등록을 위해 카드번호 + 유효기간 + 생년월일 + 비밀번호 2자리를 전달할 때 생년월일 값은 본인인증된 결값으로 고정하여 전달 (즉 사용자로부터 입력받지 않음)
+
+</Indent>
+
+<Callout content="1. 위 방법은 이론적으로는 생년월일까지 동일한(ex. 쌍둥이끼리) 타인의 카드를 등록할 수 있으나 매우 확률이 떨어지게 되므로 부정적인 사용의 관점에서의 기본적인 도용은 방지할 수 있습니다.
+
+2. 포트원에서 휴대폰 본인인증은 다날을 통하여, 통합 본인인증은 KG 이니시스를 통하여 이용하실 수 있습니다." title="참고사항" icon="💡" />