@nhnpayco-dev/mcp-devcenter 1.0.0

package/dist/data/guides/calculate.md

@@ -0,0 +1,164 @@
+# 결제/정산 대사
+
+> **원본:** https://devcenter.payco.com/guide/calculate?id=220401040
+> **카테고리:** `calculate`
+> **포함 단계 (LNB):**
+> - 결제/정산 대사 (`/guide/calculate?id=220401040`)
+
+---
+
+## PAYCO 결제/정산대사 연동
+
+결제/정산대사 확인을 위한 파트너센터부터 API 연동 상세를 안내합니다.
+
+1. #### 정산대사 API로 PAYCO 거래/정산 내역 확인하기
+
+   정산대사 API를 통하여 PAYCO 결제에 대한 결제 및 정산 상세내역을 확인할 수 있습니다.  
+   API 호출 외 ‘PAYCO 파트너센터’에서도 간편하게 확인이 가능합니다.  
+   [PAYCO 파트너센터 바로가기](https://alpha-partner.payco.com)
+2. #### 정산대사 API 호출을 위한 사전 준비사항 확인하기
+
+   **▼ 방화벽 설정 방법 확인**
+
+   ※ 파트너센터 > 매출내역 > 대사파일다운로드 메뉴 하단의 ‘대사정보 조회 API 설정/보기’ 에서 IP 방화벽 설정이 가능합니다.
+
+   ![데모 파트너센터 방화벽 설정](/img/@calculate1.623293ed.png)
+
+     
+
+   **▼ API 호출을 위한 접속토큰(Token) 확인**
+
+   ![데모 파트너센터 방화벽 설정](/img/@calculate2.05d8c72c.png)
+3. #### 정산대사 API 상세내용 확인하기
+
+   **▼ API 호출 URL**
+
+   PAYCO 통신 방화벽 OPEN
+
+   | 환경구분 | URL |
+   | --- | --- |
+   | 개발환경 | https://alpha-api-partner-bill.payco.com/pgTradeCheck/download/pay |
+   | 운영환경 | https://api-partner-bill.payco.com/pgTradeCheck/download/pay |
+
+   **▼ 요청(Request) 상세**
+
+   * Method: **GET**, POST
+
+   요청(Request) 상세
+
+   | 파라미터 | 설명 |
+   | --- | --- |
+   | serviceCode(필수 / string) | 전달받을 데이터 타입 입니다.  - PAY_D: 일 결제 내역  - ST_PAY_D: 일 정산 내역 (지급일)  - SB_PAY_D: 일 정산 내역 (정산기준일) |
+   | mrcCode(필수 / string) | 가맹점 코드(sellerKey) 입니다. |
+   | ymd(필수 / string) | 날짜 (데이터 형식: YYYYMMDD) *월 데이터인 경우 날짜는 01로 입력 - ex) 20220201 |
+   | token(필수 / string) | “파트너센터 > 대사정보 조회 API 설정/보기” 페이지에 명시된 접속토큰값 |
+   | version(필수 / string) | API 버전 - ex)1.1 |
+
+   **Request 예시(GET 방식)**
+
+   ```
+   GET https://alpha-api-partner-bill.payco.com/pgTradeCheck/download/pay?serviceCode=PAY_D&mrcCode=S0FSJE&ymd=20150915&token=S0FSJE-10B9FFD-4797A&version=1.0 HTTP/1.1
+   Host: dev-apis.krp.toastoven.net
+   Connection: keep-alive
+   User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/45.0.2454.93 Safari/537.36
+   Accept: */*
+   Accept-Encoding: gzip, deflate, sdch
+   Accept-Language: ko-KR,ko;q=0.8,en-US;q=0.6,en;q=0.4
+   ```▼ 응답(Response) 상세**
+
+   * 응답 결과코드와 메시지는 Header로 전달됩니다.
+
+   응답(Response) 상세
+
+   | Header Name | 설명 |
+   | --- | --- |
+   | PAYCO_PgTrade_Code | 결과 코드 (성공 / 그 외: 실패(에러코드 정의 참고) |
+   | PAYCO_PgTrade_Message | 결과 메시지 (SUCCESS: 성공 / 그 외: 실패 (에러코드 정의 참고) |
+   | Content-Type | text/plain;charset=UTF-8 |
+
+   ▼ 에러코드 정의
+
+   에러코드 정의
+
+   | 결과코드 | 결과 메시지 | 설명 |
+   | --- | --- | --- |
+   | 0 | SUCCESS | 성공 |
+   | -1 | FAIL | 실패 (시스템에러) |
+   | -2 | PARAMETER_ERROR | 파라미터 에러 – 파라미터 중 잘못된 값 존재 |
+   | 101 | AUTH_INVALID_USER_ERROR | 허용되지 않은 사용자 – ACL 확인 필요 |
+   | 109 | AUTH_INVALID_ACCESSTOKEN | 유효하지 않은 토큰으로 요청 시 발생 |
+   | 1101 | DATA_NOT_EXIST | 데이터 없음 |
+
+     
+
+   **▼ 서비스별 응답(Response) 상세**
+
+   호출 시 입력된 serviceCode에 따라 결과가 달라지며,  
+    가장 많이 사용되는 결제 일대사(PAY_D)와 정정산기준일 정산대사(SB_PAY_D) 응답을 예시로 안내 드립니다.  
+   *응답결과는 CSV 포맷으로 제공되며, 각 Column의 구분자는 탭(Tab)으로 구분됩니다.
+
+   ▼ 결제 일대사(PAY_D)
+
+   결제 일대사(PAY_D)
+
+   | No. | Header Name | 설명 |
+   | --- | --- | --- |
+   | 1 | PAYCO 승인/취소 일시 | yyyyMMddHHmmss 형식 |
+   | 2 | PAYCO 주문번호 | PAYCO 주문번호 |
+   | 3 | 가맹점주문번호 | 가맹점에서 관리하는 주문번호(sellerOrderReferenceKey) |
+   | 4 | PAYCO 결제번호 | PAYCO 결제번호 |
+   | 5 | 원거래 PAYCO 결제번호 | 원거래 PAYCO 결제번호 |
+   | 6 | 거래 금액 | 거래 금액 |
+   | 7 | 결제타입코드 | 승인: PRTAPP / 취소: PRTWCNCL |
+   | 8 | 결제타입 | 승인/취소 |
+   | 9 | 결제수단코드 | 결제수단코드 정보 [확인하기](/support/commonCode/online?id=220401036) |
+   | 10 | 결제수단명 | 결제수단코드에 매칭되는 결제수단명 |
+   | 11 | 주문상품명 | 주문상품명 |
+   | 12 | 주문인증키 | 주문인증키(orderCertifyKey) |
+
+   **결제 일대사(PAY_D) 결과 예시**
+
+   ```
+   PAYCO 승인/취소 일시   PAYCO 주문번호   가맹점주문번호   PAYCO 결제번호   원거래 PAYCO 결제번호   거래금액   결제타입코드   결제타입   결제수단코드   결제수단명   주문상품명   주문인증키
+   20211201013317   202112012002667003   imp_076969438712   202112012004259382      1000   PRTAPP   승인   75   페이코 쿠폰   545344 [선불+묶음] 유료2500 지역5000 반품3500...   3Ee1MZ6M1JwRg367bVXdvO2DDqIpBBl7DufN9OAa6krMCC
+   20211201013317   202112012002667003   imp_076969438712   202112012004259383      1500   PRTAPP   승인   98   PAYCO 포인트   545344 [선불+묶음] 유료2500 지역5000 반품3500...   3Ee1MZ6M1JwRg367bVXdvO2DDqIpBBl7DufN9OAa6krMCC
+   20211201013450   202112012002667004   imp_057028866698   202112012004259387      1000   PRTAPP   승인   75   페이코 쿠폰   545344 [선불+묶음] 유료2500 지역5000 반품3500...   3aUeGBBW3IRPIlbZAAqBaixvBxYzRxBBqzFN60t05oW7hsCC
+   20211201013450   202112012002667004   imp_057028866698   202112012004259388      8500   PRTAPP   승인   98   PAYCO 포인트   545344 [선불+묶음] 유료2500 지역5000 반품3500...   3aUeGBBW3IRPIlbZAAqBaixvBxYzRxBBqzFN60t05oW7hsCC
+   ```▼ 정산기준일 정산대사(SB_PAY_D)
+
+   정산기준일 정산대사(SB_PAY_D)
+
+   | No. | Header Name | 설명 |
+   | --- | --- | --- |
+   | 1 | 지급일자 | yyyyMMdd 형식 |
+   | 2 | PAYCO 승인/취소 일시 | yyyyMMddHHmmss 형식 |
+   | 3 | PAYCO 구매확정일자 | yyyyMMdd 형식 |
+   | 4 | PAYCO 정산기준일자 | yyyyMMdd 형식 |
+   | 5 | 결제수단코드 | 결제수단코드 전체 항목 정보는 ‘PAYCO 연동가이드’ 문서를 참고 |
+   | 6 | 결제수단명 | 결제수단코드에 매칭되는 결제수단명 |
+   | 7 | 에스크로여부 | Y/N |
+   | 8 | 결제수단승인코드 | CCSS, CCBC 등 |
+   | 9 | 승인사명 | 삼성카드, BC카드 등 |
+   | 10 | 결제수단승인번호 | 결제수단별 승인번호 |
+   | 11 | PAYCO 주문번호 | PAYCO 주문번호 |
+   | 12 | 가맹점주문번호 | 가맹점에서 관리하는 주문번호(sellerOrderReferenceKey) |
+   | 13 | PAYCO 결제번호 | PAYCO 결제번호 |
+   | 14 | 원거래 PAYCO 결제번호 | 원거래 PAYCO 결제번호 |
+   | 15 | 결제타입 | 결제의 처리상태(승인/취소) |
+   | 16 | 취소타입 | 승인/전체취소/부분취소 |
+   | 17 | 거래금액 | - |
+   | 18 | 결제수수료 | - |
+   | 19 | 무이자할부수수료 | 무이자 할부 행사 진행 시 수수료(가맹점 부담) |
+   | 20 | 카드포인트수수료 | 카드사 포인트 이용 결제 시 수수료(가맹점 부담) |
+   | 21 | 수수료부가세 | - |
+   | 22 | 정산금액 | - |
+   | 23 | 주문상품명 | 주문상품명 |
+
+   **정산기준일 정산대사(SB_PAY_D) 결과 예시**
+
+   ```
+   지급일자   PAYCO 승인/취소 일시   PAYCO 구매확정일자   PAYCO 정산기준일자   결제수단코드   결제수단명   에스크로여부   결제수단승인코드   승인사명   결제수단승인번호   PAYCO 주문번호   가맹점주문번호   PAYCO 결제번호   원거래 PAYCO 결제번호   결제타입   취소타입   거래금액   결제수수료   무이자할부수수료   카드포인트수수료   수수료부가세   정산금액   주문상품명
+   20211206   20211201013317      20211201   75   페이코 쿠폰   N         400062085   202112012002667003   imp_076969438712   202112012004259382      승인   승인   1000.00000   26.00000         3.00000   971.00000   545344 [선불+묶음] 유료2500 지역5000 반품3500...
+   20211206   20211201013317      20211201   98   PAYCO포인트   N         2021120123656631   202112012002667003   imp_076969438712   202112012004259383      승인   승인   1500.00000   39.00000         4.00000   0.00000   545344 [선불+묶음] 유료2500 지역5000 반품3500...
+   20211206   20211201013450      20211201   75   페이코 쿠폰   N         400062095   202112012002667004   imp_057028866698   202112012004259387      승인   승인   1000.00000   26.00000         3.00000   971.00000   545344 [선불+묶음] 유료2500 지역5000 반품3500...
+   ```

package/dist/data/guides/calculate.meta.json

@@ -0,0 +1,22 @@
+{
+  "slug": "calculate",
+  "id": "220401040",
+  "url": "https://devcenter.payco.com/guide/calculate?id=220401040",
+  "path": "/guide/calculate",
+  "title": "결제/정산 대사",
+  "menu_text": "결제/정산 대사",
+  "sections": [
+    {
+      "label": "결제/정산 대사",
+      "path": "/guide/calculate",
+      "id": "220401040"
+    }
+  ],
+  "h2_sections": [
+    "PAYCO 결제/정산대사 연동"
+  ],
+  "h3_sections": [],
+  "table_count": 6,
+  "code_block_count": 3,
+  "text_length": 5255
+}