@nhnpayco-dev/mcp-devcenter 1.0.0

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

@@ -0,0 +1,743 @@
+# API 연동하기
+
+> **원본:** https://devcenter.payco.com/guide/offline/api/flow?id=2204010241
+> **카테고리:** `offline-api`
+> **포함 단계 (LNB):**
+> - ③ 결제 승인 (`/guide/offline/api/approval?id=2204010244`)
+> - ④ 결제 취소 (`/guide/offline/api/cancel?id=2204010245`)
+> - ① API 공통 규약 (`/guide/offline/api/common?id=2204010242`)
+> - API 연동하기 (`/guide/offline/api/flow?id=2204010241`)
+> - ⑤ 결제 망취소 (`/guide/offline/api/netCancel?id=2204010246`)
+> - ② POS 등록 (`/guide/offline/api/pos?id=2204010243`)
+
+---
+
+## API 연동하기
+
+API 방식의 결제 연동 상세 내용을 안내합니다.
+
+### 연동 프로세스 이해하기
+
+![연동 프로세스 이해하기 이미지](/img/@offline_api_flow.dbf13038.png)
+
+  
+  
+
+1. #### PAYCO 연동 API 공통 규약
+
+   PAYCO API 연동을 위해 알아야 할 내용들을 확인해 보세요.
+
+   - ##### 데이터 포멧
+
+     JSON(JavaScript Object Notation)은 언어 독립적인 Data Format 입니다.  
+      더 많은 정보를 위해서는 [json.org](https://www.json.org/json-ko.html) 사이트를 참조해 주세요.
+   - ##### Request
+
+     PAYCO가 제공하는 전문 요청 및 응답은 공인 UTF-8로 이루어집니다.  
+      전문의 모든 Request의 정보에는 아래의 Headers 값이 포함되어야 합니다.
+
+     PAYCO 연동 API 공통 규약 - Request
+
+     | 구분 | 내용 |
+     | --- | --- |
+     | Headers | Content-Type=application/json |
+     | Method | POST & JSON |
+   - ##### Response
+
+     Response Body의 Content-Type 또한 application/json 형태로 전달됩니다.  
+      HTTP Status가 200 / resultCode가 0 인 경우 결제 성공으로 판단을 합니다.  
+      다만, 기취소 거래 경우 취소 요청 시 예외적으로 결제 성공인 0 으로 응답을 내려 줍니다.
+
+     PAYCO 연동 API 공통 규약 - Response
+
+     | 파라미터 | 설명 |
+     | --- | --- |
+     | result(object) | 전문 결과에 대한 결과 Object |
+     | resultCode(integer) | 전문 응답에 대한 결과코드 |
+     | message(string) | 전문의 응답 또는 에러에 대한 상세한 정보 |
+     | sourceResultCode(string) | 원천사(PG/VAN) 응답에 대한 결과코드 |
+     | sourceMessage(string) | 원천사(PG/VAN) 응답에 또는 에러에 대한 상세정보 |
+   - ##### PAYCO 도메인
+
+     도메인 하위 주소는 각 API 명세를 확인하세요.
+
+     PAYCO 연동 API 공통 규약 - PAYCO 도메인
+
+     |  |  |
+     | --- | --- |
+     | 개발환경 | https://alpha-dongle.payco.com |
+     | 운영환경 | https://dongle.payco.com |
+   - ##### API 목록
+
+     PAYCO결제 연동에 필요한 각 API를 확인하고 개발해 주세요.
+
+     PAYCO 연동 API 공통 규약 - API 목록
+
+     | API 명 | URL | 설명 |
+     | --- | --- | --- |
+     | POS 등록 | /pos/v1/registration | POS를 최초1회 등록 요청. |
+     | 결제 승인 요청 | /payment/v1/approval/simple | 결제 승인 요청 |
+     | 결제 취소 요청 | /payment/v1/cancel/simple | 결제 취소 요청 |
+     | 망취소 요청 | /payment/v1/networkcancel/simple | 망취소 요청 |
+   - ##### Signature
+
+     PAYCO 결제는 승인 및 취소 요청에 대한 검증이 필요해요. 검증을 위해서는 요청 전문에 Signature 정보를 포함해야 합니다.
+
+     개발사 Server와 통신을 하는 경우에는 Server의 고정IP 를 PAYCO 방화벽에 등록이 되시면 결제요청, 취소 시 Signature, postid(PAYCO)필드 값 없이 전문 처리가 가능합니다.
+
+     Signature 생성을 위해서 다음과 같은 정보들이 필요합니다.
+
+     - 1. POS등록 API를 통해 발급받은 API Key
+     - 2. POS등록 API를 통해 발급받은 posTid(PAYCO 관리 단말기번호)
+     - 3. pinCode(PAYCO 결제 바코드 번호)  
+
+     ![Signature 생성 flow 이미지](/img/@offline_api_signature_flow.2c730db6.png)
+
+     생성한 Signature 값은 결제요청, 취소 시 해당 필드에 셋팅하여 요청하시면 됩니다.
+
+     Signature 생성 sample
+
+     - - pinCode : 944542050178560694342
+     - - posTid : P1510100001
+     - - API KEY : 4044cac130913f94a5d4979e0401500e
+
+     PAYCO 연동 API 공통 규약 - Signature 생성 sample
+
+     | 순서 | 생성 방법 | 예시 |
+     | --- | --- | --- |
+     | 1 | String Data = pinCode + posTid | 944542050178560694342P1510100001 |
+     | 2 | Binary Data : UTF-8 Encoding | 3934343534323035303137383536303639343334325031353130313030303031 |
+     | 3 | Hashed Data : HMAC-SHA256(API KEY를 사용하여 해싱) | a6f6c3bfb4d30326db6285c0488e67616b2754f23c946582734d157501cd2c77 |
+     | 4 | Signature String Data : Base64 Encoding | pvbDv7TTAybbYoXASI5nYWsnVPI8lGWCc00VdQHNLHc= |
+2. #### POS 등록 API 사용하기
+
+   VAN사의 POS 터미널번호를 통해 단말기를 최초 1회 인증하고, Signature 생성을 위한 API Key를 발급합니다.  
+    가맹점 및 단말기 정보가 변경된 경우에도 재요청하여 새로운 API Key 발급을 해주세요.
+
+   ※ POS 등록 API는 공통 응답 필드인 sourceResultCode, sourceMessage 필드가 없는 점 참고해 주세요.
+
+   - ##### POS 등록 API - REQUEST
+
+     POS 등록 API - REQUEST
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | posType(필수 / string) | 요청단말의 타입 POS : POS 단말 CAT : CAT/VAN 단말 |
+     | 2 | registrationNumber(필수 / string) | 사업자 등록번호, ‘-’ 문자 제거하여 전달 |
+     | 3 | [vanCorpCode](/guide/offline/code/vancode?id=220401025)(필수 / string) | VAN사 코드 |
+     | 4 | vanPosTid(필수 / string) | VAN에서 발급한 POS 기기별 고유번호 |
+     | 5 | posDevCorpName(string) | POS 개발사명 |
+     | 6 | posSolutionName(string) | POS 솔루션명 |
+     | 7 | totalTaxableAmt(string) | POS 솔루션버전 |
+
+     **POS 등록 API - REQUEST Sample 코드**
+
+     ```
+     {
+         "posType" : "POS",
+         "vanCorpCode": "KCP",
+         "registrationNumber": "1448115557",
+         "vanPosTid": "1002189853",
+         "posDevCorpName": "NHN PAYCO",
+         "posSolutionName": "vCAT데몬 Solution",
+         "posSolutionVersion": "Ver 1.0.0.0"
+     }
+     ```- ##### POS 등록 API - RESPONSE
+
+     POS 등록 API - RESPONSE
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | posTid(string) | PAYCO가 관리하는 POS단말 고유번호 |
+     | 2 | apiKey(string) | Signature 생성을 위한 API Key |
+     | 3 | merchantKey(string) | 가맹점 KEY |
+     | 4 | merchantName(string) | 가맹점명 |
+
+     **POS 등록 API - RESPONSE Sample 코드**
+
+     ```
+     {
+       "message": "OK",
+       "result": {
+           "posTid": "P1605109565",
+           "apiKey": "f571eaf60c0f51fb3f5a3840552294a2",
+           "merchantKey": "BEAGLEBEAGLE",
+           "merchantName": "비글샵"
+       },
+       "resultCode": 0
+     }
+     ```3. #### 결제 승인 API 사용하기
+
+   오프라인 결제를 위해 가맹점 의 POS 단말정보 를 인증한 후 결제 승인 요청 시 거래정보 를 제공합니다.
+
+   결제 승인 API 사용하기 - URI
+
+   | Method | URI |
+   | --- | --- |
+   | POST | /payment/v1/approval/simple |
+
+   - ##### 결제 승인 API 사용하기 - REQUEST
+
+     결제 승인 API 사용하기 - REQUEST
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | signature(필수 / string) | 요청정보 검증을 위한 Signature 문자열 |
+     | 2 | deviceAuthType(필수 / string) | 단말기인증타입 BAR : 바코드 스캔방식 QR : QR 촬영 방식 |
+     | 3 | serviceType(필수 / string) | 결제서비스 코드 “PAYCO” |
+     | 4 | registrationNumber(필수 / string) | 사업자등록번호 |
+     | 5 | posTid(필수 / string) | PAYCO POS 터미널 번호 |
+     | 6 | [vanCorpCode](/guide/offline/code/vancode?id=220401025)(필수 / string) | VAN사 코드 |
+     | 7 | vanPosTid(필수 / string) | VAN사 에서 발급한 POS 터미널 번호 |
+     | 8 | pinCode(필수 / string) | PAYCO APP에서 스캔한 바코드 번호 |
+     | 9 | posReferenceKey(string) | 원거래 참고번호(년월일시분초밀리세컨드) 예)20180723152014985 POS에서 생성하는 값으로 유니크 해야하며, 해당 값으로 망취소 처리가 가능합니다. FDIK VAN 연동인 경우 필수로 사용해야 합니다. |
+     | 10 | totalAmount(필수 / double) | 결제 총 금액(컵보증금 포함) |
+     | 11 | enableTaxable(boolean) | 면세, 과세 정보적용여부 true: 면세, 과세 값을 요청 받은 대로 적용 합니다. false : 면세, 과세 값을 요청 받아도 내부정책으로 계산하여 적용 합니다. |
+     | 12 | totalTaxfreeAmount(double) | 면세금액 |
+     | 13 | totalTaxableAmount(double) | 과세금액 |
+     | 14 | totalVatAmount(double) | 부가세 |
+     | 15 | totalServiceAmount(double) | 봉사료 |
+     | 16 | totalGreenDepositAmount(double) | 컵보증금 |
+     | 17 | currency(필수 / string) | 통화코드 “KRW” |
+     | 18 | productName(필수 / string) | 상품명. 예)아메리카노 외 1건 |
+     | 19 | [productInfoList](/guide/offline/api/productInfoList?id=2204010244)(list) | 상품 목록 |
+     | 20 | installmentPeriod(string) | 할부기간. 예)일시불 : 00, 3개월할부 : 03 |
+     | 21 | ktcCertNo(string) | KTC 단말 인증 번호 |
+     | 22 | pin(string) | 비밀번호 (비밀번호 요청거래시) |
+     | 23 | nocvmYN(string) | NoCVM 거래여부. 5만원 초과 결제시 : N, 5만원 이하 결제시 : Y |
+     | 24 | deviceType(string) | 단말기 타입. 예) KIOSK, POS, CAT |
+     | 25 | [extras](/guide/offline/api/extrasInfo?id=2204010244)(object) | 추가정보 |
+     | 26 | [sign](/guide/offline/api/vanSignInfo?id=2204010244)(필수 / object) | van 사별 sign 정보(5만원 초과결제시 필수) |
+   - ##### 상품 목록(productInfoList) 상세
+
+     **잠깐만요!**
+
+     프로모션여부는 페이코 식권, 쿠폰 등의 사용을 위해서 ‘Y’값으로 설정해 주세요.
+
+     결제 승인 API 사용하기 - REQUEST - 상품 목록(productInfoList) 상세
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | productCode(필수 / string) | 상품코드 |
+     | 2 | productName(필수 / string) | 상품명 |
+     | 3 | productUnitAmount(필수 / double) | 상품단가 |
+     | 4 | productQuantity(필수 / integer) | 상품수량 |
+     | 5 | promotionYn(필수 / string) | 프로모션여부 |
+   - ##### 추가정보(extras) 상세
+
+     결제 승인 API 사용하기 - REQUEST - 추가정보(extras) 상세
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | posVersion(string) | POS 프로그램 Version 정보 |
+     | 2 | posDevCorpName(필수 / string) | POS개발사 명 |
+     | 3 | posSolutionName(필수 / string) | POS솔루션 명 |
+     | 4 | posSolutionVersion(필수 / string) | POS솔루션 버전 |
+     | 5 | merchantCode(string) | 업체(가맹점) 코드(스마트로 VAN 필수) 대형 가맹점의 경우 VAN사에서 코드값 부여 일반 가맹점의 경우 디폴트 ”SPOS” |
+     | 6 | posEntryMode(string) | PosEntry모드(스마트로 VAN 필수) |
+     | 7 | merchantPosNo(string) | POS 시리얼/단말기 번호(FDIK VAN필수) |
+   - ##### van 사별 sign 정보(sign) 상세
+
+     서명 정보의 경우 각각의 VAN사에서 정의한 문서 및 API 를 이용하여 해당 파라미터를 전달해야 합니다.
+
+     KCP, JTNET, KIS, KOVAN, DAU 서명 추가정보
+
+     결제 승인 API 사용하기 - REQUEST - van 사별 sign 정보(sign) 상세 - KCP, JTNET, KIS, KOVAN, DAU 서명 추가정보
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | signpadYN(필수 / string) | 사인패드부착여부 |
+     | 2 | signLength(필수 / string) | 사인데이타 정보 길이 |
+     | 3 | signData(필수 / string) | 사인데이타 정보(2048) |
+     | 4 | signpadVanCorpCode(필수 / string) | 사인패드 VAN사 코드 |
+   - ##### SPC 서명 추가정보
+
+     결제 승인 API 사용하기 - REQUEST - van 사별 sign 정보(sign) 상세 - SPC 서명 추가정보
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | signData(필수 / string) | 사인데이타 정보(1655) |
+     | 2 | signpadVanCorpCode(필수 / string) | 사인패드 VAN사 코드 |
+   - ##### NICE 서명 추가정보
+
+     결제 승인 API 사용하기 - REQUEST - van 사별 sign 정보(sign) 상세 - NICE 서명 추가정보
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | signData(필수 / string) | 사인데이타 정보(1084) |
+     | 2 | signpadVanCorpCode(필수 / string) | 사인패드 VAN사 코드 |
+   - ##### 스마트로 서명 추가정보
+
+     결제 승인 API 사용하기 - REQUEST - van 사별 sign 정보(sign) 상세 - 스마트로 서명 추가정보
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | signpadYN(필수 / string) | 사인패드부착여부(서명여부) (S/N) |
+     | 2 | signImageInfo(필수 / string) | 사인이미지정보 |
+     | 3 | signImageData(필수 / string) | 사인이미지데이터(1540) |
+     | 4 | signDeviceNo(필수 / string) | 사인패드 기기번호 |
+     | 5 | signHashCode(필수 / string) | 해쉬코드 |
+     | 6 | signpadVanCorpCode(필수 / string) | 사인패드 VAN사 코드 |
+   - ##### FDIK 서명 추가정보
+
+     결제 승인 API 사용하기 - REQUEST - van 사별 sign 정보(sign) 상세 - FDIK 서명 추가정보
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | signCompressedKind(필수 / string) | sign 압축방식 |
+     | 2 | signHashCode(필수 / string) | sign mac value |
+     | 3 | signData(필수 / string) | 서명데이터 |
+     | 4 | signpadVanCorpCode(필수 / string) | 사인패드 VAN사 코드 |
+
+     ※ FDIK 서명거래시 Card Data 생성 방법 : CatID(8) + 거래일련번호(6) + “00”  
+           거래일련번호 : posReferenceKey 값 뒤 6자리  
+           예시) posReferenceKey : 20191107103803133 > 거래일련번호 : 803133
+   - ##### KSNET 서명 추가정보
+
+     결제 승인 API 사용하기 - REQUEST - van 사별 sign 정보(sign) 상세 - KSNET 서명 추가정보
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | signEncKeyIndex(필수 / string) | 사인패드부착여부 |
+     | 2 | singPadVersion(필수 / string) | 사인데이타 정보 길이 |
+     | 3 | signLength(필수 / string) | 사인데이타 정보 길이 |
+     | 4 | signData(필수 / string) | 사인데이타 정보(2048) |
+     | 5 | signpadVanCorpCode(필수 / string) | 사인패드 VAN사 코드 |
+   - ##### KICC 서명 추가정보
+
+     결제 승인 API 사용하기 - REQUEST - van 사별 sign 정보(sign) 상세 - KICC 서명 추가정보
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | signData(필수 / string) | 사인데이타 정보(591) |
+   - ##### KOCES 서명 추가정보
+
+     결제 승인 API 사용하기 - REQUEST - van 사별 sign 정보(sign) 상세 - KOCES 서명 추가정보
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | signLength(필수 / string) | 사인데이타 정보 길이 |
+     | 2 | signData(필수 / string) | 사인데이타 정보(1086) |
+     | 3 | signpadVanCorpCode(필수 / string) | 사인패드 VAN사 코드 |
+
+     **결제 승인 API - REQUEST Sample 코드**
+
+     ```
+     {
+       "registrationNumber" : "1448115557",
+       "vanPosTid" : "1002189853",
+       "posTid": "P1605109565",
+       "serviceType" : "PAYCO",
+       "vanCorpCode" : "KCP",
+       "totalAmount" : "61000",
+       "pinCode" : "457973205900115495048",
+       "posReferenceKey" : "20220217161025124",
+       "signature": "gqPJZHiuv27RrfuVIKjG2UdtJGgP007ovBfATjevZXE=",
+       "productName" : "키위티셔츠 XL외 1건",
+       "productInfoList":[
+       {
+           "productCode":"PAYCO00001",
+           "productName":"키위티셔츠 XL",
+           "productQuantity":"6",
+           "productUnitAmount":"10000",
+           "promotionYn":"Y"
+       },
+       {
+           "productCode":"PAYCO00002",
+           "productName":"사과티셔츠 S",
+           "productQuantity":"2",
+           "productUnitAmount":"500",
+           "promotionYn":"Y"
+       }],
+       "currency" : "KRW",
+       "deviceAuthType" : "BAR",
+       "deviceType" : "POS",
+       "sign" : {
+         "signData" : "tm3Vp6gcK0jtjx/j1mf3bVHsC5gNfU0XC240LE6QuErPHPkPuyzgX9M9mjHCszveaCon88UTAFrIr2H1Y3Hzzrny7MZGA/6pqe+j4X62fCOYFSo/23l0oQ+iY3EXlXqdgIb1HyKKrrzxwo7Hc6KnrS8jjahVr23g96X3S4W1jqc=",
+         "signLength" : "0172",
+         "signpadVanCorpCode" : "KCP",
+         "signpadYN" : "Y"
+       },
+       "extras" : {
+         "posDevCorpName" : "NHNPAYCO",
+         "posSolutionName" : “PAYCO Solution",
+         "posSolutionVersion" : “12.1.2.0"
+       }
+     }
+     ```- ##### 결제 승인 API 사용하기 - RESPONSE
+
+     결제 승인 API 사용하기 - RESPONSE
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | tradeMethod(string) | 거래방식 VAN : VAN방식 PG : PG방식 |
+     | 2 | tradeRequestNo(string) | 거래요청번호 (결제인증토큰으로 결제시에만 값이 전달) |
+     | 3 | tradeNo(string) | PG/VAN사 거래번호 |
+     | 4 | tradeDatetime(string) | PG/VAN사 거래일시(yyyyMMddHHmmss) |
+     | 5 | totalTaxfreeAmount(double) | 총 면세금액 |
+     | 6 | totalTaxableAmount(double) | 총 과세금액 |
+     | 7 | totalVatAmount(double) | 총 부가세 |
+     | 8 | totalServiceAmount(double) | 총 봉사료 |
+     | 9 | totalGreenDepositAmount(double) | 컵보증금 |
+     | 10 | [approvalResultList](/guide/offline/api/approvalResultListInfo?id=2204010244)(list) | 결제 승인 시 결제수단별 정보 |
+     | 11 | [extras](/guide/offline/api/approvalExtraInfo?id=2204010244)(object) | 추가정보 |
+     | 12 | membershipCardNo(string) | 멤버십카드번호 페이코와 멤버십 연동이 되어있고, 자동 적립을 사용 할 경우에만 사용됩니다. |
+     | 13 | originalPinCode(string) | 실제 결제에 사용된 카드사 OTC 단, 가맹점에서 매입청구를 하시는 경우에만 해당 값이 전달됩니다. |
+     | 14 | mainPaymentMethodCode(string) | 주 오프라인 결제수단코드 |
+   - ##### 결제 승인 시 결제수단별 정보(approvalResultList) 상세
+
+     결제 승인 API 사용하기 - RESPONSE - 결제 승인 시 결제수단별 정보(approvalResultList) 상세
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | [paymentMethodCode](/guide/offline/code/paymentcode?id=220401025)(string) | 오프라인 결제수단코드 |
+     | 2 | paymentMethodName(string) | 결제수단명 |
+     | 3 | approvalNo(string) | 승인번호 |
+     | 4 | approvalDatetime(string) | 승인일시(yyyyMMddHHmmss) |
+     | 5 | approvalAmount(double) | 승인금액 |
+     | 6 | [approvalCompanyCode](/guide/online/code/startCard?id=220401019)(string) | 승인사코드 |
+     | 7 | approvalCompanyName(string) | 승인사명 |
+     | 8 | approvalCardNo(string) | 승인카드번호 예시) 490620******6536 |
+     | 9 | [sourcePaymentMethdCode](/guide/offline/code/paymentcode?id=220401025)(string) | 결제수단코드 |
+     | 10 | taxfreeAmount(double) | 면세금액 |
+     | 11 | taxableAmount(double) | 과세금액 |
+     | 12 | vatAmount(double) | 부가세 |
+     | 13 | serviceAmount(double) | 봉사료 |
+     | 14 | greenDepositAmount(double) | 컵보증금 |
+     | 15 | vanApprovalCompanyCode(string) | VAN사에서 전달받은 승인사코드 |
+     | 16 | vanApprovalCompanyName(string) | VAN사에서 전달받은 승인사명 |
+   - ##### 추가정보(extras) 상세
+
+     VAN 승인시 추가정보 응답 받는 정보 입니다.
+
+     결제 승인 API 사용하기 - RESPONSE - 추가정보(extras) 상세
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | buyCompanyName(string) | 매입사명 |
+     | 2 | buyCompanyCode(string) | 매입사코드 |
+     | 3 | cardMerchantNo(double) | 카드 가맹점번호 |
+     | 4 | buyTypeName(integer) | 매입방법명 |
+     | 5 | nocvmYN(string) | NoCVM 거래 여부 |
+
+     **결제 승인 API - RESPONSE Sample 코드**
+
+     ```
+     {
+       "message": "OK",
+       "result": {
+           "tradeNo": "30022741",
+           "tradeDatetime": "20220217161113",
+           "totalTaxfreeAmount": 0.0,
+           "totalTaxableAmount": 55455.0,
+           "totalVatAmount": 5545.0,
+           "totalServiceAmount": 0.0,
+           "approvalResultList": [
+               {
+                   "paymentMethodCode": "00",
+                   "paymentMethodName": "신용카드",
+                   "approvalNo": "30022741",
+                   "approvalDatetime": "20220217161113",
+                   "approvalAmount": 61000.0,
+                   "approvalCompanyCode": "CCKM",
+                   "approvalCompanyName": "KB국민카드",
+                   "approvalCardNo": "457973******2091",
+                   "sourcePaymentMethdCode": "37",
+                   "installmentPeriod": "00",
+                   "taxfreeAmount": 0.0,
+                   "taxableAmount": 55455.0,
+                   "vatAmount": 5545.0,
+                   "serviceAmount": 0.0,
+                   "vanApprovalCompanyCode": "CCKM",
+                   "vanApprovalCompanyName": "KB국민카드"
+               }
+           ],
+           "extras": {
+               "buyCompanyCode": "CCKM",
+               "buyTypeName": "전자서명전표",
+               "buyCompanyName": "KB국민",
+               "cardMerchantNo": "00040551641",
+               "nocvmYN": "N"
+           },
+           "tradeRequestNo": "2022021710443769",
+           "membershipCardNo": "",
+           "mainPaymentMethodCode": "00",
+           "tradeMethod": "VAN",
+           "businessName": "비글샵",
+           "encOriginalPinCode": null
+       },
+       "resultCode": 0,
+       "sourceResultCode": "0000",
+       "sourceMessage": "정상승인"
+     }
+     ```4. #### 결제 취소 API 사용하기
+
+   결제 승인에 대한 취소를 요청합니다. 쿠폰을 사용한 복합결제여도 결제수단별로 각각 취소하지 않고 한번에 취소처리 됩니다.
+
+   결제 취소 API 사용하기 - URI
+
+   | Method | URI |
+   | --- | --- |
+   | POST | /payment/v1/cancel/simple |
+
+   - ##### 결제 취소 API 사용하기 - REQUEST
+
+     결제 취소 API 사용하기 - REQUEST
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | signature(필수 / string) | 요청정보 검증을 위한 Signature 문자열 |
+     | 2 | tradeRequestNo(필수 / string) | 거래요청번호 |
+     | 3 | deviceAuthType(필수 / string) | 단말기인증타입 BAR : 바코드 스캔방식 QR : QR 촬영 방식 |
+     | 4 | mrcBuyingCancelYN(string) | 가맹점 매입취소 여부(Y|N) Y인 경우 PAYCO에서 승인취소처리를 하지 않고 결과 등록만 진행합니다. |
+     | 5 | mrcBuyingTradeNo(string) | 매입거래번호 |
+     | 6 | cardApprovalNo(string) | 승인번호 mrcBuyingCancelYN 가 Y인 경우 필수 값입니다. |
+     | 7 | cardCancelDatetime(string) | 취소일시(yyyyMMddHHmmss) mrcBuyingCancelYN 가 Y인 경우 필수 값입니다. |
+     | 8 | tradeNo(필수 / string) | PG사 거래번호 |
+     | 9 | serviceType(필수 / string) | 결제서비스 코드 “PAYCO” |
+     | 10 | registrationNumber(필수 / string) | 사업자등록번호 |
+     | 11 | posTid(string) | PAYCO POS 터미널 번호 |
+     | 12 | [vanCorpCode](/guide/offline/code/vancode?id=220401025)(필수 / string) | VAN사 코드 |
+     | 13 | vanPosTid(필수 / string) | VAN에서 발급한 POS 터미널 번호 |
+     | 14 | ktcCertNo(string) | KTC 단말 인증 번호 |
+     | 15 | totalAmount(필수 / double) | 상품 총결제금액 |
+     | 16 | approvalNo(필수 / string) | 승인번호 |
+     | 17 | approvalDatetime(필수 / string) | 승인일시(yyyyMMddHHmmss) |
+     | 18 | approvalAmount(필수 / double) | 페이코(신용카드) 승인금액 |
+     | 19 | pinCode(필수 / string) | PAYCO APP에서 스캔한 바코드 번호 PAYCO(신용카드),포인트,쿠폰 OTC (20~21byte의 문자열) |
+     | 20 | nocvmYN(string) | NoCVM 거래 여부. 5만원 초과 결제 시 : N, 5만원 이하 결제 시 : Y |
+     | 21 | deviceType(string) | 단말기 타입. 예) KIOSK, POS, CAT |
+     | 23 | [extras](/guide/offline/api/extrasInfo?id=2204010244)(object) | 추가정보 |
+     | 24 | [sign](/guide/offline/api/vanSignInfo?id=2204010244)(필수 / object) | van 사별 sign 정보(5만원 초과결제시 필수) |
+   - ##### 결제 취소 API - REQUEST Sample 코드
+
+     기매입건 취소의 경우 mrcBuyingCancelYN 의 값을 Y 로 지정하고 cardApprovalNo, cardCancelDatetime 의 값을 전달하여, 페이코 거래정보가 업데이트 되도록 변경해주세요.
+
+     **PAYCO 신용카드 결제취소(Request) Sample 코드**
+
+     ```
+     {
+       "registrationNumber" : "1448115557",
+       "vanPosTid" : "1002189853",
+       "posTid" : "P1605109565",
+       "serviceType" : "PAYCO",
+       "vanCorpCode" : "KCP",
+       "tradeNo" : "30022640",
+       "tradeRequestNo" : "2022021610443637",
+       "totalAmount" : "1500",
+       "approvalAmount" : "1500",
+       "approvalDatetime" : "20220216143325",
+       "approvalNo" : "30022640",
+       "pinCode" : "457973205801448495047",
+       "deviceAuthType" : "BAR",
+       "signature": "3vZdO67oyRHLHgehUehWdFB64+bk4q3SJDFJFW9/CNU=",
+       "extras": {
+         "posDevCorpName" : "NHNPAYCO",
+         "posSolutionName" : "심플형 테스트",
+         "posSolutionVersion" : "test1"
+       }
+     }
+     ```5. #### 망취소 API 사용하기
+
+   단말기에서 PAYCO서버로 승인요청 이후 응답을 못 받은 경우 망취소를 요청합니다.  
+   응답 대기시간(TIME OUT)은 20~30초를 권장 드려요.
+
+   망취소 API 사용하기 - URI
+
+   | Method | URI |
+   | --- | --- |
+   | POST | /payment/v1/networkcancel/simple |
+
+   - ##### 망취소 API 사용하기 - REQUEST
+
+     ※ 결제 취소 API REQUEST의 필드 중 posReferenceKey를 제외하고 orgPosReferenceKey 필드를 추가하여 호출해 주세요.
+
+     망취소 API 사용하기 - REQUEST
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | orgPosReferenceKey(필수 / string) | 원거래 참고번호(년월일시분초밀리세컨드) 예)20180723152014985 승인요청시 POS에서 생성한 키 값을 사용해야 합니다. |
+
+     **PAYCO 망취소(Request) Sample 코드**
+
+     ```
+     {
+       "registrationNumber" : "1448115557",
+       "vanPosTid" : "1002189853",
+       "posTid": "P1605109565",
+       "serviceType" : "PAYCO",
+       "vanCorpCode" : "KCP",
+       "totalAmount" : "1500",
+       "pinCode" : "20762005284848649593",
+       "orgPosReferenceKey" : "20220216160414124",
+       "signature": "eC+qUIwJWv2uRaOjDIE4FH9QdH3w8tewMtcKnHDK1PU=",
+       "productName" : "키위티셔츠 XL외 1건",
+       "productInfoList":[
+       {
+           "productCode":"PAYCO00001",
+           "productName":"키위티셔츠 XL",
+           "productQuantity":"1",
+           "productUnitAmount":"1000",
+           "promotionYn":"Y"
+       },
+       {
+           "productCode":"PAYCO00002",
+           "productName":"사과티셔츠 S",
+           "productQuantity":"1",
+           "productUnitAmount":"500",
+           "promotionYn":"Y"
+       }],
+       "currency" : "KRW",
+       "deviceAuthType" : "BAR",
+       "deviceType" : "POS",
+       "extras" : {
+         "posDevCorpName" : "NHNPAYCO",
+         "posSolutionName" : "심플형 테스트",
+         "posSolutionVersion" : "test1"
+       }
+     }
+     ```- ##### 결제 취소, 망취소 API - RESPONSE
+
+     망취소 API - 추가정보(extras) 상세
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | tradeNo(string) | PG/VAN사 거래번호 |
+     | 2 | tradeDatetime(string) | PG/VAN사 거래일시(yyyyMMddHHmmss) |
+     | 3 | totalTaxfreeAmount(double) | 면세금액 |
+     | 4 | totalTaxableAmount(double) | 과세금액 |
+     | 5 | totalVatAmount(double) | 부가세 |
+     | 6 | totalServiceAmount(double) | 봉사료 |
+     | 7 | totalGreenDepositAmount(double) | 컵보증금 |
+     | 8 | [cancelResultList](/guide/offline/api/netCancelResultListInfo?id=2204010246)(list) | 취소 결과 목록 |
+     | 9 | [extras](/guide/offline/api/extrasInfo?id=2204010244)(object) | 추가정보 |
+     | 10 | originalPinCode(string) | 실제 결제에 사용된 OTC(협의 시 정보 전달) |
+   - ##### 취소 결과 목록(cancelResultList) 상세
+
+     망취소 API - 취소 결과 목록(cancelResultList) 상세
+
+     | No. | 파라미터 | 설명 |
+     | --- | --- | --- |
+     | 1 | [paymentMethodCode](/guide/offline/code/paymentcode?id=220401025)(string) | 오프라인 결제수단코드 |
+     | 2 | paymentMethodName(string) | 결제수단명 |
+     | 3 | cancelAmount(double) | 취소금액 |
+     | 4 | cancelDatetime(string) | 취소일시(yyyyMMddHHmmss) |
+     | 5 | [sourcePaymentMethdCode](/guide/offline/code/paymentcode?id=220401025)(string) | 결제수단코드 |
+     | 6 | taxfreeAmount(double) | 면세금액 |
+     | 7 | taxableAmount(double) | 과세금액 |
+     | 8 | vatAmount(double) | 부가세 |
+     | 9 | serviceAmount(double) | 봉사료 |
+     | 10 | greenDepositAmount(double) | 컵보증금 |
+     | 11 | nocvmYN(string) | NoCVM 거래 여부 |
+
+     **PAYCO 신용카드 결제취소(Response) Sample 코드**
+
+     ```
+     {
+       "message": "OK",
+       "result": {
+           "tradeNo": "30022640",
+           "tradeDatetime": "20220216145316",
+           "cancelResultList": [
+               {
+                   "paymentMethodCode": "00",
+                   "paymentMethodName": "신용카드",
+                   "cancelAmount": 1500.0,
+                   "cancelDatetime": "20220216145316",
+                   "sourcePaymentMethdCode": "37",
+                   "taxfreeAmount": 0.0,
+                   "taxableAmount": 1364.0,
+                   "vatAmount": 136.0,
+                   "serviceAmount": 0.0,
+                   "approvalNo": "30022640",
+                   "approvalCompanyCode": "CCKM",
+                   "approvalCompanyName": "KB국민카드"
+               }
+           ],
+           "extras": {
+               "buyCompanyCode": "CCKM",
+               "buyTypeName": "전자서명전표",
+               "buyCompanyName": "KB국민",
+               "cardMerchantNo": "00040551641",
+               "nocvmYN": "Y"
+           },
+           "totalTaxfreeAmount": 0.0,
+           "totalTaxableAmount": 1364.0,
+           "totalVatAmount": 136.0,
+           "totalServiceAmount": 0.0,
+           "encOriginalPinCode": null
+       },
+       "resultCode": 0,
+       "sourceResultCode": "0000",
+       "sourceMessage": "정상취소"
+     }
+     ```PAYCO 망취소(Response)**
+
+     ```
+     {
+       "message": "OK",
+       "result": {
+           "tradeNo": "2022021623768366",
+           "tradeDatetime": "20220216160711",
+           "cancelResultList": [
+               {
+                   "paymentMethodCode": "10",
+                   "paymentMethodName": "페이코 포인트",
+                   "cancelAmount": 1500.0,
+                   "cancelDatetime": "20220216160711",
+                   "sourcePaymentMethdCode": "98",
+                   "taxfreeAmount": 0.0,
+                   "taxableAmount": 1364.0,
+                   "vatAmount": 136.0,
+                   "serviceAmount": 0.0,
+                   "approvalNo": "2022021623768366",
+                   "approvalCompanyCode": "NHN",
+                   "approvalCompanyName": "NHN"
+               },
+               {
+                   "paymentMethodCode": "00",
+                   "paymentMethodName": "신용카드",
+                   "cancelAmount": 0.0,
+                   "cancelDatetime": "20220216160711",
+                   "sourcePaymentMethdCode": "37",
+                   "taxfreeAmount": 0.0,
+                   "taxableAmount": 0.0,
+                   "vatAmount": 0.0,
+                   "serviceAmount": 0.0,
+                   "approvalNo": "10443663",
+                   "approvalCompanyCode": "NHN",
+                   "approvalCompanyName": "NHN"
+               }
+           ],
+           "extras": {
+               "buyCompanyCode": "",
+               "buyTypeName": "",
+               "buyCompanyName": "",
+               "cardMerchantNo": "",
+               "nocvmYN": ""
+           },
+           "totalTaxfreeAmount": 0.0,
+           "totalTaxableAmount": 1364.0,
+           "totalVatAmount": 136.0,
+           "totalServiceAmount": 0.0,
+           "encOriginalPinCode": null
+       },
+       "resultCode": 0,
+       "sourceResultCode": "0",
+       "sourceMessage": "성공"
+     }
+     ```### 영수증 노출 요소
+
+영수증에 노출해야 될 정보들을 확인해 주세요.
+
+- ##### PAYCO 신용카드 결제 전표
+
+  ![PAYCO 신용카드 결제 전표](/img/@offline_api_approvalreceipt.2ddb149f.png)
+- ##### PAYCO 포인트 결제 전표
+
+  ![PAYCO 포인트 결제 전표](/img/@offline_api_pointreceipt.6f4f59bf.png)
+
+- 신용거래 영수증에서 가맹점번호, 매입사, 매입처는 PAYCO VAN 방식 결제일 경우 표기해 주세요.  
+ - 쿠폰이 같이 사용된 경우(복합결제) 쿠폰금액도 같이 표기해 주세요.  
+ - 취소거래의 경우 CancelDatetime 값을 추가하여 취소일시를 표기해 주세요.  
+ - 취소거래의 경우 금액에 마이너스(-) 부호를 추가해 주세요.