@nhnpayco-dev/mcp-devcenter 1.0.0

package/dist/data/guides/online-start.md

@@ -0,0 +1,122 @@
+# 연동하기
+
+> **원본:** https://devcenter.payco.com/guide/online/start?id=220401001
+> **카테고리:** `online-start`
+> **포함 단계 (LNB):**
+> - 연동하기 (`/guide/online/start?id=220401001`)
+
+---
+
+## 시작하기 연동절차 및 API 공통규격 안내
+
+PAYCO 결제 연동 절차와 연동 전 확인이 필요한 내용을 확인 해보세요.
+
+### 연동절차
+
+1. #### PAYCO 통신 방화벽 OPEN
+
+   PAYCO 서비스와 연동하기 위해서는 가맹점 서버 IP에 대해 방화벽 오픈 요청을 하셔야 합니다.  
+    본격적인 연동을 위해 개발환경 먼저 방화벽 등록 요청을 해주세요.
+
+   * 1년간 거래가 없을 경우, PAYCO 방화벽에서 IP 가 삭제 처리될 수 있습니다.
+
+     
+
+   별도의 In/Out Bound 관리를 하신다면 아래 IP를 방화벽에 등록해주세요.
+
+   **가맹점이 허용해야 하는 inbound IP 목록(PAYCO->가맹점)**
+
+   가맹점이 허용해야 하는 inbound IP 목록(PAYCO->가맹점)
+
+   | 구분 | IP |
+   | --- | --- |
+   | 개발 환경 | 180.210.96.132, 180.210.96.133, 180.210.96.141 |
+   | 운영 환경 | 103.194.111.11, 180.210.96.134, 180.210.96.135, 180.210.96.136,  180.210.96.137, 180.210.96.142, 180.210.96.143 |
+
+   **가맹점이 허용해야 하는 outbound IP 목록(가맹점->PAYCO)**
+
+   *443 포트를 사용합니다
+
+   가맹점이 허용해야 하는 outbound IP 목록(가맹점->PAYCO)
+
+   | 구분 | 도메인 | IP |
+   | --- | --- | --- |
+   | 개발 환경 | alpha-api-bill.payco.com   alpha-bill.payco.com | 180.210.96.177 |
+   | 운영 환경 | api-bill.payco.com | 180.210.96.28 |
+   | 운영 환경 | bill.payco.com | 180.210.96.25 |
+   | 공통 | static-bill.nhnent.com | 103.194.111.72 |
+2. #### 연동 & 자체 검수하기
+
+   [결제 연동하기](/guide/online/easypay/reserve?id=220401002) 를 통해 PAYCO 서비스 연동을 해주세요.  
+    연동 완료 후 [검수하기](/guide/online/check?id=220401020)를 통해 자체적으로 점검 할 수 있어요.
+
+   **잠깐만요!**
+
+   IOS에서 유니버셜 링크 비활성화로 인해 PAYCO 앱 결제가 안될 수 있어요!  
+   앱 결제를 위해 가맹점 앱 내부에서 completionHandler 를 사용하거나 앱스킴 등록 후 canOpenURL 를 사용해주세요.  
+   자세한 내용은 'APP 결제 연동 주의사항' 을 확인해주세요.
+3. #### 가맹점 코드 발급 요청
+
+   실질적인 운영에 사용할 가맹점 코드 발급이 필요합니다.  
+    PAYCO 영업 담당자를 통한 코드 발급 또는 [파트너센터](https://partner.payco.com/)를 통해 가맹점 신청을 해주세요.
+
+   ※ 가맹점 정보는 가맹점코드(sellerKey), 상점ID(cpId), 상품ID(productId) 세트로 이루어집니다.
+
+   ![가맹점코드발급 요청](/img/@merchant_code.a5c43526.png)
+   - * 가맹점코드(sellerKey): PAYCO에서 발급받아 사용하는 가맹점 고유 코드
+   - * 상점ID(cpId): PAYCO에서 발급받은 상점ID 값
+   - * 상품ID(productid): PAYCO에서 발급받은 상품ID 값  
+       (sellerKey : cpId : productid = 1 : 1 : N 의 구조 가능)
+4. #### 서비스 오픈
+
+   가맹점 코드 발급이 완료 되었다면 적용 후 서비스를 시작하세요!
+
+### API 공통 규격
+
+1. #### PAYCO 도메인
+
+   - PAYCO API 호출 시 HTTPS 프로토콜(443 Port)을 사용해야 합니다.(HTTP 미제공)
+   - TLS 1.2 미만의 SSL/TLS 버전은 보안이 취약하여 지원하지 않습니다.
+   - 가맹점 서버의 HTTP 클라이언트 환경이 TLS 1.2를 지원하는지 확인해주세요.
+
+   PAYCO 도메인
+
+   |  |  |
+   | --- | --- |
+   | 개발환경 | https://alpha-api-bill.payco.com |
+   | 운영환경 | https://api-bill.payco.com |
+
+   ※  도메인 하위 주소는 각 API 상세 가이드 참조
+2. #### PAYCO 연동 API 공통 규약
+
+   - Content-type : application/json
+   - Method = POST
+
+   PAYCO 연동 API 공통 규약
+
+   |  |  |
+   | --- | --- |
+   | code | API 호출에 대한 처리 성공여부를 응답합니다. 응답 code = 0 이면 정상처리(Success),  code > 0 이면 오류 응답입니다. [상세 오류코드 확인하러 가기](/guide/online/code/start?id=220401019) |
+   | message | 성공 또는 실패에 대한 메시지를 포함합니다. |
+   | result | API별 응답 결과를 Json 형태로 결과를 반환합니다. 오류 응답시에는 포함되지 않습니다. 각 API에 따라 다양한 Type이 사용됩니다. |
+   | pgErrorCode | API 호출 실패 시 기관 오류 코드를 응답합니다. |
+
+   **성공건**
+
+   ```
+   {
+       "code": 0,
+       "message": "success",
+       "result": {
+       ...
+       }
+   }
+   ```실패건**
+
+   ```
+   {
+       "code": 4802,
+       "message": "[존재하지 않는 계좌입니다.]",
+       "pgErrorCode": "ST01"
+   }
+   ```

package/dist/data/guides/online-start.meta.json

@@ -0,0 +1,25 @@
+{
+  "slug": "online-start",
+  "id": "220401001",
+  "url": "https://devcenter.payco.com/guide/online/start?id=220401001",
+  "path": "/guide/online/start",
+  "title": "연동하기",
+  "menu_text": "연동하기",
+  "sections": [
+    {
+      "label": "연동하기",
+      "path": "/guide/online/start",
+      "id": "220401001"
+    }
+  ],
+  "h2_sections": [
+    "시작하기 연동절차 및 API 공통규격 안내"
+  ],
+  "h3_sections": [
+    "연동절차",
+    "API 공통 규격"
+  ],
+  "table_count": 4,
+  "code_block_count": 2,
+  "text_length": 2406
+}

package/dist/data/guides/order-check.md

@@ -0,0 +1,35 @@
+# 검수하기
+
+> **원본:** https://devcenter.payco.com/guide/order/check?id=220401031
+> **카테고리:** `order-check`
+> **포함 단계 (LNB):**
+> - 검수하기 (`/guide/order/check?id=220401031`)
+
+---
+
+## 검수하기 오더 연동 완료 후 점검하기
+
+사전 체크리스트를 통해 자체 검수를 진행해주세요.
+
+자체 검수가 완료되면 검수를 요청해주세요.  
+ 검수 절차는 기술검수, 방문검수, 현장검수 순으로 진행됩니다.
+
+### 사전 체크리스트( Check list )
+
+- ##### VORDER 연동
+
+  Check list
+
+  | 구분 | 항목 | 내용 |
+  | --- | --- | --- |
+  | 공통 | 영수증 노출 요소 확인 | 영수증에 필요한 정보들이 알맞게 노출되어 있나요? |
+  | 매출 처리 | 주문 수락 시 POS 단말기에 정상적으로 매출 등록이 되는지 확인해 주세요. |
+  | VORDER 연동 | DLL 함수 사용 확인 | 매장 등록을 완료하셨나요?  단말기 구동 시에 DailyRun 함수를 사용하셨나요?  수락/완료/취소 등 윈도우 이벤트 수신 시 SendData 함수를 통해 적합한 처리가 되시나요?  일시적인 POS 오류 발생 시 SendData 함수 처리가 되셨나요?  품절/품절해제도 잘 되시나요?  종료 시에 ProcessEnd 함수가 호출 되었나요? |
+- ##### 라이트 VORDER 연동
+
+  Check list
+
+  | 구분 | 항목 | 내용 |
+  | --- | --- | --- |
+  | 라이트 VORDER 연동 | DLL 함수 사용 확인 | 매출 연동 시 QueryInfo 함수를 사용하셨나요? 조회 조건에 맞춰 파라미터가 정상적으로 호출되고 있나요? |
+  | 매출연동 확인 | 조회 조건에 맞춰 매출이 정상적으로 저장되나요?  결제/할인 수단 별로 정상 집계가 되시나요?  수백건 이상의 대량 주문건수도 매출 연동에 문제가 없나요? |

package/dist/data/guides/order-check.meta.json

@@ -0,0 +1,24 @@
+{
+  "slug": "order-check",
+  "id": "220401031",
+  "url": "https://devcenter.payco.com/guide/order/check?id=220401031",
+  "path": "/guide/order/check",
+  "title": "검수하기",
+  "menu_text": "검수하기",
+  "sections": [
+    {
+      "label": "검수하기",
+      "path": "/guide/order/check",
+      "id": "220401031"
+    }
+  ],
+  "h2_sections": [
+    "검수하기 오더 연동 완료 후 점검하기"
+  ],
+  "h3_sections": [
+    "사전 체크리스트( Check list )"
+  ],
+  "table_count": 2,
+  "code_block_count": 0,
+  "text_length": 688
+}

package/dist/data/guides/order-code.md

@@ -0,0 +1,143 @@
+# 코드 정리
+
+> **원본:** https://devcenter.payco.com/guide/order/code/start?id=220401030
+> **카테고리:** `order-code`
+> **포함 단계 (LNB):**
+> - 코드 정리 (`/guide/order/code/start?id=220401030`)
+
+---
+
+## 코드정리
+
+PAYCO 오더에서 전달되는 에러코드를 확인해보세요.
+
+1. #### VORDER 응답코드
+
+   VORDER 응답코드 테이블
+
+   | 코드 | 설명 |
+   | --- | --- |
+   | -1004 | 실행 실패 |
+   | -1000 | 응답 실패 |
+   | 0 | 통신 실패 |
+2. #### 카드 및 은행사 코드 (agencyCd)
+
+   카드 및 은행사 코드 테이블
+
+   | 코드 | 기관 |
+   | --- | --- |
+   | CAMF | 해외롯데(아멕스)카드 |
+   | CCAM | 롯데아멕스카드 |
+   | CCBC | BC카드 |
+   | CCCH | 축협카드 |
+   | CCCJ | 제주은행 |
+   | CCCT | 씨티카드 |
+   | CCDI | 현대카드 |
+   | CCGD | 갤러리아백화점카드 |
+   | CCHD | 현대백화점카드 |
+   | CCHM | 한미카드 |
+   | CCHN | 하나SK카드 |
+   | CCJB | 전북카드 |
+   | CCKD | 산은캐피탈 |
+   | CCWR | 우리독자카드 |
+3. #### 서비스 타입 (serviceType)
+
+   서비스 타입 설명 테이블
+
+   | 코드 | 설명 |
+   | --- | --- |
+   | PICKUP | 포장(픽업) |
+   | RESERVE | 예약 |
+   | DELIVERY | 배달 |
+4. #### 서비스 사용 채널 (channelType)
+
+   서비스 사용 채널 설명 테이블
+
+   | 코드 | 설명 |
+   | --- | --- |
+   | ORDER_PICK | 스마트오더 |
+   | PAYCO | 페이코 |
+   | GYEONGGI | 배달특급 |
+
+   ※ channelType은 오더 클라우드를 사용하는 제휴사의 경우 해당 제휴사에 매핑 된 코드가 따로 응답됩니다.
+5. #### 유입 경로 (sourceType)
+
+   유입 경로 코드설명 테이블
+
+   | 코드 | 설명 |
+   | --- | --- |
+   | PAYCO_APP | 페이코 |
+   | GYEONGGI_APP | 배달특급 |
+   | QR | QR주문 |
+
+   ※ sourceType은 오더 클라우드를 사용하는 제휴사의 경우 해당 제휴사에 매핑 된 코드가 따로 응답됩니다.
+6. #### 주문 상태 (status)
+
+   주문 상태 코드설명 테이블
+
+   | 코드 | 설명 |
+   | --- | --- |
+   | REQUESTED | 주문요청 |
+   | ACCEPTED | 주문승인 |
+   | COMPLETED | 주문완료 |
+   | REJECTED | 주문거절 |
+   | CANCELED | 주문취소 |
+7. #### 결제수단 (payments[].payType)
+
+   결제수단 코드설명 테이블
+
+   | 코드 | 설명 |
+   | --- | --- |
+   | 01 | 신용카드(일반) |
+   | 05 | 휴대폰(일반) |
+   | 19 | 지역화폐(코나아이) |
+   | 22 | 지역화폐(조폐공사) |
+   | 23 | G드림카드 |
+   | 25 | 삼성페이 |
+   | 26 | 네이버페이 |
+   | 27 | 카카오페이 |
+   | 31 | 신용카드(PG) |
+   | 37 | 신용카드(VAN) |
+   | 42 | 만나서결제(신용카드) |
+   | 43 | 만나서결제(현금) |
+   | 51 | 신용카드(1초 결제) |
+   | 70 | PAYCO 바우처쿠폰(식권 쿠폰) |
+   | 75 | PAYCO 쿠폰 |
+   | 76 | 카드 쿠폰 |
+   | 77 | 가맹점 쿠폰 |
+   | 78 | 상품 쿠폰 |
+   | 98 | PAYCO 포인트 |
+8. #### 할인 정보 타입 (discount[].Type)
+
+   할인 정보 타입 코드설명 테이블
+
+   | 코드 | 설명 |
+   | --- | --- |
+   | COUPON | 쿠폰 |
+   | POINT | 포인트 |
+   | OK_CASH | OK캐시백 |
+   | MEMBERSHIP_COUPON | 멤버십 쿠폰 |
+   | MEMBERSHIP_POINT | 멤버십 포인트 |
+   | GIFT_CARD | 멤버십 충전금 |
+   | VOUCHER | E 상품권 |
+   | CUP | 개인 컵 할인 |
+   | TAKEOUT | 포장 할인 |
+9. #### 간편결제 타입 (quickPayType)
+
+   간편결제 타입 코드설명 테이블
+
+   | 코드 | 설명 |
+   | --- | --- |
+   | OT01 | 삼성페이 |
+   | OT03 | SSG페이 |
+   | OT12 | 페이코 |
+10. #### 후불 결제방식 (deferPayType)
+
+    후불 결제방식 코드설명 테이블
+
+    | 코드 | 설명 |
+    | --- | --- |
+    | CREDIT | 신용/체크카드 |
+    | MOBILE | 휴대폰 |
+    | CASH | 현금결제 |
+    | ETICKET | E-상품권 |

package/dist/data/guides/order-code.meta.json

@@ -0,0 +1,22 @@
+{
+  "slug": "order-code",
+  "id": "220401030",
+  "url": "https://devcenter.payco.com/guide/order/code/start?id=220401030",
+  "path": "/guide/order/code/start",
+  "title": "코드 정리",
+  "menu_text": "코드 정리",
+  "sections": [
+    {
+      "label": "코드 정리",
+      "path": "/guide/order/code/start",
+      "id": "220401030"
+    }
+  ],
+  "h2_sections": [
+    "코드정리"
+  ],
+  "h3_sections": [],
+  "table_count": 10,
+  "code_block_count": 0,
+  "text_length": 1433
+}

package/dist/data/guides/order-sample.md

@@ -0,0 +1,31 @@
+# 소스코드 샘플
+
+> **원본:** https://devcenter.payco.com/guide/order/sample?id=220401032
+> **카테고리:** `order-sample`
+> **포함 단계 (LNB):**
+> - 소스코드 샘플 (`/guide/order/sample?id=220401032`)
+
+---
+
+## 소스코드 샘플
+
+오더 소스코드 샘플을 확인할 수 있어요.
+
+1. #### VORDER DLL 샘플
+
+   사용하시는 언어에 맞게 샘플소스를 받아 개발에 참고해 보세요.
+
+   소스코드 샘플
+
+   |  |  |
+   | --- | --- |
+   | VORDER 샘플 | [Download](/download/downloadFile?fileNm=1648627750235.zip&fileRnm=vOrder_Sample_VB_NET_2017_20191107.zip) |
+2. #### VORDER DLL 데모 프로그램
+
+   오더 테스트를 해볼 수 있는 데모 프로그램입니다.
+
+   소스코드 샘플
+
+   |  |  |
+   | --- | --- |
+   | VORDER 데모 프로그램 | [Download](/download/downloadFile?fileNm=1648627801705.zip&fileRnm=Payco_SmartOrder.zip) |

package/dist/data/guides/order-sample.meta.json

@@ -0,0 +1,22 @@
+{
+  "slug": "order-sample",
+  "id": "220401032",
+  "url": "https://devcenter.payco.com/guide/order/sample?id=220401032",
+  "path": "/guide/order/sample",
+  "title": "소스코드 샘플",
+  "menu_text": "소스코드 샘플",
+  "sections": [
+    {
+      "label": "소스코드 샘플",
+      "path": "/guide/order/sample",
+      "id": "220401032"
+    }
+  ],
+  "h2_sections": [
+    "소스코드 샘플"
+  ],
+  "h3_sections": [],
+  "table_count": 2,
+  "code_block_count": 0,
+  "text_length": 189
+}

package/dist/data/guides/order-start.md

@@ -0,0 +1,94 @@
+# 오더 클라우드
+
+> **원본:** https://devcenter.payco.com/guide/order/start?id=220401028
+> **카테고리:** `order-start`
+> **포함 단계 (LNB):**
+> - 오더 클라우드 (`/guide/order/start?id=220401028`)
+
+---
+
+## 시작하기 연동절차 및 사전 준비사항 안내
+
+PAYCO 오더 연동 절차와 연동 전 확인이 필요한 내용을 확인 해보세요.
+
+### 연동절차
+
+1. #### 연동 방식 검토
+
+   PAYCO 오더 연동에는 VORDER 프로그램 연동 방식, API 연동 방식이 존재합니다.  
+    VORDER 프로그램 연동 방식은 풀 버전 연동과 라이트 연동 2가지가 존재하니,  
+    각 서비스 상황에 맞게 필요한 방식으로 연동해 보세요. (API 연동 방식은 조금만 기다려주세요.)
+
+   #### ※ VORDER(Virtual Order) 이란?
+
+   - PAYCO 오더를 쉽게 연동할 수 있는 윈도우 전용 데몬 프로그램입니다.
+   - 주문 수락, 완료, 메뉴 품절, 서비스 임시중지 등 가능하며 포장, 배달 모두 지원합니다.
+   - 사용하시는 배달 대행사 그대로 사용하실 수 있어요.
+   - VORDER 프로그램이 PAYCO 서버와 통신을 하여 보다 편리하게 연동이 가능합니다.
+
+   #### ※ 라이트 VORDER 연동 방식은?
+
+   - 특별한 연동과정 없이 PAYCO에서 제공하는 프로그램을 통해 스마트오더를 독립적으로 설치 및 사용 하실 수 있습니다.
+   - 추가로 오더 매출을 저장하고 싶은 경우 추가 연동을 통해 매출을 조회할 수 있습니다.
+2. #### 연동 & 검수하기
+
+   사전 준비사항을 확인하여 PAYCO 오더 연동 개발을 진행하세요.  
+    연동 완료 후 검수하기를 통해 자체적으로 점검할 수 있어요.  
+    PAYCO 검수는 기술검수, 방문검수, 현장검수 순으로 진행됩니다.
+3. #### 가맹점 및 메뉴 등록
+
+   서비스에 사용할 가맹점 및 메뉴 정보 등록이 필요합니다.  
+    PAYCO 영업담당자 혹은 대리점을 통하여 등록 신청을 해주세요.
+4. #### 서비스 오픈
+
+   검수 및 가맹점 등록이 완료되었다면 PAYCO 오더 서비스를 시작해 보세요.
+
+### 사전 준비사항
+
+1. #### PAYCO 결제 테스트 준비
+
+   [테스트하기](/support/test?id=220401042) 페이지를 참고하여 테스트에 필요한 APP, PAYCO 포인트, 쿠폰 등을 받아 보세요..
+2. #### 스마트오더 설치 (라이트 VORDER 연동 방식만 필요합니다)
+
+   아래 다운로드 버튼을 눌러 PayCoOrderSetup.exe 파일을 설치해주세요.  
+    테스트 가맹점 정보로 로그인 후 [여기](https://devcenter.payco.com/guide/print) 참고하여 프린터 설정을 진행해주세요.
+3. #### 개발환경 가맹점 및 메뉴 정보 확인
+
+   개발환경에서 사용할 수 있는 가맹점 정보로 테스트를 진행해 보세요.  
+    포장(픽업), 배달, 예약 각각의 메뉴판 URL을 통해 등록된 샘플 메뉴를 확인하실 수 있습니다.  
+    * 개발환경 결제는 실결제가 이루어지지 않습니다.
+
+   개발환경 가맹점 정보
+
+   | 사업자 번호 | POS ID | ShopId |
+   | --- | --- | --- |
+   | 1208655894 | 1842 | S200001842 |
+
+   - 링크 주소
+
+     | 페이코 오더 | 배달특급 |
+     | --- | --- |
+     | 페이코 오더 QR | 배달특급 QR |
+     | <https://test-menu.payco.kr/view/payco/shop?shopId=S200001842> | <https://test-menu.payco.kr/view/kyg/shop?shopId=S200001842> |
+4. #### 상점관리자 정보 확인
+
+   개발환경에서 테스트하신 내역을 상점관리자에서 확인하실 수 있어요.  
+    상점관리자 매뉴얼은 [여기](https://paycoscdn.toastoven.net/payco/offline/order/devceneter/상점관리자_매뉴얼.pdf)를 참고해주세요.
+
+   상점관리자 정보
+
+   | URL | ID / PW |
+   | --- | --- |
+   | <https://test-partner.payco.kr/> | paycoDevelop / payco1234!@#$ |
+5. VORDER 연동 개발이 어려우신가요?
+
+   프로그램 설치만으로  
+   간편하게 연동하세요.
+
+   프로그램 설치만으로  
+   멤버십까지 함께 연동하세요.
+
+   오더에 대해서 궁금하신가요?
+
+   오더의 모든 것을  
+   확인하세요.

package/dist/data/guides/order-start.meta.json

@@ -0,0 +1,25 @@
+{
+  "slug": "order-start",
+  "id": "220401028",
+  "url": "https://devcenter.payco.com/guide/order/start?id=220401028",
+  "path": "/guide/order/start",
+  "title": "오더 클라우드",
+  "menu_text": "오더 클라우드",
+  "sections": [
+    {
+      "label": "오더 클라우드",
+      "path": "/guide/order/start",
+      "id": "220401028"
+    }
+  ],
+  "h2_sections": [
+    "시작하기 연동절차 및 사전 준비사항 안내"
+  ],
+  "h3_sections": [
+    "연동절차",
+    "사전 준비사항"
+  ],
+  "table_count": 3,
+  "code_block_count": 0,
+  "text_length": 1724
+}