@nhnpayco-dev/mcp-devcenter 1.0.0

package/dist/data/guides/offline-authapi.meta.json

@@ -0,0 +1,81 @@
+{
+  "slug": "offline-authapi",
+  "id": null,
+  "url": "internal://offline-authapi",
+  "path": "/internal/offline/authapi",
+  "title": "PAYCO 오프라인 POS 인증승인형 연동 가이드",
+  "menu_text": "인증승인형 연동",
+  "sections": [
+    {
+      "label": "POS 인증 요청",
+      "path": "/internal/offline/authapi",
+      "id": "authapi-pos"
+    },
+    {
+      "label": "결제 인증 요청 API",
+      "path": "/internal/offline/authapi",
+      "id": "authapi-auth"
+    },
+    {
+      "label": "결제 승인 요청 API",
+      "path": "/internal/offline/authapi",
+      "id": "authapi-approval"
+    },
+    {
+      "label": "결제취소 요청 API",
+      "path": "/internal/offline/authapi",
+      "id": "authapi-cancel"
+    },
+    {
+      "label": "망취소 API",
+      "path": "/internal/offline/authapi",
+      "id": "authapi-netcancel"
+    }
+  ],
+  "h2_sections": [
+    "전문 가이드",
+    "Signature 생성규약 및 전달",
+    "POS 인증 요청",
+    "결제 인증 요청 API",
+    "결제 승인 요청 API",
+    "결제취소 요청 API",
+    "망취소 API",
+    "공통코드"
+  ],
+  "h3_sections": [
+    "사전 준비사항",
+    "전문 호출 URL",
+    "Data Format",
+    "Request",
+    "Response",
+    "결제유형",
+    "Signature 생성규약",
+    "Signature의 전달",
+    "RequestBody",
+    "ResponseBody",
+    "Examples",
+    "RequestBody",
+    "ResponseBody",
+    "카드사 OTC 암복호화 알고리즘",
+    "Example",
+    "RequestBody",
+    "ResponseBody",
+    "Example",
+    "RequestBody",
+    "ResponseBody",
+    "Example",
+    "RequestBody",
+    "ResponseBody",
+    "Example",
+    "VAN사 코드",
+    "결제수단 코드",
+    "결제수단별 승인사 코드",
+    "PG(KCP) 결제 신용카드 승인/매입사 매핑테이블",
+    "결과코드 및 에러정보"
+  ],
+  "table_count": 1559,
+  "code_block_count": 0,
+  "text_length": 100138,
+  "source_kind": "internal_docx",
+  "source_filename": "PAYCO_오프라인POS_인증승인형연동가이드_v1.0.1.0.docx"
+}

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

@@ -0,0 +1,33 @@
+# 검수하기
+
+> **원본:** https://devcenter.payco.com/guide/offline/check?id=220401026
+> **카테고리:** `offline-check`
+> **포함 단계 (LNB):**
+> - 검수하기 (`/guide/offline/check?id=220401026`)
+
+---
+
+## 검수하기 PAYCO 결제 완료 후 점검하기
+
+검수 전 단말기에 [PAYCO 버튼을 디자인 가이드](/design/guide?id=220401043)에 맞추어 적용하여 테스트를 진행해 주세요.
+
+검수절차는 기술검수, 방문검수, 현장검수로 진행됩니다.  
+ 자체 검수가 완료되면 검수를 요청해주세요!
+
+### 사전 체크리스트( Check list )
+
+Check list
+
+| 구분 | 항목 | 내용 |
+| --- | --- | --- |
+| 공통 | PAYCO 결제 버튼 노출 | 단말기의 결제수단에 PAYCO 결제 버튼이 정상적으로 노출 되어있나요? 디자인 가이드에 맞추어 적용 되었는지 확인해 주세요. |
+| 영수증 노출 요소 확인 | 영수증에 필요한 정보들이 알맞게 노출 되어 있나요? |
+| 결제 처리 | PAYCO로 승인요청 후 승인 결과가 정상 수신 되는지 확인해 주세요. |
+| 결제 실패 | 결제가 실패 되었다면 고객이 실패사유 인지할 수 있도록 실패사유를 노출해 주세요. |
+| 승인결과 미수신 시 | 승인결과를 PAYCO로 부터 응답 받지 못한 경우(통신장애, 타임아웃 등)에 결제취소(망취소) 처리 또는 실패 인지 처리 등 대응이 되어 있어야 합니다. |
+| 결제 성공 확인 | 주 결제수단 단독결제 또는 복합결제(주 결제수단+PAYCO쿠폰) 등 여러 승인 케이스를 테스트하여 이상유무를 확인해 주세요. |
+| 결제 취소 성공 확인 | 결제 성공과 마찬가지로 여러 승인 케이스에 대해 취소가 이상없이 되는지 확인해 주세요. |
+| VCAT 연동 | DLL 연결 확인 | 결제마다 DLL 연결, 해제를 반복하게 되면 결제 속도가 늦어 질 수 있습니다. 단말기 프로그램 시작, 종료시에 DLL연결, 해제를 해주세요. |
+| DLL 함수 사용 확인 | 단말기 구동 시에 NfcDailyRun 함수를 사용하셨나요? 결제 데이터 설정 함수(SetPaycoData) 사용 전 변수 초기화 함수(NfcInit)를 사용하셨나요? 윈도우 이벤트를 통한 예외처리가 되셨나요? NfcASyncRun 함수 호출 후 결제 종료 시에 NfcSendASyncEnd 함수가 호출 되었나요? |
+| API 연동 | signature 생성 확인 | Signature 생성하여 PAYCO 결제 승인/취소가 이상 없이 잘 동작하는지 확인해 주세요. |
+| POS 등록 API 호출 | 가맹점 및 단말기 정보가 변경될 경우를 대비하여 언제든 호출이 가능한가요? |

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

@@ -0,0 +1,24 @@
+{
+  "slug": "offline-check",
+  "id": "220401026",
+  "url": "https://devcenter.payco.com/guide/offline/check?id=220401026",
+  "path": "/guide/offline/check",
+  "title": "검수하기",
+  "menu_text": "검수하기",
+  "sections": [
+    {
+      "label": "검수하기",
+      "path": "/guide/offline/check",
+      "id": "220401026"
+    }
+  ],
+  "h2_sections": [
+    "검수하기 PAYCO 결제 완료 후 점검하기"
+  ],
+  "h3_sections": [
+    "사전 체크리스트( Check list )"
+  ],
+  "table_count": 1,
+  "code_block_count": 0,
+  "text_length": 1068
+}

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

@@ -0,0 +1,138 @@
+# 코드정리
+
+> **원본:** https://devcenter.payco.com/guide/offline/code/start?id=220401025
+> **카테고리:** `offline-code`
+> **포함 단계 (LNB):**
+> - 코드정리 (`/guide/offline/code/start?id=220401025`)
+
+---
+
+## 코드 정리
+
+PAYCO 오프라인 결제에서 전달되는 응답코드 및 응답 메세지를 확인해 보세요.
+
+1. #### VCAT 응답코드
+
+   VCAT 응답코드
+
+   | Error Code | Error Message |
+   | --- | --- |
+   | C0001 | PAYCO 소켓생성 오류발생! 다시 시작해주세요. |
+   | C0002 | PAYCO 인증서 로드실패! POS대리점에 문의하여 PAYCO를 재설치 하세요 |
+   | C0003 | 대리점에 문의해 주세요. PaycoNfcLib.dll 파일을 찾을 수 없습니다. |
+   | C0005 | PAYCO 결제 요청에 실패하였습니다 |
+   | C0501 | PAYCO 결제가 종료되었습니다 |
+   | C0502 | 서비스 타입을 확인할 수 없습니다. |
+   | C0504 | PAYCO 결제가 종료되었습니다. (망취소요청) |
+   | C0505 | 망취소를 요청할 수 없는 상태입니다. |
+   | C0506 | PAYCO 결제가 종료되었습니다. |
+   | C0507 | PAYCO 결제가 종료되었습니다 |
+   | C0508 | PAYCO 결제가 종료되었습니다 |
+   | C1001 | PAYCO 동글연결 실패! 동글을 뺏다 꼽아 주세요. 문제가 지속되는 경우 대리점에 문의하세요 |
+   | C1002 | 시스템 오류! POS를 재시작 하세요 |
+   | C1003 | PAYCO 동글이 연결 되지 않았습니다. 페이코 창을 닫고, 동글연결 유무를 확인후 재시도 하세요. 문제가 지속되는 경우 대리점에 문의하세요 |
+   | C1004 | 카드 종류를 확인해 주세요 |
+   | C1006 | 한장의 카드를 대주세요.\r\n여러장의 카드가 인식되었습니다. |
+   | C1010 | PAYCO앱 또는 네트워크에 오류가 발생 하였습니다. 잠시후 다시 시도하거나 대리점에 문의하세요 |
+   | C1011 | 네트워크 오류가 발생 하였습니다. 잠시후 다시 시도하거나 대리점에 문의하세요 |
+   | C1013 | PAYCO앱 또는 카드를 동글에 다시 대주세요 |
+   | C1016 | 결제할 금액이 없습니다. 결제할 금액을 확인하시고 다시 시도하세요 |
+   | C1017 | 사용가능한 서비스가 없습니다. |
+   | C1018 | PAYCO 서비스가 등록되지 않았습니다. 대리점에 문의하세요 |
+   | C1021 | PAYCO 동글이 연결되어 있지 않습니다.\r\n동글에 꽂힌 USB선을 뽑고 다시 꽂아 주세요. |
+   | C1023 | 바코드 번호가 입력되지 않았습니다. 다시 입력하세요 |
+   | C1024 | 바코드 번호가 올바르지 않습니다 |
+   | C1025 | 네트워크 오류가 발생 하였습니다. 잠시후 다시 시도하거나 대리점에 문의하세요 |
+   | C1027 | 한장의 카드를 대주세요.\r\n여러장의 카드가 인식되었습니다 |
+   | C1028 | 한장의 카드를 대주세요.\r\nBLE결제시 다른 카드가 인식되었습니다. |
+   | C1029 | 현재 상점에서는 아래 서비스만 거래 가능합니다.\r\n거래가능서비스 |
+   | C3001 | 카드를 다시 대주세요.\r\n결제가 완료 될때 까지 카드를 떼지 마세요 |
+   | C5001 | 결제 진행중 장애가 발생하였습니다.\r\n카드를 확인해 주십시오. |
+   | C5002 | 반품 처리 되지 않았습니다.\r\n처음부터 다시 진행해 주십시오. |
+   | C5003 | 사용 불가 카드입니다.\r\n한국스마트카드 고객센터(1644-0088)로 문의바랍니다 |
+   | C5004 | 비정상 카드입니다.\r\n한국스마트카드 고객센터(1644-0088)로 문의바랍니다 |
+   | C5005 | 사용 불가한 카드입니다 |
+   | C5006 | 카드잔액이 부족합니다.\r\n충전 후 결제해 주십시오. |
+   | C5007 | 결제 진행중 카드가 바뀌었습니다.\r\n카드를 확인해 주십시오. |
+   | C5008 | 결제에 사용한 카드가 아닙니다.\r\n카드 번호를 확인해 주십시오 |
+   | C5009 | 인증오류 : 담당자에게 확인해 주세요 |
+   | C5010 | 결제가 되지 않았습니다 |
+   | C5011 | 티머니 결제 처리 실패 |
+   | C5014 | 취소가 되었는지 확인 불가능 합니다.\r\n한국스마트카드 고객센터(1644-0088)로 문의바랍니다. |
+   | C5015 | 취소가 되지 않았습니다.\r\n다시 취소 바랍니다. |
+   | C5016 | 서버 또는 네트워크 확인이 필요 합니다.\r\n문제가 지속될 경우, 대리점에 문의해 주세요. |
+   | C5017 | 서비스가 불가능 합니다 |
+   | C5018 | 카드를 다시 대주세요 |
+   | C5019 | 티머니는 강제취소가 불가능합니다 |
+   | C9001 | PAYCO 결제 실패! 재시도 바랍니다.(vCAT 핸들 유실 |
+   | S1001 | 지원하지 않는 PG 정보 |
+   | S2001 | 인증 실패 |
+   | S2002 | Invalid Signature |
+   | S2003 | 허가되지 않은 POS단말 |
+   | S3001 | PG 승인실패 |
+   | S0400 | 요청 정보가 유효하지 않음 |
+   | S4001 | VAN 승인실패 |
+   | S0500 | Internal Server Error |
+2. #### API 응답코드
+
+   API 응답코드
+
+   | 응답코드 | 응답메세지 |
+   | --- | --- |
+   | 0 | 성공(기취소건 포함) |
+   | 400 | 요청 정보가 유효하지 않음 (상세메세지 확인) |
+   | 1001 | 지원하지 않는 PG정보 |
+   | 2001 | 인증 실패 (상세메세지 확인) |
+   | 2002 | Invalid Signature |
+   | 2003 | 허가되지 않은 POS단말 |
+   | 3001 | PG 승인실패 |
+   | 4001 | VAN 승인실패 |
+   | 500 | Internal Server Error |
+3. #### VAN사 코드
+
+   결제 승인 API 사용하기 - URI
+
+   | VAN사 | VAN사 코드 |
+   | --- | --- |
+   | ㈜ 한국사이버결제 | KCP |
+   | 한국정보통신주식회사 | KICC |
+   | 한국신용카드 결제㈜ | KOCES |
+   | 한국결제네트웍스 | FDIK |
+   | 나이스정보통신 주식회사 | NICE |
+   | ㈜케이에스넷 | KSNET |
+   | 금융결제원 | CMNKFTC, ORGKFTC |
+   | KIS정보통신 주식회사 | KIS |
+   | 주식회사 코밴 | KOVAN |
+   | 나이스페이먼츠 | JTNET |
+   | 주식회사 스마트로 | SMTR |
+   | 다우데이타 | DAU |
+   | 에스피씨 | SPC |
+   | 이니시스 | INICIS |
+4. #### 오프라인 결제수단 코드(paymentMethodCode)
+
+   결제수단 코드는 필요에 따라 추가될 수 있습니다.
+
+   코드 정의 - 오프라인 결제수단 코드
+
+   | 필드명 | 오프라인 결제수단코드 | 승인사명 | 승인사코드 |
+   | --- | --- | --- | --- |
+   | 신용카드 | 00 | [카드사 코드 참고](/guide/online/code/startCard?id=220401019) | [카드사 코드 참고](/guide/online/code/startCard?id=220401019) |
+   | PAYCO 포인트 | 10 | NHN | NHN |
+   | PAYCO 쿠폰 | 20 | NHN | NHN |
+   | PAYCO 기프트샵 | 20 | PAYCO 기프트샵 | PGIFT |
+   | PAYCO 비즈플러스(식권) | 20 | PAYCO비즈플러스 | PBIZ |
+
+   상세 결제수단 코드는 아래를 참고해주세요.
+
+   결제수단
+
+   | 오프라인 결제수단코드  (paymentMethodCode) | 상세결제수단코드  (sourcePaymentMethodCode) | 설명 |
+   | --- | --- | --- |
+   | 00 | 31, 37 | PAYCO 신용카드(31:PG / 37:VAN) |
+   | 10 | 98 | PAYCO 포인트 |
+   | 20 | 70 | PAYCO 바우처 쿠폰(식권 쿠폰) |
+   | 20 | 71 | PAYCO 기프트샵 |
+   | 20 | 75 | PAYCO 쿠폰 |
+   | 20 | 76 | 카드쿠폰 |
+   | 20 | 77 | 가맹점 쿠폰 |
+   | 20 | 78 | 상품 쿠폰 |

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

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

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

@@ -0,0 +1,34 @@
+# 소스코드 샘플
+
+> **원본:** https://devcenter.payco.com/guide/offline/sample?id=220401027
+> **카테고리:** `offline-sample`
+> **포함 단계 (LNB):**
+> - 소스코드 샘플 (`/guide/offline/sample?id=220401027`)
+
+---
+
+## 소스코드 샘플
+
+언어별로 오프라인 결제 소스코드 샘플을 확인할 수 있어요.
+
+1. #### VCAT 샘플 소스
+
+   사용하시는 언어에 맞게 샘플소스를 받아 개발에 참고해 보세요.
+
+   소스코드 샘플
+
+   |  |  |
+   | --- | --- |
+   | PowerBuilder | [Download](/download/downloadFile?fileNm=1645666556556.zip&fileRnm=PBSampleSource.zip) |
+   | C++ | [Download](/download/downloadFile?fileNm=1645666445629.zip&fileRnm=C++SampleSource.zip) |
+   | VisualBasic | [Download](/download/downloadFile?fileNm=1645666585468.zip&fileRnm=VBSampleSource.zip) |
+   | C# | [Download](/download/downloadFile?fileNm=1645666521990.zip&fileRnm=CShapSampleSource.zip) |
+2. #### VCAT 데모 프로그램
+
+   VCAT 결제를 테스트 해볼 수 있는 데모 프로그램입니다.
+
+   VCAT DLL 데모파일
+
+   |  |  |
+   | --- | --- |
+   | VCAT 데모 프로그램 | [Download](/download/downloadFile?fileNm=1702448412819.zip&fileRnm=vCAT 포스샘플.zip) |

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

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

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

@@ -0,0 +1,99 @@
+# 오프라인 결제
+
+> **원본:** https://devcenter.payco.com/guide/offline/start?id=220401022
+> **카테고리:** `offline-start`
+> **포함 단계 (LNB):**
+> - 오프라인 결제 (`/guide/offline/start?id=220401022`)
+
+---
+
+## 시작하기 연동절차 및 사전 준비사항 안내
+
+PAYCO 오프라인 결제 연동 절차와 연동 전 확인이 필요한 내용을 확인 해보세요.
+
+### 연동절차
+
+1. #### 연동 방식 검토
+
+   PAYCO 오프라인 결제서비스 연동에는 VCAT 프로그램 연동 방식, API 연동 방식이 존재합니다.  
+    각 서비스 상황에 맞게 필요한 방식으로 연동해 보세요.
+
+   #### ※ VCAT(Virtual CAT)이란?
+
+   - PAYCO 오프라인 결제를 쉽게 연동할 수 있는 윈도우 전용 데몬 프로그램입니다.
+   - 점주용 POS 모드 뿐만 아니라 고객용 KIOSK 모드까지 지원합니다.
+   - VCAT 프로그램이 PAYCO 서버와 통신을 하여 보다 편리하게 연동이 가능합니다.
+2. #### PAYCO 통신 방화벽 OPEN
+
+   API 연동 방식의 경우 중계 서버를 사용하신다면 해당 서버 IP에 대해 방화벽 오픈이 필요합니다.
+
+   - TLS 1.2 미만의 SSL/TLS 버전은 보안이 취약하여 지원하지 않습니다.
+   - 가맹점 서버의 클라이언트 환경이 TLS 1.2를 지원하는지 확인해주세요.  
+     
+
+   별도의 In/Out Bound 관리를 하신다면 아래 PAYCO 도메인을 방화벽에 등록해 주세요.
+
+   *443 포트를 사용합니다
+
+   PAYCO 통신 방화벽 OPEN
+
+   | 연동 방식 | 구분 | 도메인 |
+   | --- | --- | --- |
+   | API | 개발 환경 | alpha-dongle.payco.com |
+   | 운영 환경 | dongle.payco.com |
+   | VCAT | 개발 환경 | alpha-dongle.payco.com |
+   | dev-apis.krp.toastoven.net |
+   | 운영 환경 | dongle.payco.com |
+   | apis.krp.toastoven.net |
+   | 공통 환경 | cdn.kcp.co.kr |
+   | paycoscdn.toastoven.net |
+   | hook.dooray.com |
+   | api-logncrash.cloud.toast.com |
+3. #### 연동 & 검수하기
+
+   사전 준비사항을 확인하여 PAYCO 오프라인 결제 연동 개발을 진행하세요.  
+    연동 완료 후 검수하기를 통해 자체적으로 점검할 수 있어요.  
+    PAYCO 검수는 기술검수, 방문검수, 현장검수 순으로 진행됩니다.
+4. #### 가맹점 등록
+
+   서비스에 사용할 가맹점 정보 등록이 필요합니다.  
+    PAYCO 영업담당자 혹은 대리점을 통하여 등록 신청을 해주세요.
+5. #### 서비스 오픈
+
+   검수 및 가맹점 등록이 완료되었다면 PAYCO 오프라인 결제 서비스를 시작해 보세요.
+
+### 사전 준비사항
+
+1. #### PAYCO 결제 테스트 준비
+
+   [테스트하기](/support/test?id=220401042) 페이지를 참고하여 테스트에 필요한 APP, PAYCO 포인트, 쿠폰 등을 받아 보세요.
+2. #### 개발환경 가맹점 정보 확인
+
+   개발환경에서 사용할 수 있는 가맹점정보로 테스트를 진행해 보세요.  
+    * 개발환경 결제는 실결제가 이루어지지 않습니다.
+
+   앱 스킴 리스트
+
+   | 구분 | 사업자번호 | VAN POS ID |
+   | --- | --- | --- |
+   | VAN(KCP) | 1448115557 | 1002189853 |
+   | PG | 1448115549 | P1601103319 |
+3. #### PAYCO 결제 바코드(mOTC) 체계
+
+   mOTC는 고객 APP에 실제 노출되는 바코드 형태로, 카드사에서 발행한 OTC를 PAYCO 형식으로 변환한 값을 말합니다.
+
+   **잠깐만요!**
+
+   단말기에서 결제수단 별 결제 버튼이 아닌 통합 결제 버튼으로 결제를 진행하신다면 PAYCO 결제수단 구분이 필요합니다.  
+   PAYCO 결제 바코드 체계를 활용하여 구분해주세요.
+
+   ![PAYCO mOTC체계](/img/payco-motc.961ef06a.png)
+4. vCAT 연동 개발이 어려우신가요?
+
+   프로그램 설치만으로  
+   간편하게 연동하세요.
+
+   아직 페이코 가맹점이 아니신가요?
+
+   간편하게  
+   신청하세요.

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

@@ -0,0 +1,25 @@
+{
+  "slug": "offline-start",
+  "id": "220401022",
+  "url": "https://devcenter.payco.com/guide/offline/start?id=220401022",
+  "path": "/guide/offline/start",
+  "title": "오프라인 결제",
+  "menu_text": "오프라인 결제",
+  "sections": [
+    {
+      "label": "오프라인 결제",
+      "path": "/guide/offline/start",
+      "id": "220401022"
+    }
+  ],
+  "h2_sections": [
+    "시작하기 연동절차 및 사전 준비사항 안내"
+  ],
+  "h3_sections": [
+    "연동절차",
+    "사전 준비사항"
+  ],
+  "table_count": 2,
+  "code_block_count": 0,
+  "text_length": 1655
+}