@nhnpayco-dev/mcp-devcenter 1.0.0

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

@@ -0,0 +1,1170 @@
+# PAYCO 오프라인 POS 인증승인형 연동 가이드
+
+> **원본:** PAYCO_오프라인POS_인증승인형연동가이드_v1.0.1.0.docx (사내 배포 문서)
+> **카테고리:** `offline-authapi`
+> **연동 방식:** 가맹점 단말이 결제 인증·승인을 직접 수행하는 인증승인형
+> **API 5종:** POS 인증 / 결제 인증 / 결제 승인 / 결제취소 / 망취소
+---
+
+# 1. 개요
+
+## 전문 가이드
+
+이 문서는 PAYCO 오프라인 결제 연동 전문에 대한 명세를 정의하며, PAYCO 오프라인 연동 가이드에 따라 상품 정보 및 구매 연동 시스템을 개발하는 방법에 대해 설명합니다.
+
+### 사전 준비사항
+
+- Server to Server 통신인 경우, PAYCO 결제서비스를 사용하기 위해서는
+
+가맹점 측 서버 IP에 대해 방화벽 오픈요청을 해야 결제연동이 가능합니다.
+
+(HTTPS로 접근할 수 있는 443 포트가 허용되어 있어야 합니다.)
+
+- - TLS 1.2 미만의 SSL/TLS 버전은 보안이 취약하여 지원하지 않습니다.   
+    가맹점 서버의 HTTP 클라이언트 환경이 TLS 1.2를 지원하는지 확인해 주세요
+
+### 전문 호출 URL
+
+|  |  |
+| --- | --- |
+| 알파 | https://alpha-dongle.payco.com |
+| 운영 | https://dongle.payco.com |
+
+|  |  |  |
+| --- | --- | --- |
+| **Method** | **HTTP Request** | **Description** |
+| POST | /pos/v1/registration | POS 인증 요청 |
+| POST | /auth/v1/authentication | 결제 인증 요청 |
+| POST | /payment/v1/approval | 결제 승인 요청 |
+| POST | /payment/v1/cancel/integration | 결제 취소 요청 |
+| POST | /payment/v1/networkcancel | 망취소 요청 |
+
+### Data Format
+
+JSON(JavaScript Object Notation)은 언어 독립적인 Data Format입니다.
+
+더 많은 정보를 위해서는 [json.org](https://www.json.org/json-en.html) 링크를 참조하시면 됩니다.
+
+### Request
+
+HTTP Method는 POST 방식만을 제공합니다.
+
+PAYCO Offline Gateway가 제공하는 전문 요청 및 응답은 공인 UTF-8로 이루어집니다.
+
+전문의 모든 Request의 Header 정보에는 아래의 Headers 값이 포함되어야 합니다.
+
+전문 명세 Type의 ()는 byte 단위의 Type의 최대길이를 나타내고 있습니다.
+
+|  |  |
+| --- | --- |
+| **구분** | **내용** |
+| Headers | Content-Type=application/json |
+
+### Response
+
+ResponseBody의 Content-Type은 application/json 형태를 전달하게 됩니다. 상세한 스펙은 아래의 내용을 확인해 주세요.
+
+전문 명세 Type의 ()는 byte 단위의 Type의 최대길이를 나타내고 있습니다.
+
+|  |  |  |
+| --- | --- | --- |
+| **Parameters** | **Type** | **Description** |
+| result | object | 전문 결과에 대한 결과 Object |
+| resultCode | integer | 전문 응답에 대한 결과코드 |
+| message | string | 전문 응답에 대한 결과메세지 |
+
+승인/취소(망취소) API에는 원천사에서 전달받은 결과도 공통으로 응답됩니다.
+
+|  |  |  |
+| --- | --- | --- |
+| **Parameters** | **Type** | **Description** |
+| sourceResultCode | string | 원천사(PG/VAN) 응답에 대한 결과코드 |
+| sourceMessage | string | 원천사(PG/VAN) 응답에 대한 결과메세지 |
+
+HTTP Status가 200 / resultCode가 0 일 경우 결제 성공으로 판단을 합니다.
+
+다만 기취소된 거래의 경우 예외적으로 resultCode 값이 0 으로 응답됩니다.
+
+API Response는 사전에 예고되지 않은 field가 추가될 수 있습니다.
+
+추가되더라도 오류가 발생하지 않도록 연동 개발 부탁드립니다.
+
+**예외처리1) 기취소 거래**
+
+resultCode값이 0 이면서 sourceResultCode값이 1002 인 경우 기취소 거래로 판단합니다.
+
+기취소 거래건의 경우 예외적으로 result 값도 응답됩니다.
+
+예시)
+
+|  |
+| --- |
+| {  "message": "OK",  "result":{  "tradeNo": "14144948",  "tradeDatetime": "20220214145143",  "cancelResultList":[  {"paymentMethodCode": "00",  "paymentMethodName": "신용카드",  "cancelAmount": 4000.0,  "cancelDatetime": "20220214145143",…}],  "extras": null,  "totalTaxfreeAmount": 0.0,  "totalTaxableAmount": 3636.0,  "totalVatAmount": 364.0,  "totalServiceAmount": 0.0,  "encOriginalPinCode": null  },  "resultCode": 0,  "sourceResultCode": "1002",  "sourceMessage": "기 취소 요청건"  } |
+
+**예외처리2) 기매입 거래(VAN 결제)**
+
+resultCode 값이 4001 이면서 sourceResultCode 값이 VAN 사에서 기매입 거래로 정의한 코드값으로 응답될 경우 기매입 거래로 판단합니다. 기매입 코드값과 응답메세지는 각 VAN사에 문의하시기 바랍니다.
+
+예시)
+
+|  |
+| --- |
+| {  "message": "VAN승인실패: 취소실패 [5005]",  "resultCode": 4001,  "sourceResultCode": "5005", // VAN사별로 코드값이 다름  "sourceMessage": "기 매입된 거래"  } |
+
+### 결제유형
+
+- - - - 1. 신용카드 단독결제
+        2. 신용카드 + 쿠폰 결제
+        3. 신용카드 0원 결제
+        4. 페이코 포인트 단독 결제
+        5. 페이코 포인트 + 쿠폰 결제
+        6. 페이코 포인트 0원 결제(쿠폰 전액 결제)
+        7. 식권 단독 결제
+
+## Signature 생성규약 및 전달
+
+Payco Offline Gateway는 아래와 같은 결제요청에 대한 검증을 위해 요청 전문에 Signature 정보를 포함해야 합니다. (단 개발사 Server와 통신을 하게 되는 경우, 개발사 Server의 고정IP 를 PAYCO 방화벽에 등록 후 Signature 파라미터 없이 사용 가능합니다.)
+
+- 결제 인증, 승인, 취소, 망취소
+
+Signature 생성을 위해서는 POS 인증 API를 통해 발급받은 API Key와 인증이 필요한 값에 대한 String Data를 만들어야 하며, 아래와 같은 순서를 통해 Signature를 생성하게 됩니다.
+
+### Signature 생성규약
+
+예를 들어, 아래와 같이 API Key를 문자열인 4044cac130913f94a5d4979e0401500e라고 가정하고, 인증이 필요한 요청정보는 Alphabetical 순서로 append하여 조합합니다.
+
+|  |  |
+| --- | --- |
+| **API Key** | **4044cac130913f94a5d4979e0401500e** |
+
+API Key, PosTid 값은 POS 인증 요청 API를 통해 확인할 수 있습니다.
+
+|  |  |
+| --- | --- |
+| **인증대상정보** | **Parameters** |
+| POS 터미널번호 | posTid |
+| PIN 코드 | pinCode |
+
+**pinCode + posTid (32byte)**
+
+|  |
+| --- |
+| 944542050178560694342P1510100001 |
+
+데이터 문자열인 **944542050178560694342P1510100001** 를 UTF-8 Encoding을 이용해 Binary 로 변환하면 아래와 같은 값(HEX 문자열)이 됩니다.
+
+|  |
+| --- |
+| 3934343534323035303137383536303639343334325031353130313030303031 |
+
+**3934343534323035303137383536303639343334325031353130313030303031** 값(HEX 문자열)을 위의 API Key 문자열인 **4044cac130913f94a5d4979e0401500e**을 통해 HMAC-SHA256로 해싱하면, 아래와 같은 값(HEX 문자열)이 되며,
+
+|  |
+| --- |
+| a6f6c3bfb4d30326db6285c0488e67616b2754f23c946582734d157501cd2c77 |
+
+해싱된 바이너리를 Base64 Encoding 하면 아래와 같은 Signature 문자열을 획득할 수 있습니다.
+
+|  |
+| --- |
+| pvbDv7TTAybbYoXASI5nYWsnVPI8lGWCc00VdQHNLHc= |
+
+정리를 하면, **944542050178560694342P1510100001** 인 String Data를 위와 같은 규약으로 **4044cac130913f94a5d4979e0401500e** 문자열의 API Key와 HMAC-SHA256 방식으로 해싱 하게 되면 아래와 같은 Signature 문자열을 얻을 수 있어야 합니다.
+
+|  |
+| --- |
+| pvbDv7TTAybbYoXASI5nYWsnVPI8lGWCc00VdQHNLHc= |
+
+문서 내에서는 'RFC4648 방식으로 Base64 인코딩하라' 라고 간단히 기술했으나, 이것의 내부적인 의미는 다음과 같습니다.
+
+<http://www.ietf.org/rfc/rfc4648.txt>
+
+### Signature의 전달
+
+위와 같은 과정으로 생성된 Signature는 posTid와 함께 결제 요청 전문에 포함해야 합니다. 검증이 필요한 전문의 HTTP Request는 RequestBody의 Object에 항상 signature 라는 Key를 통해 Signature 문자열을 전달하게 되며, Signature에 대한 검증이 정상적으로 이루어질 때 성공적인 응답이 전달되게 됩니다.
+
+**결제요청시 Signature 사용 예시)**
+
+|  |
+| --- |
+| Content-Type: application/json  {  "registrationNumber" : "1448115557",  "vanPosTid" : "1002189853",  "posTid" : "P1605109565",  "serviceType" : "PAYCO",  "vanCorpCode" : "KCP",  "totalAmount" : "8000",  "pinCode" : "402857138046794695207",  "productName" : "테스트 상품 외 5건",  "currency" : "KRW",  "deviceAuthType" : "BAR",  "deviceType" : "KIOSK",  "signature": "pvbDv7TTAybbYoXASI5nYWsnVPI8lGWCc00VdQHNLHc="  } |
+
+# 연동하기
+
+## POS 인증 요청
+
+사업자번호, VAN 단말기번호로 최초 1회 인증하여 signature 생성을 위한 apiKey 및 posTid를 발급합니다. 가맹점 및 단말기 정보가 변경된 경우에도 요청하여 새로 발급해 주세요.
+
+|  |  |
+| --- | --- |
+| **Method** | **URI** |
+| POST | /pos/v1/registration |
+
+### RequestBody
+
+|  |  |  |  |
+| --- | --- | --- | --- |
+| **Parameter** | **Type** | **Required** | **Description** |
+| posType | string(3) | Y | 요청단말의 타입   - - POS, KIOSK, CAT |
+| registrationNumber | string(10) | Y | 사업자 등록번호 |
+| vanCorpCode | string(10) | Y | VAN사 코드([공통코드](#_VAN사_코드) 목차 참고) |
+| vanPosTid | string(128) | Y | VAN에서 발급한 단말기번호 |
+| posDevCorpName | String(20) | Y | POS개발사 명 |
+| posSolutionName | String(20) | Y | POS솔루션 명 |
+| posSolutionVersion | String(20) | Y | POS솔루션 버전 |
+
+### ResponseBody
+
+|  |  |  |
+| --- | --- | --- |
+| **Parameter** | **Type** | **Description** |
+| posTid | string(11) | PAYCO가 관리하는 POS 단말 고유번호 |
+| apiKey | string(32) | Signature 생성을 위한 API Key |
+| merchantKey | string(20) | 가맹점 Key |
+| merchantName | string(30) | 가맹점 명 |
+
+### Examples
+
+POS 인증 요청문(Request)
+
+|  |
+| --- |
+| {      "posType" : "POS",      "vanCorpCode": "KCP",      "vanPosTid": "1002189853",      "registrationNumber": "1448115557"  "posDevCorpName" : "NHN PAYCO",  "posSolutionName" : "vCAT데몬 Solution",  "posSolutionVersion" : "ver 1.0.0.0",  } |
+
+POS 인증 요청 응답문(Response)
+
+|  |
+| --- |
+| {  "message": "OK",  "result": {  "posTid": "P1605109565",  "apiKey": "f571eaf60c0f51fb3f5a3840552294a2",  "merchantKey": "BEAGLEBEAGLE",  "merchantName": "비글샵"  },  "resultCode": 0  } |
+
+POS 인증 요청 실패 응답문(Response)
+
+예시1) 사업자 번호 불일치 시
+
+|  |
+| --- |
+| HTTP/1.1 200 OK  {  "message": "사업자번호 불일치, 확인 후 다시입력해주세요.",  "resultCode": 2001  } |
+
+예시1) TID 불일치 시
+
+|  |
+| --- |
+| HTTP/1.1 200 OK  {  "message": "TID 불일치, 확인 후 다시입력해주세요.",  "resultCode": 2001  } |
+
+## 결제 인증 요청 API
+
+|  |  |
+| --- | --- |
+| **Method** | **URI** |
+| POST | /auth/v1/authentication |
+
+### RequestBody
+
+|  |  |  |  |
+| --- | --- | --- | --- |
+| **Parameter** | **Type** | **Required** | **Description** |
+| tradeType | String(8) | Y | - 거래구분 - APPROVAL : 승인 - CANCEL : 취소 |
+| deviceAuthType | String(3) | Y | 단말기인증타입  BAR : 바코드 |
+| serviceType | String(10) | Y | 결제서비스 종류(“PAYCO” 고정) |
+| registrationNumber | String(10) | Y | 사업자등록번호 |
+| vanCorpCode | String(10) | Y | [VAN사 코드](#_VAN사_코드) |
+| vanPosTid | String(128) | Y | VAN사에서 발급한 단말기 번호 |
+| pinCode | String(21) | Y | PAYCO APP에서 스캔한 바코드  PAYCO OTC (One Time Card, 20~21byte의 문자열) |
+| totalAmount | double | Y | 상품 총결제금액 (컵보증금 포함) |
+| currency | string(3) | Y | 통화코드 “KRW” |
+| productName | string(100) | Y | 대표 상품명  (복수상품 선택 시 “대표 상품명 외 N건”) |
+| extras | object | Y | 추가정보 |
+| productInfoList | list | Y | 상품정보 list |
+| deviceType | String(10) | Y | 단말기 종류(POS, KIOSK, CAT) |
+| posTid | string(11) | Y | PAYCO가 관리하는 POS단말 고유번호  (서버간 통신의 경우 필수 아님) |
+| signature | string(44) | Y | 요청 정보 검증 값  (서버간 통신의 경우 필수 아님) |
+| approvalNo | string(20) | N | 승인번호(tradeType이 CANCEL인 경우 필수) |
+| approvalDatetime | string(14) | N | 승인일시(tradeType이 CANCEL인 경우 필수) |
+| approvalAmount | double | N | 승인금액(tradeType이 CANCEL인 경우 필수) |
+
+#### ㄴproductInfoList(상품정보 list)
+
+|  |  |  |  |
+| --- | --- | --- | --- |
+| **Parameter** | **Type** | **Required** | **Description** |
+| productCode | String(50) | Y | 상품코드 |
+| productName | String(50) | Y | 상품명 |
+| productUnitAmount | Double | Y | 상품단가 |
+| productQuantity | Integer | Y | 상품수량 |
+| promotionYn | String(1) | Y | PAYCO 프로모션 여부(Y/N) – Default ‘Y’  N인 경우 쿠폰 적용 불가 상품으로 판단 |
+
+#### ㄴ extras(추가정보)
+
+|  |  |  |  |
+| --- | --- | --- | --- |
+| **Parameter** | **Type** | **Required** | **Description** |
+| posDevCorpName | string(20) | Y | POS개발사 명 |
+| posSolutionName | string(20) | Y | POS솔루션 명 |
+| posSolutionVersion | string(20) | Y | POS솔루션 버전 |
+
+### ResponseBody
+
+|  |  |  |
+| --- | --- | --- |
+| **Parameter** | **Type** | **Description** |
+| tradeMethod | string(3) | 거래방식   - VAN : 가맹점 VAN망을 통해서 승인 - PG : PAYCO PG망을 통해서 승인 |
+| tradeRequestNo | string(16) | 거래요청번호 |
+| tradeNo | string(20) | PG/VAN사 거래번호 |
+| serviceType | String(10) | 결제서비스 종류 |
+| authDatetime | string(14) | 인증완료일시(yyyyMMddHHmmss) |
+| paymentMethodList | list | 결제수단 리스트 |
+| mainPaymentMethodCode | String(2) | 주 결제수단 코드 |
+| extras | object | 추가정보 |
+| couponList | list | 쿠폰 리스트(사용 가능한 쿠폰이 존재하는 경우만 응답) |
+| subServiceType | string(10) | 하위 결제서비스 코드 |
+| subServiceName | string(100) | 하위 결제서비스 이름 |
+| encOriginalPinCode | string(50) | 카드사에서 발행한 OTC(필요시 PAYCO 설정 필요)  직승인 혹은 가맹점 매입처리가 필요한 경우 별도 제공 |
+
+#### ㄴpaymentMethodList(결제수단 리스트)
+
+|  |  |  |
+| --- | --- | --- |
+| **Parameter** | **Type** | **Description** |
+| code | string(2) | [결제수단코드](#_결제수단_코드) |
+| name | string(100) | 결제수단명 |
+| maxAmount | double | 최대결제가능금액 |
+| minAmount | double | - 최소결제가능금액 |
+| conditionDiscountAmount | double | - 할인조건금액 |
+| approvalCompanyCode | string(5) | - 승인사코드 |
+| approvalCompanyName | string(100) | - 승인사이름 |
+| approvalCardNo | string(50) | 승인카드번호 |
+| restPointAmount | double | 잔여포인트금액 |
+
+#### ㄴcouponList(쿠폰 리스트)
+
+|  |  |  |
+| --- | --- | --- |
+| **Parameter** | **Type** | **Description** |
+| couponName | string | 쿠폰명 |
+| discountAmt | double | 할인금액 |
+| discountConditionAmt | double | 할인조건금액 |
+| couponId | Int | 쿠폰id |
+| paymentMethodCode | String(2) | 쿠폰 결제수단 코드 |
+| productCodeList | List | 쿠폰 발급 조건의 상품 코드 |
+
+### 카드사 OTC 암복호화 알고리즘
+
+Base64 인코딩 KISA_SEED_CBC(key, iv, value)
+
+• KISA SEED CBC
+
+- 인코딩은 EUC-KR
+
+- 암호화키는 별도로 안내드릴 예정입니다.
+
+- IV값은 16자리로 tradeRequestNo 활용
+
+- sample value
+
+임의의 암호화키(“T9JLzdYgscXenp68”), 거래요청번호(“20151023100001843”)
+
+37자리 카드사 OTC(“98347598435=394584954558”)
+
+64자리암호화값(“da/ZryxXe27l6c8Wa1DRK4ADYAExBk0Xfe6SZcYfX/sVmHySuH701dsZkYglL96L”)
+
+• KISA 홈페이지 URL
+
+<https://seed.kisa.or.kr/kisa/Board/17/detailView.do>
+
+### Example
+
+PAYCO(신용카드) 결제 인증 요청문(Request)
+
+|  |  |
+| --- | --- |
+| |  | | --- | | {  "registrationNumber":"1168143939",  "vanPosTid":"90071085",  "tradeType":"APPROVAL",  "serviceType":"PAYCO",  "vanCorpCode":"KIS",  "totalAmount":"1100",  "pinCode":"940701002275603295080",  "productName":"키위티셔츠외 2건",  "productInfoList":[  {  "productCode":"51100000016",  "productName":"키위티셔츠 XL",  "productQuantity":"1",  "productUnitAmount":"400",  "promotionYn":"Y"  },  {  "productCode":"51100000017",  "productName":"오렌지쥬스",  "productQuantity":"1",  "productUnitAmount":"400",  "promotionYn":"Y"  },  {  "productCode":"51100000010",  "productName":"환경보증금",  "productQuantity":"1",  "productUnitAmount":"300",  "promotionYn":"Y"  }  ],  "extras":{  "posDevCorpName":"NHN PAYCO",  "posSolutionName":"Payco Solution",  "posSolutionVersion":"Ver 1.0.0.0"  },  "currency":"KRW",  "deviceAuthType":"BAR",  "deviceType":"KIOSK"  } | |
+
+PAYCO(신용카드) 결제 인증 응답문(Response)
+
+|  |
+| --- |
+| {  "message": "OK",  "result": {  "tradeMethod": "VAN",  "tradeRequestNo": "2023032110475676",  "authDatetime": "20230321102614",  "serviceType": "PAYCO",  "paymentMethodList": [  {  "code": "10",  "name": "PAYCO 포인트",  "maxAmount": 1100.0,  "minAmount": 0.0,  "approvalCompanyCode": "NHN",  "approvalCompanyName": "NHN",  "conditionDiscountAmount": 0.0,  "approvalCardNo": "",  "restPointAmount": 407614.0,  "sourcePaymentMeansCode": null,  "installmentPeriod": null,  "includePointYn": null,  "productType": null,  "paidPointAmount": null,  "pointDiscountAmount": null,  "discountPolicySeq": null,  "discountPolicyRatio": null,  "discountPaidPointFamilyAmt": null,  "discountPolicyType": null,  "pointAcmAmt": null,  "additionalDiscountPointAcmAmt": null,  "additionalDiscountPolicySeq": null,  "additionalDiscountPolicyRatio": null,  "additionalDiscountPaidPointFamilyAmt": null,  "additionalDiscountPointDiscountAmt": null  },  {  "code": "00",  "name": "신용카드",  "maxAmount": 1100.0,  "minAmount": 0.0,  "approvalCompanyCode": "CCSU",  "approvalCompanyName": "수협카드",  "conditionDiscountAmount": 0.0,  "approvalCardNo": "940701******2789",  "restPointAmount": 0.0,  "sourcePaymentMeansCode": null,  "installmentPeriod": null,  "includePointYn": null,  "productType": null,  "paidPointAmount": null,  "pointDiscountAmount": null,  "discountPolicySeq": null,  "discountPolicyRatio": null,  "discountPaidPointFamilyAmt": null,  "discountPolicyType": null,  "pointAcmAmt": null,  "additionalDiscountPointAcmAmt": null,  "additionalDiscountPolicySeq": null,  "additionalDiscountPolicyRatio": null,  "additionalDiscountPaidPointFamilyAmt": null,  "additionalDiscountPointDiscountAmt": null  }  ],  "mainPaymentMethodCode": "00",  "businessName": "KIS테스트",  "subServiceType": "PAYCO",  "subServiceName": "페이코",  "encOriginalPinCode": "RtXfddEgep4fOS5SIWsIAaOcfiVF/Jhn/TmdyPCvdrp/Ps5WM0VDCDiJUsWgO0vu"  },  "resultCode": 0  } |
+
+PAYCO(신용카드+쿠폰) 결제 인증 요청문(Request)
+
+|  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| |  | | --- | | { | | "registrationNumber":"1168143939", | | "vanPosTid":"90071085", | | "tradeType":"APPROVAL", | | "serviceType":"PAYCO", | | "vanCorpCode":"KIS", | | "totalAmount":"20000", | | "pinCode":"940701204644113495014", | | "productName":"키위티셔츠외 1건", | | "productInfoList":[ | | { | | "productCode":"151100000016", | | "productName":"키위티셔츠 XL", | | "productQuantity":"1", | | "productUnitAmount":"10000", | | "promotionYn":"Y" | | }, | | { | | "productCode":"151100000017", | | "productName":"오렌지티셔츠 M", | | "productQuantity":"2", | | "productUnitAmount":"5000", | | "promotionYn":"Y" | | } | | ], | | "extras":{ | | "posDevCorpName":"NHN PAYCO", | | "posSolutionName":"vCAT데몬 Solution", | | "posSolutionVersion":"Ver 1.0.0.0" | | }, | | "currency":"KRW", | | "deviceAuthType":"BAR", | | "deviceType":"KIOSK" | | } | |
+
+PAYCO(신용카드+쿠폰) 결제 인증 응답문(Response)
+
+|  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| |  | | --- | | { | | "message":"OK", | | "result":{ | | "tradeMethod":"VAN", | | "tradeRequestNo":"2022011410442442", | | "authDatetime":"20220114122007", | | "serviceType":"PAYCO", | | "paymentMethodList":[ | | { | | "code":"20", | | "name":"페이코 쿠폰", | | "maxAmount":2500.0, | | "minAmount":2500.0, | | "approvalCompanyCode":"NHN", | | "approvalCompanyName":"NHN", | | "conditionDiscountAmount":0.0, | | "approvalCardNo":"400057814", | | "restPointAmount":0.0, | | "sourcePaymentMeansCode":*null*, | | "installmentPeriod":*null*, | | "includePointYn":*null*, | | "productType":*null*, | | "paidPointAmount":*null*, | | "pointDiscountAmount":*null*, | | "discountPolicySeq":*null*, | | "discountPolicyRatio":*null*, | | "discountPaidPointFamilyAmt":*null*, | | "discountPolicyType":*null*, | | "pointAcmAmt":*null*, | | "additionalDiscountPointAcmAmt":*null*, | | "additionalDiscountPolicySeq":*null*, | | "additionalDiscountPolicyRatio":*null*, | | "additionalDiscountPaidPointFamilyAmt":*null*, | | "additionalDiscountPointDiscountAmt":*null* | | }, | | { | | "code":"10", | | "name":"PAYCO 포인트", | | "maxAmount":17500.0, | | "minAmount":0.0, | | "approvalCompanyCode":"NHN", | | "approvalCompanyName":"NHN", | | "conditionDiscountAmount":0.0, | | "approvalCardNo":"", | | "restPointAmount":1434907.0, | | "sourcePaymentMeansCode":*null*, | | "installmentPeriod":*null*, | | "includePointYn":*null*, | | "productType":*null*, | | "paidPointAmount":*null*, | | "pointDiscountAmount":*null*, | | "discountPolicySeq":*null*, | | "discountPolicyRatio":*null*, | | "discountPaidPointFamilyAmt":*null*, | | "discountPolicyType":*null*, | | "pointAcmAmt":*null*, | | "additionalDiscountPointAcmAmt":*null*, | | "additionalDiscountPolicySeq":*null*, | | "additionalDiscountPolicyRatio":*null*, | | "additionalDiscountPaidPointFamilyAmt":*null*, | | "additionalDiscountPointDiscountAmt":*null* | | }, | | { | | "code":"00", | | "name":"신용카드", | | "maxAmount":20000.0, | | "minAmount":0.0, | | "approvalCompanyCode":"CCSU", | | "approvalCompanyName":"수협카드", | | "conditionDiscountAmount":0.0, | | "approvalCardNo":"940701******0478", | | "restPointAmount":0.0, | | "sourcePaymentMeansCode":*null*, | | "installmentPeriod":*null*, | | "includePointYn":*null*, | | "productType":*null*, | | "paidPointAmount":*null*, | | "pointDiscountAmount":*null*, | | "discountPolicySeq":*null*, | | "discountPolicyRatio":*null*, | | "discountPaidPointFamilyAmt":*null*, | | "discountPolicyType":*null*, | | "pointAcmAmt":*null*, | | "additionalDiscountPointAcmAmt":*null*, | | "additionalDiscountPolicySeq":*null*, | | "additionalDiscountPolicyRatio":*null*, | | "additionalDiscountPaidPointFamilyAmt":*null*, | | "additionalDiscountPointDiscountAmt":*null* | | } | | ], | | "mainPaymentMethodCode":"00", | | "couponList":[ | | { | | "couponName":"2천원 이상 결제 시 천원 할인", | | "discountAmt":1000.0, | | "discountConditionAmt":2000.0, | | "couponId":"15852", | | "paymentMethodCode":"75" | | }, | | { | | "couponName":"상품 쿠폰", | | "discountAmt":500.0, | | "discountConditionAmt":1000.0, | | "couponId":"501810", | | "paymentMethodCode":"78", | | "productCodeList":[ | | "151100000016" | | ] | | }, | | { | | "couponName":"상품 쿠폰", | | "discountAmt":500.0, | | "discountConditionAmt":1000.0, | | "couponId":"501810", | | "paymentMethodCode":"78", | | "productCodeList":[ | | "151100000017" | | ] | | }, | | { | | "couponName":"상품 쿠폰", | | "discountAmt":500.0, | | "discountConditionAmt":1000.0, | | "couponId":"501810", | | "paymentMethodCode":"78", | | "productCodeList":[ | | "151100000017" | | ] | | } | | ], | | "businessName":"KIS테스트", | | "subServiceType":"PAYCO", | | "subServiceName":"페이코", | | "encOriginalPinCode":"czO/JqWjOc5TbxEo5xGWwKjcnJyWgaKWCzDA3z33oBguuZUZCd7LgRT61MChM6ce" | | }, | | "resultCode":0 | | } | |
+
+PAYCO(신용카드 0원결제) 결제 인증 요청문(Request)
+
+|  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| |  | | --- | | { | | "registrationNumber":"1168143939", | | "vanPosTid":"90071085", | | "tradeType":"APPROVAL", | | "serviceType":"PAYCO", | | "vanCorpCode":"KIS", | | "totalAmount":"4000", | | "pinCode":"940701204648917295014", | | "productName":"키위티셔츠외 1건", | | "productInfoList":[ | | { | | "productCode":"151100000016", | | "productName":"키위티셔츠 XL", | | "productQuantity":"1", | | "productUnitAmount":"2000", | | "promotionYn":"Y" | | }, | | { | | "productCode":"151100000017", | | "productName":"오렌지티셔츠 M", | | "productQuantity":"1", | | "productUnitAmount":"2000", | | "promotionYn":"Y" | | } | | ], | | "extras":{ | | "posDevCorpName":"NHN PAYCO", | | "posSolutionName":"vCAT데몬 Solution", | | "posSolutionVersion":"Ver 1.0.0.0" | | }, | | "currency":"KRW", | | "deviceAuthType":"BAR", | | "deviceType":"KIOSK" | | } | |
+
+PAYCO(신용카드 0원결제) 결제 인증 응답문(Response)
+
+|  |  |
+| --- | --- |
+| |  | | --- | | {  "message": "OK",  "result": {  "tradeMethod": "VAN",  "tradeRequestNo": "2023062910480263",  "authDatetime": "20230629120742",  "serviceType": "PAYCO",  "paymentMethodList": [  {  "code": "20",  "name": "페이코 쿠폰",  "maxAmount": 4000.0,  "minAmount": 4000.0,  "approvalCompanyCode": "PBIZ",  "approvalCompanyName": "PAYCO비즈플러스",  "conditionDiscountAmount": 0.0,  "approvalCardNo": "300100558",  "restPointAmount": 0.0,  "sourcePaymentMeansCode": null,  "installmentPeriod": null,  "includePointYn": null,  "productType": null,  "paidPointAmount": null,  "pointDiscountAmount": null,  "discountPolicySeq": null,  "discountPolicyRatio": null,  "discountPaidPointFamilyAmt": null,  "discountPolicyType": null,  "pointAcmAmt": null,  "additionalDiscountPointAcmAmt": null,  "additionalDiscountPolicySeq": null,  "additionalDiscountPolicyRatio": null,  "additionalDiscountPaidPointFamilyAmt": null,  "additionalDiscountPointDiscountAmt": null  },  {  "code": "10",  "name": "PAYCO 포인트",  "maxAmount": 0.0,  "minAmount": 0.0,  "approvalCompanyCode": "NHN",  "approvalCompanyName": "NHN",  "conditionDiscountAmount": 0.0,  "approvalCardNo": "",  "restPointAmount": 340764.0,  "sourcePaymentMeansCode": null,  "installmentPeriod": null,  "includePointYn": null,  "productType": null,  "paidPointAmount": null,  "pointDiscountAmount": null,  "discountPolicySeq": null,  "discountPolicyRatio": null,  "discountPaidPointFamilyAmt": null,  "discountPolicyType": null,  "pointAcmAmt": null,  "additionalDiscountPointAcmAmt": null,  "additionalDiscountPolicySeq": null,  "additionalDiscountPolicyRatio": null,  "additionalDiscountPaidPointFamilyAmt": null,  "additionalDiscountPointDiscountAmt": null  },  {  "code": "00",  "name": "신용카드",  "maxAmount": 4000.0,  "minAmount": 0.0,  "approvalCompanyCode": "CCSU",  "approvalCompanyName": "수협카드",  "conditionDiscountAmount": 0.0,  "approvalCardNo": "940701******2789",  "restPointAmount": 0.0,  "sourcePaymentMeansCode": null,  "installmentPeriod": null,  "includePointYn": null,  "productType": null,  "paidPointAmount": null,  "pointDiscountAmount": null,  "discountPolicySeq": null,  "discountPolicyRatio": null,  "discountPaidPointFamilyAmt": null,  "discountPolicyType": null,  "pointAcmAmt": null,  "additionalDiscountPointAcmAmt": null,  "additionalDiscountPolicySeq": null,  "additionalDiscountPolicyRatio": null,  "additionalDiscountPaidPointFamilyAmt": null,  "additionalDiscountPointDiscountAmt": null  }  ],  "mainPaymentMethodCode": "00",  "couponList": [  {  "couponName": "테스트용 식권(10,000원)",  "discountAmt": 3000.0,  "discountConditionAmt": 3000.0,  "couponId": "15746",  "paymentMethodCode": "70"  },  {  "couponName": "상품 쿠폰",  "discountAmt": 500.0,  "discountConditionAmt": 1000.0,  "couponId": "501810",  "paymentMethodCode": "78",  "productCodeList": [  "151100000016"  ]  },  {  "couponName": "상품 쿠폰",  "discountAmt": 500.0,  "discountConditionAmt": 1000.0,  "couponId": "501810",  "paymentMethodCode": "78",  "productCodeList": [  "151100000017"  ]  }  ],  "businessName": "KIS테스트",  "subServiceType": "PAYCO",  "subServiceName": "페이코",  "encOriginalPinCode": "jsMqxjIVnYUPCpcOCg1oys2idVIJQqF5NHwhb3lDzLrluJJr2ugRLjHI1xlhO9Sx"  },  "resultCode": 0  } | |
+
+PAYCO(포인트) 결제 인증 요청문(Request)
+
+|  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| |  | | --- | | { | | "registrationNumber":"1168143939", | | "vanPosTid":"90071085", | | "tradeType":"APPROVAL", | | "serviceType":"PAYCO", | | "vanCorpCode":"KIS", | | "totalAmount":"800", | | "pinCode":"20136301254384649591", | | "productName":"키위티셔츠외 1건", | | "productInfoList":[ | | { | | "productCode":"151100000016", | | "productName":"키위티셔츠 XL", | | "productQuantity":"1", | | "productUnitAmount":"400", | | "promotionYn":"Y" | | }, | | { | | "productCode":"151100000017", | | "productName":"오렌지티셔츠 M", | | "productQuantity":"1", | | "productUnitAmount":"400", | | "promotionYn":"Y" | | } | | ], | | "extras":{ | | "posDevCorpName":"NHN PAYCO", | | "posSolutionName":"vCAT데몬 Solution", | | "posSolutionVersion":"Ver 1.0.0.0" | | }, | | "currency":"KRW", | | "deviceAuthType":"BAR", | | "deviceType":"KIOSK" | | } | |
+
+PAYCO(포인트) 결제 인증 응답문(Response)
+
+|  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| |  | | --- | | { | | "message":"OK", | | "result":{ | | "tradeMethod":"VAN", | | "tradeRequestNo":"2022011410442462", | | "authDatetime":"20220114155031", | | "serviceType":"PAYCO", | | "paymentMethodList":[ | | { | | "code":"10", | | "name":"페이코 포인트", | | "maxAmount":800.0, | | "minAmount":800.0, | | "approvalCompanyCode":"NHN", | | "approvalCompanyName":"NHN", | | "conditionDiscountAmount":800.0, | | "approvalCardNo":"", | | "restPointAmount":1434907.0, | | "sourcePaymentMeansCode":*null*, | | "installmentPeriod":*null*, | | "includePointYn":*null*, | | "productType":*null*, | | "paidPointAmount":*null*, | | "pointDiscountAmount":*null*, | | "discountPolicySeq":*null*, | | "discountPolicyRatio":*null*, | | "discountPaidPointFamilyAmt":*null*, | | "discountPolicyType":*null*, | | "pointAcmAmt":*null*, | | "additionalDiscountPointAcmAmt":*null*, | | "additionalDiscountPolicySeq":*null*, | | "additionalDiscountPolicyRatio":*null*, | | "additionalDiscountPaidPointFamilyAmt":*null*, | | "additionalDiscountPointDiscountAmt":*null* | | } | | ], | | "mainPaymentMethodCode":"10", | | "businessName":"KIS테스트", | | "subServiceType":"PAYCO", | | "subServiceName":"페이코" | | }, | | "resultCode":0 | | } | |
+
+PAYCO(포인트+쿠폰) 결제 인증 요청문(Request)
+
+|  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| |  | | --- | | { | | "registrationNumber":"1168143939", | | "vanPosTid":"90071085", | | "tradeType":"APPROVAL", | | "serviceType":"PAYCO", | | "vanCorpCode":"KIS", | | "totalAmount":"20000", | | "pinCode":"20792904282752009598", | | "productName":"키위티셔츠외 1건", | | "productInfoList":[ | | { | | "productCode":"151100000016", | | "productName":"키위티셔츠 XL", | | "productQuantity":"1", | | "productUnitAmount":"10000", | | "promotionYn":"Y" | | }, | | { | | "productCode":"151100000017", | | "productName":"오렌지티셔츠 M", | | "productQuantity":"2", | | "productUnitAmount":"5000", | | "promotionYn":"Y" | | } | | ], | | "extras":{ | | "posDevCorpName":"NHN PAYCO", | | "posSolutionName":"vCAT데몬 Solution", | | "posSolutionVersion":"Ver 1.0.0.0" | | }, | | "currency":"KRW", | | "deviceAuthType":"BAR", | | "deviceType":"KIOSK" | | } | |
+
+PAYCO(포인트+쿠폰) 결제 인증 응답문(Response)
+
+|  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| |  | | --- | | { | | "message":"OK", | | "result":{ | | "tradeMethod":"VAN", | | "tradeRequestNo":"2022011410442443", | | "authDatetime":"20220114124216", | | "serviceType":"PAYCO", | | "paymentMethodList":[ | | { | | "code":"20", | | "name":"페이코 쿠폰", | | "maxAmount":2500.0, | | "minAmount":2500.0, | | "approvalCompanyCode":"NHN", | | "approvalCompanyName":"NHN", | | "conditionDiscountAmount":0.0, | | "approvalCardNo":*null*, | | "restPointAmount":0.0, | | "sourcePaymentMeansCode":*null*, | | "installmentPeriod":*null*, | | "includePointYn":*null*, | | "productType":*null*, | | "paidPointAmount":*null*, | | "pointDiscountAmount":*null*, | | "discountPolicySeq":*null*, | | "discountPolicyRatio":*null*, | | "discountPaidPointFamilyAmt":*null*, | | "discountPolicyType":*null*, | | "pointAcmAmt":*null*, | | "additionalDiscountPointAcmAmt":*null*, | | "additionalDiscountPolicySeq":*null*, | | "additionalDiscountPolicyRatio":*null*, | | "additionalDiscountPaidPointFamilyAmt":*null*, | | "additionalDiscountPointDiscountAmt":*null* | | }, | | { | | "code":"10", | | "name":"페이코 포인트", | | "maxAmount":17500.0, | | "minAmount":17500.0, | | "approvalCompanyCode":"NHN", | | "approvalCompanyName":"NHN", | | "conditionDiscountAmount":20000.0, | | "approvalCardNo":"", | | "restPointAmount":1434907.0, | | "sourcePaymentMeansCode":*null*, | | "installmentPeriod":*null*, | | "includePointYn":*null*, | | "productType":*null*, | | "paidPointAmount":*null*, | | "pointDiscountAmount":*null*, | | "discountPolicySeq":*null*, | | "discountPolicyRatio":*null*, | | "discountPaidPointFamilyAmt":*null*, | | "discountPolicyType":*null*, | | "pointAcmAmt":*null*, | | "additionalDiscountPointAcmAmt":*null*, | | "additionalDiscountPolicySeq":null, | | "additionalDiscountPolicyRatio":null, | | "additionalDiscountPaidPointFamilyAmt":null, | | "additionalDiscountPointDiscountAmt":null | | } | | ], | | "mainPaymentMethodCode":"10", | | "couponList":[ | | { | | "couponName":"상품 쿠폰", | | "discountAmt":500.0, | | "discountConditionAmt":1000.0, | | "couponId":"501810", | | "paymentMethodCode":"78", | | "productCodeList":[ | | "151100000016" | | ] | | }, | | { | | "couponName":"상품 쿠폰", | | "discountAmt":500.0, | | "discountConditionAmt":1000.0, | | "couponId":"501810", | | "paymentMethodCode":"78", | | "productCodeList":[ | | "151100000017" | | ] | | }, | | { | | "couponName":"상품 쿠폰", | | "discountAmt":500.0, | | "discountConditionAmt":1000.0, | | "couponId":"501810", | | "paymentMethodCode":"78", | | "productCodeList":[ | | "151100000017" | | ] | | }, | | { | | "couponName":"2천원 이상 결제 시 천원 할인", | | "discountAmt":1000.0, | | "discountConditionAmt":2000.0, | | "couponId":"15852", | | "paymentMethodCode":"75" | | } | | ], | | "businessName":"KIS테스트", | | "subServiceType":"PAYCO", | | "subServiceName":"페이코" | | }, | | "resultCode":0 | | } | |
+
+PAYCO(포인트 0원결제) 결제 인증 요청문(Request)
+
+|  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| |  | | --- | | { | | "registrationNumber":"1168143939", | | "vanPosTid":"90071085", | | "tradeType":"APPROVAL", | | "serviceType":"PAYCO", | | "vanCorpCode":"KIS", | | "totalAmount":"4000", | | "pinCode":"20936000918840329598", | | "productName":"키위티셔츠외 1건", | | "productInfoList":[ | | { | | "productCode":"151100000016", | | "productName":"키위티셔츠 XL", | | "productQuantity":"1", | | "productUnitAmount":"2000", | | "promotionYn":"Y" | | }, | | { | | "productCode":"151100000017", | | "productName":"오렌지티셔츠 M", | | "productQuantity":"1", | | "productUnitAmount":"2000", | | "promotionYn":"Y" | | } | | ], | | "extras":{ | | "posDevCorpName":"NHN PAYCO", | | "posSolutionName":"vCAT데몬 Solution", | | "posSolutionVersion":"Ver 1.0.0.0" | | }, | | "currency":"KRW", | | "deviceAuthType":"BAR", | | "deviceType":"KIOSK" | | } | |
+
+PAYCO(포인트 0원결제) 결제 인증 응답문(Response)
+
+|  |  |  |
+| --- | --- | --- |
+| |  |  | | --- | --- | | |  | | --- | | {  "message": "OK",  "result": {  "tradeMethod": "VAN",  "tradeRequestNo": "2023062910480265",  "authDatetime": "20230629140343",  "serviceType": "PAYCO",  "paymentMethodList": [  {  "code": "20",  "name": "페이코 쿠폰",  "maxAmount": 4000.0,  "minAmount": 4000.0,  "approvalCompanyCode": "NHN",  "approvalCompanyName": "NHN",  "conditionDiscountAmount": 0.0,  "approvalCardNo": null,  "restPointAmount": 0.0,  "sourcePaymentMeansCode": null,  "installmentPeriod": null,  "includePointYn": null,  "productType": null,  "paidPointAmount": null,  "pointDiscountAmount": null,  "discountPolicySeq": null,  "discountPolicyRatio": null,  "discountPaidPointFamilyAmt": null,  "discountPolicyType": null,  "pointAcmAmt": null,  "additionalDiscountPointAcmAmt": null,  "additionalDiscountPolicySeq": null,  "additionalDiscountPolicyRatio": null,  "additionalDiscountPaidPointFamilyAmt": null,  "additionalDiscountPointDiscountAmt": null  },  {  "code": "10",  "name": "페이코 포인트",  "maxAmount": 0.0,  "minAmount": 0.0,  "approvalCompanyCode": "NHN",  "approvalCompanyName": "NHN",  "conditionDiscountAmount": 4000.0,  "approvalCardNo": "",  "restPointAmount": 340764.0,  "sourcePaymentMeansCode": null,  "installmentPeriod": null,  "includePointYn": null,  "productType": null,  "paidPointAmount": null,  "pointDiscountAmount": null,  "discountPolicySeq": null,  "discountPolicyRatio": null,  "discountPaidPointFamilyAmt": null,  "discountPolicyType": null,  "pointAcmAmt": null,  "additionalDiscountPointAcmAmt": null,  "additionalDiscountPolicySeq": null,  "additionalDiscountPolicyRatio": null,  "additionalDiscountPaidPointFamilyAmt": null,  "additionalDiscountPointDiscountAmt": null  }  ],  "mainPaymentMethodCode": "10",  "couponList": [  {  "couponName": "상품 쿠폰",  "discountAmt": 500.0,  "discountConditionAmt": 1000.0,  "couponId": "501810",  "paymentMethodCode": "78",  "productCodeList": [  "151100000016"  ]  },  {  "couponName": "상품 쿠폰",  "discountAmt": 500.0,  "discountConditionAmt": 1000.0,  "couponId": "501810",  "paymentMethodCode": "78",  "productCodeList": [  "151100000017"  ]  },  {  "couponName": "테스트용 식권(10,000원)",  "discountAmt": 3000.0,  "discountConditionAmt": 3000.0,  "couponId": "15746",  "paymentMethodCode": "70"  }  ],  "businessName": "KIS테스트",  "subServiceType": "PAYCO",  "subServiceName": "페이코"  },  "resultCode": 0  } | | |
+
+PAYCO(식권쿠폰) 결제 인증 요청문(Request)
+
+|  |  |
+| --- | --- |
+| |  | | --- | | {  "registrationNumber":"1168143939",  "vanPosTid":"90071085",  "tradeType":"APPROVAL",  "serviceType":"PAYCO",  "vanCorpCode":"KIS",  "totalAmount":"1000",  "pinCode":"10808633206474279581",  "productName":"키위티셔츠외 1건",  "productInfoList":[  {  "productCode":"151100000016",  "productName":"키위티셔츠 XL",  "productQuantity":"1",  "productUnitAmount":"500",  "promotionYn":"Y"  },  {  "productCode":"151100000017",  "productName":"오렌지티셔츠 M",  "productQuantity":"1",  "productUnitAmount":"500",  "promotionYn":"Y"  }  ],  "extras":{  "posDevCorpName":"NHN PAYCO",  "posSolutionName":"vCAT데몬 Solution",  "posSolutionVersion":"Ver 1.0.0.0"  },  "currency":"KRW",  "deviceAuthType":"BAR",  "deviceType":"KIOSK"  } | |
+
+PAYCO(식권쿠폰) 결제 인증 응답문(Response)
+
+|  |  |
+| --- | --- |
+| |  | | --- | | {  "message": "OK",  "result": {  "tradeMethod": "VAN",  "tradeRequestNo": "2023062910480266",  "authDatetime": "20230629143659",  "serviceType": "PAYCO",  "paymentMethodList": [  {  "code": "20",  "name": "페이코 쿠폰",  "maxAmount": 1000.0,  "minAmount": 0.0,  "approvalCompanyCode": "PBIZ",  "approvalCompanyName": "PAYCO비즈플러스",  "conditionDiscountAmount": 0.0,  "approvalCardNo": "",  "restPointAmount": 0.0,  "sourcePaymentMeansCode": null,  "installmentPeriod": null,  "includePointYn": null,  "productType": null,  "paidPointAmount": null,  "pointDiscountAmount": null,  "discountPolicySeq": null,  "discountPolicyRatio": null,  "discountPaidPointFamilyAmt": null,  "discountPolicyType": null,  "pointAcmAmt": null,  "additionalDiscountPointAcmAmt": null,  "additionalDiscountPolicySeq": null,  "additionalDiscountPolicyRatio": null,  "additionalDiscountPaidPointFamilyAmt": null,  "additionalDiscountPointDiscountAmt": null  }  ],  "mainPaymentMethodCode": "20",  "couponList": [  {  "couponName": "테스트용 식권(10,000원)",  "discountAmt": 0.0,  "discountConditionAmt": 0.0,  "couponId": "15746",  "paymentMethodCode": "70"  }  ],  "businessName": "KIS테스트",  "subServiceType": "PAYCO",  "subServiceName": "페이코"  },  "resultCode": 0  } | |
+
+## 결제 승인 요청 API
+
+|  |  |
+| --- | --- |
+| **Method** | **URI** |
+| POST | /payment/v1/approval |
+
+### RequestBody
+
+|  |  |  |  |
+| --- | --- | --- | --- |
+| **Parameter** | **Type** | **Required** | **Description** |
+| tradeRequestNo | string(16) | Y | 거래요청번호 |
+| authDatetime | string(14) | Y | 인증완료일시(yyyyMMddHHmmss) |
+| tradeMethod | string(3) | Y | 거래방식  PG : PAYCO PG망을 통해서 승인  VAN : 가맹점 VAN망을 통해서 승인 |
+| deviceAuthType | string(3) | Y | 단말기인증타입   - BAR : 바코드 |
+| serviceType | string(10) | Y | 결제서비스 종류(“PAYCO” 고정) |
+| registrationNumber | string(10) | Y | 사업자등록번호 |
+| vanCorpCode | string(10) | Y | [VAN사 코드](#_VAN사_코드) |
+| vanPosTid | string(128) | Y | VAN사에서 발급한 단말기 번호 |
+| ktcCertNo | string(32) | N | ktc단말인증 번호 |
+| pinCode | string(21) | Y | PAYCO APP에서 스캔한 바코드   - PAYCO OTC (One Time Card, 20~21byte의 문자열) |
+| totalAmount | double | Y | 상품 총결제액 (컵보증금 포함) |
+| enableTaxable | boolean | N | 과세 금액 적용 여부  - true: 세금관련 파라미터의 값을 요청받은 대로 처리. 단, 총 결제금액과 세금관련 파라미터의 합이 일치하지 않은 경우 false로 판단하여 처리  - false : 페이코에서 자체적으로 과세, 부가세로 계산하여 처리 |
+| totalTaxfreeAmount | double | N | - 면세금액 |
+| totalTaxableAmount | double | N | 과세금액 |
+| totalVatAmount | double | N | 부가세 |
+| totalServiceAmount | double | N | 봉사료 |
+| totalGreenDepositAmount | double | N | 컵보증금 |
+| currency | string(3) | Y | 통화코드 “KRW” |
+| productName | string(100) | Y | 대표 상품명  (복수상품 선택 시 “대표 상품명 외 N건”) |
+| approvalTargetList | list | Y | 승인대상 list |
+| deviceType | String(10) | Y | 요청단말의 타입  - POS, KIOSK, CAT |
+| directCardApprovalYN | string(1) | N | 직승인 거래여부  (Y인 경우 PAYCO에서 승인처리를 하지 않고, 결과 등록만 진행) |
+| extras | object | N | 추가정보(스마트로 VAN 사용 시 필수) |
+| sign | object | N | 서명 정보(5만원 초과 VAN 결제 시 필수) |
+| settlementYmd | string(8) | N | 정산 기준일(YYYYMMDD) |
+| posTid | string(11) | Y | PAYCO가 관리하는 POS단말 고유번호  (서버간 통신의 경우 필수 아님) |
+| signature | string(44) | Y | 요청 정보 검증 값  (서버간 통신의 경우 필수 아님) |
+
+#### ㄴapprovalTargetList(승인대상 list)
+
+|  |  |  |  |
+| --- | --- | --- | --- |
+| **Parameter** | **Type** | **Required** | **Description** |
+| paymentMethodCode | string(2) | Y | [결제수단코드](#_결제수단_코드) |
+| approvalAmount | double | Y | 승인금액 |
+| installmentPeriod | string(2) | Y | 할부기간 |
+| cardApprovalNo | string(20) | N | 카드사에서 승인 응답으로 전달받은 승인번호  (directCardApprovalYN = Y인 경우 필수) |
+| cardApprovalDatetime | string(14) | N | 카드사에서 승인 응답으로 전달받은 승인일시  (directCardApprovalYN = Y인 경우 필수) |
+| cardApprovalCompanyCode | string(5) | N | 승인사 코드 (공통코드 참고)  (directCardApprovalYN = Y인 경우 필수) |
+
+#### ㄴextras(추가 정보)
+
+**SMARTRO VAN 승인요청시 추가정보**
+
+|  |  |  |  |
+| --- | --- | --- | --- |
+| **Parameter** | **Type** | **Required** | **Description** |
+| merchantCode | string(10) | Y | 업체(가맹점) 코드  ㄴ 대형 가맹점의 경우 VAN사에서 코드값 확인  ㄴ 일반 가맹점의 경우 ”SPOS”  ㄴ 아래와 같은경우 “VCAT”  1. 스마트로 서명 전문내 부가정보코드 필드 “SNTS” 셋팅하는 경우  2. 스마트로 VCAT 을 사용하는 경우 |
+| posEntryMode | string(10) | N | PosEntry모드 |
+
+#### ㄴsign(서명 정보)
+
+서명 정보의 경우 각각의 VAN사에서 제공한 모듈 및 API 를 이용하여 해당
+
+파라미터를 전달합니다.
+
+**KCP 서명 추가정보**
+
+|  |  |  |  |
+| --- | --- | --- | --- |
+| **Parameter** | **Type** | **Required** | **Description** |
+| signpadYN | string(1) | Y | 사인패드부착여부 |
+| signLength | string(4) | Y | 사인데이타 정보 길이 |
+| signData | string(2048) | Y | 사인데이타 정보 |
+| signpadVanCorpCode | string(10) | Y | 사인패드 VAN사 코드 |
+
+**SPC 서명 추가정보**
+
+|  |  |  |  |
+| --- | --- | --- | --- |
+| **Parameter** | **Type** | **Required** | **Description** |
+| signData | string(1655) | Y | 사인데이타 정보 |
+| signpadVanCorpCode | string(10) | Y | 사인패드 VAN사 코드 |
+
+**JTNET 서명 추가정보**
+
+|  |  |  |  |
+| --- | --- | --- | --- |
+| **Parameter** | **Type** | **Required** | **Description** |
+| signpadYN | string(1) | Y | 사인패드부착여부 |
+| signLength | string(4) | Y | 사인데이타 정보 길이 |
+| signData | string(2048) | Y | 사인데이타 정보 |
+| signpadVanCorpCode | string(10) | Y | 사인패드 VAN사 코드 |
+
+**SMARTRO 서명 추가정보**
+
+|  |  |  |  |
+| --- | --- | --- | --- |
+| **Parameter** | **Type** | **Required** | **Description** |
+| signpadYN | string(1) | Y | 사인패드부착여부(서명여부) (S/N) |
+| signImageInfo | string(6) | Y | 사인이미지정보 |
+| signImageData | string(1540) | Y | 사인이미지데이터 |
+| signDeviceNo | string(16) | Y | 사인패드 기기번호 |
+| signHashCode | string(32) | Y | 해쉬코드 |
+| signpadVanCorpCode | string(10) | Y | 사인패드 VAN사 코드 |
+
+**FDIK 서명 추가정보**
+
+|  |  |  |  |
+| --- | --- | --- | --- |
+| **Parameter** | **Type** | **Required** | **Description** |
+| signCompressedKind | string(2) | Y | sign 압축방식 |
+| signHashCode | string(32) | Y | sign mac value |
+| signData | string(1342) | Y | 서명데이터 |
+| signpadVanCorpCode | string(10) | Y | 사인패드 VAN사 코드 |
+
+- **전자서명 시 Card Data 생성방법** : CatID(8) + 거래일련번호(6) + '00'
+
+거래일련번호는 tradeRequestNo 값을 사용하며 승인요청시 전달하는 tradeRequestNo 값 16자리중 뒤 6자리를 사용합니다. Ex) ' tradeRequestNo' : '2019110710803133' => 803133
+
+tradeRequestNo 값을 POS에 저장하여 취소시에도 사용해 주세요.
+
+**NICE 서명 추가정보**
+
+|  |  |  |  |
+| --- | --- | --- | --- |
+| **Parameter** | **Type** | **Required** | **Description** |
+| signData | string(1084) | Y | 사인데이타 정보 |
+| signpadVanCorpCode | string(10) | Y | 사인패드 VAN사 코드 |
+
+**KOCES 서명 추가정보**
+
+|  |  |  |  |
+| --- | --- | --- | --- |
+| **Parameter** | **Type** | **Required** | **Description** |
+| signLength | string(4) | Y | 사인데이타 정보 길이 |
+| signData | string(1086) | Y | 사인데이타 정보 |
+| signpadVanCorpCode | string(10) | Y | 사인패드 VAN사 코드 |
+
+**KIS 서명 추가정보**
+
+|  |  |  |  |
+| --- | --- | --- | --- |
+| **Parameter** | **Type** | **Required** | **Description** |
+| signpadYN | string(1) | Y | 사인패드부착여부 |
+| signLength | string(4) | Y | 사인데이타 정보 길이 |
+| signData | string(2048) | Y | 사인데이타 정보 |
+| signpadVanCorpCode | string(10) | Y | 사인패드 VAN사 코드 |
+
+**KOVAN 서명 추가정보**
+
+|  |  |  |  |
+| --- | --- | --- | --- |
+| **Parameter** | **Type** | **Required** | **Description** |
+| signpadYN | string(1) | Y | 사인패드부착여부 |
+| signLength | string(4) | Y | 사인데이타 정보 길이 |
+| signData | string(2048) | Y | 사인데이타 정보 |
+| signpadVanCorpCode | string(10) | Y | 사인패드 VAN사 코드 |
+
+**DAU 서명 추가정보**
+
+|  |  |  |  |
+| --- | --- | --- | --- |
+| **Parameter** | **Type** | **Required** | **Description** |
+| signpadYN | string(1) | Y | 사인패드부착여부 |
+| signLength | string(4) | Y | 사인데이타 정보 길이 |
+| signData | string(2048) | Y | 사인데이타 정보 |
+| signpadVanCorpCode | string(10) | Y | 사인패드 VAN사 코드 |
+
+**KSNET 서명 추가정보**
+
+|  |  |  |  |
+| --- | --- | --- | --- |
+| **Parameter** | **Type** | **Required** | **Description** |
+| signEncKeyIndex | string(2) | Y | 전자서명암호화 Working key index(00~99) |
+| signLength | string(4) | Y | 사인데이타 정보 길이 |
+| signData | string(2048) | Y | 사인데이타 정보 |
+| signpadVanCorpCode | string(10) | Y | 사인패드 VAN사 코드 |
+
+**KICC 서명 추가정보**
+
+|  |  |  |  |
+| --- | --- | --- | --- |
+| **Parameter** | **Type** | **Required** | **Description** |
+| signData | string(591) | Y | 사인데이타 정보 |
+
+### ResponseBody
+
+|  |  |  |
+| --- | --- | --- |
+| **Parameter** | **Type** | **Description** |
+| tradeRequestNo | string(16) | 거래요청번호 |
+| tradeNo | string(20) | PG/VAN사 거래번호 |
+| tradeDatetime | string(14) | PG/VAN사 거래일시(yyyyMMddHHmmss) |
+| totalTaxfreeAmount | double | 총 면세금액 |
+| totalTaxableAmount | double | 총 과세금액 |
+| totalVatAmount | double | 총 부가세 |
+| totalServiceAmount | double | 총 봉사료 |
+| totalGreenDepositAmount | double | 총 컵보증금 |
+| approvalResultList | list | 승인결과 list |
+| extras | object | 추가정보 |
+| membershipCardNo | String(40) | 멤버십카드번호(PAYCO에 제휴사 멤버십이 등록된 경우) |
+| encOriginalPinCode | string(50) | 카드사 OTC |
+
+#### ㄴapprovalResultList(결제 승인시 결제수단별 정보)
+
+|  |  |  |
+| --- | --- | --- |
+| **Parameter** | **Type** | **Description** |
+| paymentMethodCode | string(2) | [결제수단코드](#_결제수단_코드) |
+| paymentMethodName | string(100) | 결제수단명 |
+| approvalNo | string(20) | 승인번호 |
+| approvalDatetime | string(14) | 승인일시(yyyyMMddHHmmss) |
+| approvalAmount | double | 승인금액 |
+| approvalCompanyCode | string(5) | [승인사코드](#_KCP_승인사/매입사_매핑) |
+| approvalCompanyName | string(100) | [승인사명](#_KCP_승인사/매입사_매핑) |
+| approvalCardNo | string(50) | 승인카드번호 |
+| sourcePaymentMethdCode | String(2) | 원천사결제수단코드 (페이코결제수단코드) |
+| installmentPeriod | string(5) | 할부개월수 |
+| taxfreeAmount | double | 면세금액 |
+| taxableAmount | double | 과세금액 |
+| vatAmount | double | 부가세 |
+| serviceAmount | double | 봉사료 |
+| greenDepositAmount | double | 컵보증금 |
+| vanApprovalCompanyCode | string(5) | VAN사에서 전달받은 승인사코드 |
+| vanApprovalCompanyName | string(100) | VAN사에서 전달받은 승인사명 |
+
+#### ㄴextras(VAN 승인시 추가정보)
+
+**VAN 승인시 공통으로 받는 추가정보**
+
+|  |  |  |
+| --- | --- | --- |
+| **Parameter** | **Type** | **Description** |
+| buyCompanyName | string(12) | 매입사명 |
+| buyCompanyCode | string(12) | 매입사코드 |
+| cardMerchantNo | string(15) | 카드 가맹점 번호 |
+| buyTypeName | string(50) | 매입방법명 |
+| nocvmYN | string(1) | NoCVM 거래여부 |
+
+### Example
+
+PAYCO(신용카드) 결제 승인 요청문(Request)
+
+|  |  |
+| --- | --- |
+| |  | | --- | | {  "tradeRequestNo":"2023032110475676",  "authDatetime":"20230321102614",  "tradeMethod":"VAN",  "deviceAuthType":"BAR",  "deviceType":"KIOSK",  "serviceType":"PAYCO",  "registrationNumber":"1168143939",  "vanCorpCode":"KIS",  "vanPosTid":"90071085",  "pinCode":"940701002275603295080",  "totalAmount":"1100",  "totalGreenDepositAmount" : "300",  "directCardApprovalYN":"N",  "currency":"KRW",  "productName":"키위티셔츠외 3건",  "approvalTargetList":[  {  "paymentMethodCode":"00",  "installmentPeriod":"00",  "approvalAmount":"1100"  },  {  "paymentMethodCode":"10",  "approvalAmount":"0"  },  {  "paymentMethodCode":"20",  "approvalAmount":"0"  }  ]  } | |
+
+PAYCO(신용카드) 결제 승인 응답문(Response)
+
+|  |  |  |
+| --- | --- | --- |
+| |  | | --- | | {  "message": "OK",  "result": {  "tradeNo": "21102724",  "tradeDatetime": "20230321102724",  "totalTaxfreeAmount": 0.0,  "totalTaxableAmount": 727.0,  "totalVatAmount": 73.0,  "totalServiceAmount": 0.0,  "totalGreenDepositAmount": 300.0,  "approvalResultList": [  {  "paymentMethodCode": "00",  "paymentMethodName": "신용카드",  "approvalNo": "21102724",  "approvalDatetime": "20230321102724",  "approvalAmount": 1100.0,  "approvalCompanyCode": "CCSU",  "approvalCompanyName": "수협카드",  "approvalCardNo": "940701******2789",  "sourcePaymentMethdCode": "37",  "installmentPeriod": "00",  "taxfreeAmount": 0.0,  "taxableAmount": 727.0,  "vatAmount": 73.0,  "serviceAmount": 0.0,  "greenDepositAmount": 300.0,  "vanApprovalCompanyCode": "01",  "vanApprovalCompanyName": "비씨카드"  }  ],  "extras": {  "buyCompanyCode": "01",  "buyTypeName": "전자서명전표",  "buyCompanyName": "비씨카드",  "cardMerchantNo": "702260151",  "nocvmYN": ""  },  "tradeRequestNo": "2023032110475676",  "membershipCardNo": "",  "mainPaymentMethodCode": "00",  "tradeMethod": "VAN",  "businessName": "KIS테스트",  "encOriginalPinCode": "RtXfddEgep4fOS5SIWsIAaOcfiVF/Jhn/TmdyPCvdrp/Ps5WM0VDCDiJUsWgO0vu"  },  "resultCode": 0,  "sourceResultCode": "0000",  "sourceMessage": "승 인"  } | |  | |
+
+PAYCO(신용카드+쿠폰) 결제 승인 요청문(Request)
+
+|  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| |  | | --- | | { | | "tradeRequestNo":"2022011410442442", | | "authDatetime":"20220114122007", | | "tradeMethod":"VAN", | | "deviceAuthType":"BAR", | | "deviceType":"KIOSK", | | "serviceType":"PAYCO", | | "registrationNumber":"1168143939", | | "vanCorpCode":"KIS", | | "vanPosTid":"90071085", | | "pinCode":"940701204644113495014", | | "totalAmount":"20000", | | "directCardApprovalYN":"N", | | "currency":"KRW", | | "productName":"키위티셔츠외 1건", | | "approvalTargetList":[ | | { | | "paymentMethodCode":"00", | | "installmentPeriod":"00", | | "approvalAmount":"17500" | | }, | | { | | "paymentMethodCode":"10", | | "approvalAmount":"0" | | }, | | { | | "paymentMethodCode":"20", | | "approvalAmount":"2500" | | } | | ],  "settlementYmd":"20220114" | | } | |
+
+PAYCO(신용카드+쿠폰) 결제 승인 응답문(Response)
+
+|  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| |  | | --- | | { | | "message":"OK", | | "result":{ | | "tradeNo":"14122258", | | "tradeDatetime":"20220114122258", | | "totalTaxfreeAmount":0.0, | | "totalTaxableAmount":18182.0, | | "totalVatAmount":1818.0, | | "totalServiceAmount":0.0, | | "approvalResultList":[ | | { | | "paymentMethodCode":"20", | | "paymentMethodName":"페이코 쿠폰", | | "approvalNo":"400057814", | | "approvalDatetime":"20220114122257", | | "approvalAmount":2500.0, | | "approvalCompanyCode":"NHN", | | "approvalCompanyName":"NHN", | | "approvalCardNo":"", | | "sourcePaymentMethdCode":"75", | | "installmentPeriod":*null*, | | "taxfreeAmount":0.0, | | "taxableAmount":2273.0, | | "vatAmount":227.0, | | "serviceAmount":0.0, | | "vanApprovalCompanyCode":"NHN", | | "vanApprovalCompanyName":"NHN" | | }, | | { | | "paymentMethodCode":"00", | | "paymentMethodName":"신용카드", | | "approvalNo":"14122258", | | "approvalDatetime":"20220114122258", | | "approvalAmount":17500.0, | | "approvalCompanyCode":"CCSU", | | "approvalCompanyName":"수협카드", | | "approvalCardNo":"940701******0478", | | "sourcePaymentMethdCode":"37", | | "installmentPeriod":"00", | | "taxfreeAmount":0.0, | | "taxableAmount":15909.0, | | "vatAmount":1591.0, | | "serviceAmount":0.0, | | "vanApprovalCompanyCode":"01", | | "vanApprovalCompanyName":"비씨카드" | | } | | ], | | "extras":{ | | "buyCompanyCode":"01", | | "buyTypeName":"전자서명전표", | | "buyCompanyName":"비씨카드", | | "cardMerchantNo":"702260151", | | "nocvmYN":"" | | }, | | "tradeRequestNo":"2022011410442442", | | "membershipCardNo":"", | | "mainPaymentMethodCode":"00", | | "tradeMethod":"VAN", | | "businessName":"KIS테스트", | | "encOriginalPinCode":"czO/JqWjOc5TbxEo5xGWwKjcnJyWgaKWCzDA3z33oBguuZUZCd7LgRT61MChM6ce" | | }, | | "resultCode":0, | | "sourceResultCode":"0000", | | "sourceMessage":"" | | } | |
+
+PAYCO(신용카드 0원 결제) 결제 승인 요청문(Request)
+
+- 인증응답으로 받은 쿠폰금액이 총 결제금액과 같거나 큰 경우,   
+  paymentMethodCode 값이 00인 신용카드의 approvalAmount에 0원으로, paymentMethodCode 값이 20인 쿠폰의 approvalAmount에 총 결제금액을 넣어 전달하도록 한다.
+
+|  |  |
+| --- | --- |
+| |  | | --- | | {  "tradeRequestNo":"2023062910480263",  "authDatetime":"20230629120742",  "tradeMethod":"VAN",  "deviceAuthType":"BAR",  "deviceType":"KIOSK",  "serviceType":"PAYCO",  "registrationNumber":"1168143939",  "vanCorpCode":"KIS",  "vanPosTid":"90071085",  "pinCode":"940701002318828195180",  "totalAmount":"4000",  "directCardApprovalYN":"N",  "currency":"KRW",  "productName":"키위티셔츠외 1건",  "approvalTargetList":[  {  "paymentMethodCode":"00",  "installmentPeriod":"00",  "approvalAmount":"0"  },  {  "paymentMethodCode":"10",  "approvalAmount":"0"  },  {  "paymentMethodCode":"20",  "approvalAmount":"4000"  }  ],  "settlementYmd":"20230630"  } | |
+
+PAYCO(신용카드 0원 결제) 결제 승인 응답문(Response)
+
+|  |
+| --- |
+| {  "message": "OK",  "result": {  "tradeNo": "300100558",  "tradeDatetime": "20230629120940",  "totalTaxfreeAmount": 0.0,  "totalTaxableAmount": 3636.0,  "totalVatAmount": 364.0,  "totalServiceAmount": 0.0,  "totalGreenDepositAmount": 0.0,  "approvalResultList": [  {  "paymentMethodCode": "20",  "paymentMethodName": "페이코 쿠폰",  "approvalNo": "400125787",  "approvalDatetime": "20230629120940",  "approvalAmount": 4000.0,  "approvalCompanyCode": "PBIZ",  "approvalCompanyName": "PAYCO비즈플러스",  "approvalCardNo": "",  "sourcePaymentMethdCode": "78",  "installmentPeriod": null,  "taxfreeAmount": 0.0,  "taxableAmount": 3636.0,  "vatAmount": 364.0,  "serviceAmount": 0.0,  "greenDepositAmount": 0.0,  "vanApprovalCompanyCode": "NHN",  "vanApprovalCompanyName": "NHN"  },  {  "paymentMethodCode": "00",  "paymentMethodName": "신용카드",  "approvalNo": "10480263",  "approvalDatetime": "20230629120940",  "approvalAmount": 0.0,  "approvalCompanyCode": "CCSU",  "approvalCompanyName": "수협카드",  "approvalCardNo": "940701******2789",  "sourcePaymentMethdCode": "37",  "installmentPeriod": null,  "taxfreeAmount": 0.0,  "taxableAmount": 0.0,  "vatAmount": 0.0,  "serviceAmount": 0.0,  "greenDepositAmount": 0.0,  "vanApprovalCompanyCode": "NHN",  "vanApprovalCompanyName": "NHN"  }  ],  "extras": {  "buyCompanyCode": "",  "buyTypeName": "",  "buyCompanyName": "",  "cardMerchantNo": "",  "nocvmYN": ""  },  "tradeRequestNo": "2023062910480263",  "membershipCardNo": "",  "mainPaymentMethodCode": "00",  "tradeMethod": "VAN",  "businessName": "KIS테스트",  "encOriginalPinCode": "jsMqxjIVnYUPCpcOCg1oys2idVIJQqF5NHwhb3lDzLrluJJr2ugRLjHI1xlhO9Sx"  },  "resultCode": 0,  "sourceResultCode": "0",  "sourceMessage": "성공"  } |
+
+PAYCO(신용카드) 직승인 결제 승인 요청문(Request)
+
+- 직승인 결제의 경우 directCardApprovalYN의 값을 Y 로 지정하고, approvalTargetList의 하위 항목으로 cardApprovalNo, cardApprovalDatetime, cardApprovalCompanyCode의 항목을 추가하여 카드사에서 받은 승인정보를 전달합니다.
+- 직승인의 경우 승인처리를 PAYCO G/W에서 처리하지 않고, 승인요청시 전달한 값에 의존하기 때문에 응답정보가 부족하며, 이 경우 고객사의 서버측 정보를 활용하도록 합니다.
+
+|  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| |  | | --- | | { | | "tradeRequestNo":"2022011710442505", | | "authDatetime":"20220117173128", | | "tradeMethod":"VAN", | | "deviceAuthType":"BAR", | | "deviceType":"KIOSK", | | "serviceType":"PAYCO", | | "registrationNumber":"1168143939", | | "vanCorpCode":"KIS", | | "vanPosTid":"90071085", | | "pinCode":"940701204761727195017", | | "totalAmount":"800", | | "directCardApprovalYN":"Y", | | "currency":"KRW", | | "productName":"키위티셔츠외 3건", | | "approvalTargetList":[ | | { | | "paymentMethodCode":"00", | | "installmentPeriod":"00", | | "approvalAmount":"800", | | "cardApprovalNo":"85985475455214558", | | "cardApprovalDatetime":"202201171504777", | | "cardApprovalCompanyCode":"016" | | }, | | { | | "paymentMethodCode":"10", | | "approvalAmount":"0" | | }, | | { | | "paymentMethodCode":"20", | | "approvalAmount":"0" | | } | | ] | | } | |
+
+PAYCO(신용카드) 직승인 결제 승인 응답문(Response)
+
+|  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| |  | | --- | | { | | "message":"OK", | | "result":{ | | "tradeNo":"85985475455214558", | | "tradeDatetime":"202201171504777", | | "totalTaxfreeAmount":0.0, | | "totalTaxableAmount":727.0, | | "totalVatAmount":73.0, | | "totalServiceAmount":0.0, | | "approvalResultList":[ | | { | | "paymentMethodCode":"00", | | "paymentMethodName":"신용카드", | | "approvalNo":"85985475455214558", | | "approvalDatetime":"202201171504777", | | "approvalAmount":800.0, | | "approvalCompanyCode":"CCSU", | | "approvalCompanyName":"수협카드", | | "approvalCardNo":"940701******0478", | | "sourcePaymentMethdCode":"37", | | "installmentPeriod":"00", | | "taxfreeAmount":0.0, | | "taxableAmount":727.0, | | "vatAmount":73.0, | | "serviceAmount":0.0 | | } | | ], | | "extras":{ | | "buyCompanyCode":"", | | "buyTypeName":"", | | "buyCompanyName":"", | | "cardMerchantNo":"", | | "nocvmYN":"" | | }, | | "tradeRequestNo":"2022011710442505", | | "membershipCardNo":"", | | "mainPaymentMethodCode":"00", | | "tradeMethod":"VAN", | | "businessName":"KIS테스트", | | "encOriginalPinCode":"wInTzTCHNbPz+/kyClbIIkEwz3kbJwq+IwC//sT4xSiSXCA0jOPyYRRtzOt2Pm4C" | | }, | | "resultCode":0, | | "sourceResultCode":"0000", | | "sourceMessage":"정상승인" | | } | |
+
+PAYCO(신용카드+쿠폰) 직승인 결제 승인 요청문(Request)
+
+- 가맹점의 카드사 직승인 거래에 한해 사용한다.
+
+|  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| |  | | --- | | { | | "tradeRequestNo":"2022011710442509", | | "authDatetime":"20220117180537", | | "tradeMethod":"VAN", | | "deviceAuthType":"BAR", | | "deviceType":"KIOSK", | | "serviceType":"PAYCO", | | "registrationNumber":"1168143939", | | "vanCorpCode":"KIS", | | "vanPosTid":"90071085", | | "pinCode":"940701204767658495017", | | "totalAmount":"8000", | | "directCardApprovalYN":"Y", | | "currency":"KRW", | | "productName":"키위티셔츠외 3건", | | "approvalTargetList":[ | | { | | "paymentMethodCode":"00", | | "installmentPeriod":"00", | | "approvalAmount":"6000", | | "cardApprovalNo":"21985475455214547", | | "cardApprovalDatetime":"202201171504415", | | "cardApprovalCompanyCode":"016" | | }, | | { | | "paymentMethodCode":"10", | | "approvalAmount":"0" | | }, | | { | | "paymentMethodCode":"20", | | "approvalAmount":"2000" | | } | | ] | | } | |
+
+PAYCO(신용카드+쿠폰) 직승인 결제 승인 응답문(Response)
+
+|  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| |  | | --- | | { | | "message":"OK", | | "result":{ | | "tradeNo":"21985475455214547", | | "tradeDatetime":"202201171504415", | | "totalTaxfreeAmount":0.0, | | "totalTaxableAmount":7273.0, | | "totalVatAmount":727.0, | | "totalServiceAmount":0.0, | | "approvalResultList":[ | | { | | "paymentMethodCode":"20", | | "paymentMethodName":"페이코 쿠폰", | | "approvalNo":"400057814", | | "approvalDatetime":"20220117180736", | | "approvalAmount":2000.0, | | "approvalCompanyCode":"NHN", | | "approvalCompanyName":"NHN", | | "approvalCardNo":"", | | "sourcePaymentMethdCode":"75", | | "installmentPeriod":*null*, | | "taxfreeAmount":0.0, | | "taxableAmount":1819.0, | | "vatAmount":181.0, | | "serviceAmount":0.0, | | "vanApprovalCompanyCode":"NHN", | | "vanApprovalCompanyName":"NHN" | | }, | | { | | "paymentMethodCode":"00", | | "paymentMethodName":"신용카드", | | "approvalNo":"21985475455214547", | | "approvalDatetime":"202201171504415", | | "approvalAmount":6000.0, | | "approvalCompanyCode":"CCSU", | | "approvalCompanyName":"수협카드", | | "approvalCardNo":"940701******0478", | | "sourcePaymentMethdCode":"37", | | "installmentPeriod":"00", | | "taxfreeAmount":0.0, | | "taxableAmount":5454.0, | | "vatAmount":546.0, | | "serviceAmount":0.0 | | } | | ], | | "extras":{ | | "buyCompanyCode":"", | | "buyTypeName":"", | | "buyCompanyName":"", | | "cardMerchantNo":"", | | "nocvmYN":"" | | }, | | "tradeRequestNo":"2022011710442509", | | "membershipCardNo":"", | | "mainPaymentMethodCode":"00", | | "tradeMethod":"VAN", | | "businessName":"KIS테스트", | | "encOriginalPinCode":"40fLB2o9ihr3fs3YOv/BeT21IA17n6wMgGznXFoyFULuOmhnq55HQuopOKNmIfvE" | | }, | | "resultCode":0, | | "sourceResultCode":"0", | | "sourceMessage":"성공" | | } | |
+
+PAYCO(포인트) 결제 승인 요청문(Request)
+
+|  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| |  | | --- | | { | | "tradeRequestNo":"2022011410442462", | | "authDatetime":"20220114155031", | | "tradeMethod":"VAN", | | "deviceAuthType":"BAR", | | "deviceType":"KIOSK", | | "serviceType":"PAYCO", | | "registrationNumber":"1168143939", | | "vanCorpCode":"KIS", | | "vanPosTid":"90071085", | | "pinCode":"20136301254384649591", | | "totalAmount":"800", | | "directCardApprovalYN":"N", | | "currency":"KRW", | | "productName":"키위티셔츠외 3건", | | "approvalTargetList":[ | | { | | "paymentMethodCode":"00", | | "installmentPeriod":"00", | | "approvalAmount":"0" | | }, | | { | | "paymentMethodCode":"10", | | "approvalAmount":"800" | | }, | | { | | "paymentMethodCode":"20", | | "approvalAmount":"0" | | } | | ],  "settlementYmd":"20220114" | | } | |
+
+PAYCO(포인트) 결제 승인 응답문(Response)
+
+|  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| |  | | --- | | { | | "message":"OK", | | "result":{ | | "tradeNo":"2022011423706195", | | "tradeDatetime":"20220114155146", | | "totalTaxfreeAmount":0.0, | | "totalTaxableAmount":727.0, | | "totalVatAmount":73.0, | | "totalServiceAmount":0.0, | | "approvalResultList":[ | | { | | "paymentMethodCode":"10", | | "paymentMethodName":"페이코 포인트", | | "approvalNo":"2022011423706195", | | "approvalDatetime":"20220114155146", | | "approvalAmount":800.0, | | "approvalCompanyCode":"NHN", | | "approvalCompanyName":"NHN", | | "approvalCardNo":"", | | "sourcePaymentMethdCode":"98", | | "installmentPeriod":*null*, | | "taxfreeAmount":0.0, | | "taxableAmount":727.0, | | "vatAmount":73.0, | | "serviceAmount":0.0, | | "vanApprovalCompanyCode":"NHN", | | "vanApprovalCompanyName":"NHN" | | }, | | { | | "paymentMethodCode":"00", | | "paymentMethodName":"신용카드", | | "approvalNo":"10442462", | | "approvalDatetime":"20220114155146", | | "approvalAmount":0.0, | | "approvalCompanyCode":"NHN", | | "approvalCompanyName":"NHN", | | "approvalCardNo":*null*, | | "sourcePaymentMethdCode":"37", | | "installmentPeriod":*null*, | | "taxfreeAmount":0.0, | | "taxableAmount":0.0, | | "vatAmount":0.0, | | "serviceAmount":0.0, | | "vanApprovalCompanyCode":"NHN", | | "vanApprovalCompanyName":"NHN" | | } | | ], | | "extras":{ | | "buyCompanyCode":"", | | "buyTypeName":"", | | "buyCompanyName":"", | | "cardMerchantNo":"", | | "nocvmYN":"" | | }, | | "tradeRequestNo":"2022011410442462", | | "membershipCardNo":"", | | "mainPaymentMethodCode":"10", | | "tradeMethod":"VAN", | | "businessName":"KIS테스트", | | "encOriginalPinCode":"cmg0W/DG7fMJWsI8SrRFDiIQtQlL9oazoPRFryHD7OQ=" | | }, | | "resultCode":0, | | "sourceResultCode":"0", | | "sourceMessage":"성공" | | } | |
+
+PAYCO(포인트+쿠폰) 결제 승인 요청문(Request)
+
+|  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| |  | | --- | | { | | "tradeRequestNo":"2022011410442443", | | "authDatetime":"20220114124216", | | "tradeMethod":"VAN", | | "deviceAuthType":"BAR", | | "deviceType":"KIOSK", | | "serviceType":"PAYCO", | | "registrationNumber":"1168143939", | | "vanCorpCode":"KIS", | | "vanPosTid":"90071085", | | "pinCode":"20792904282752009598", | | "totalAmount":"20000", | | "directCardApprovalYN":"N", | | "currency":"KRW", | | "productName":"키위티셔츠외 3건", | | "approvalTargetList":[ | | { | | "paymentMethodCode":"00", | | "installmentPeriod":"00", | | "approvalAmount":"0" | | }, | | { | | "paymentMethodCode":"10", | | "approvalAmount":"17500" | | }, | | { | | "paymentMethodCode":"20", | | "approvalAmount":"2500" | | } | | ],  "settlementYmd":"20220114" | | } | |
+
+PAYCO(포인트+쿠폰) 결제 승인 응답문(Response)
+
+|  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| |  | | --- | | { | | "message":"OK", | | "result":{ | | "tradeNo":"2022011423704809", | | "tradeDatetime":"20220114124354", | | "totalTaxfreeAmount":0.0, | | "totalTaxableAmount":18182.0, | | "totalVatAmount":1818.0, | | "totalServiceAmount":0.0, | | "approvalResultList":[ | | { | | "paymentMethodCode":"10", | | "paymentMethodName":"페이코 포인트", | | "approvalNo":"2022011423704809", | | "approvalDatetime":"20220114124354", | | "approvalAmount":17500.0, | | "approvalCompanyCode":"NHN", | | "approvalCompanyName":"NHN", | | "approvalCardNo":"", | | "sourcePaymentMethdCode":"98", | | "installmentPeriod":*null*, | | "taxfreeAmount":0.0, | | "taxableAmount":15909.0, | | "vatAmount":1591.0, | | "serviceAmount":0.0, | | "vanApprovalCompanyCode":"NHN", | | "vanApprovalCompanyName":"NHN" | | }, | | { | | "paymentMethodCode":"20", | | "paymentMethodName":"페이코 쿠폰", | | "approvalNo":"400065806", | | "approvalDatetime":"20220114124354", | | "approvalAmount":2500.0, | | "approvalCompanyCode":"NHN", | | "approvalCompanyName":"NHN", | | "approvalCardNo":"", | | "sourcePaymentMethdCode":"78", | | "installmentPeriod":*null*, | | "taxfreeAmount":0.0, | | "taxableAmount":2273.0, | | "vatAmount":227.0, | | "serviceAmount":0.0, | | "vanApprovalCompanyCode":"NHN", | | "vanApprovalCompanyName":"NHN" | | }, | | { | | "paymentMethodCode":"00", | | "paymentMethodName":"신용카드", | | "approvalNo":"10442443", | | "approvalDatetime":"20220114124354", | | "approvalAmount":0.0, | | "approvalCompanyCode":"NHN", | | "approvalCompanyName":"NHN", | | "approvalCardNo":*null*, | | "sourcePaymentMethdCode":"37", | | "installmentPeriod":*null*, | | "taxfreeAmount":0.0, | | "taxableAmount":0.0, | | "vatAmount":0.0, | | "serviceAmount":0.0, | | "vanApprovalCompanyCode":"NHN", | | "vanApprovalCompanyName":"NHN" | | } | | ], | | "extras":{ | | "buyCompanyCode":"", | | "buyTypeName":"", | | "buyCompanyName":"", | | "cardMerchantNo":"", | | "nocvmYN":"" | | }, | | "tradeRequestNo":"2022011410442443", | | "membershipCardNo":"", | | "mainPaymentMethodCode":"10", | | "tradeMethod":"VAN", | | "businessName":"KIS테스트", | | "encOriginalPinCode":"4hnpKb5kbGmwqfVLAHKDvCaceKPSsiW1pSAtwYxI8Ks=" | | }, | | "resultCode":0, | | "sourceResultCode":"0", | | "sourceMessage":"성공" | | } | |
+
+PAYCO(포인트 0원결제) 결제 승인 요청문(Request)
+
+|  |  |
+| --- | --- |
+| |  | | --- | | {  "tradeRequestNo":"2023062910480265",  "authDatetime":"20230629140343",  "tradeMethod":"VAN",  "deviceAuthType":"BAR",  "deviceType":"KIOSK",  "serviceType":"PAYCO",  "registrationNumber":"1168143939",  "vanCorpCode":"KIS",  "vanPosTid":"90071085",  "pinCode":"20248316091681289594",  "totalAmount":"4000",  "directCardApprovalYN":"N",  "currency":"KRW",  "productName":"키위티셔츠외 1건",  "approvalTargetList":[  {  "paymentMethodCode":"00",  "installmentPeriod":"00",  "approvalAmount":"0"  },  {  "paymentMethodCode":"10",  "approvalAmount":"4000"  },  {  "paymentMethodCode":"20",  "approvalAmount":"0"  }  ],  "settlementYmd":"20230630"  } | |
+
+PAYCO(포인트 0원결제) 결제 승인 응답문(Response)
+
+|  |  |  |
+| --- | --- | --- |
+| |  |  | | --- | --- | | |  | | --- | | {  "message": "OK",  "result": {  "tradeNo": "2023062924494657",  "tradeDatetime": "20230629140517",  "totalTaxfreeAmount": 0.0,  "totalTaxableAmount": 3636.0,  "totalVatAmount": 364.0,  "totalServiceAmount": 0.0,  "totalGreenDepositAmount": 0.0,  "approvalResultList": [  {  "paymentMethodCode": "10",  "paymentMethodName": "페이코 포인트",  "approvalNo": "2023062924494657",  "approvalDatetime": "20230629140517",  "approvalAmount": 4000.0,  "approvalCompanyCode": "NHN",  "approvalCompanyName": "NHN",  "approvalCardNo": "",  "sourcePaymentMethdCode": "98",  "installmentPeriod": null,  "taxfreeAmount": 0.0,  "taxableAmount": 3636.0,  "vatAmount": 364.0,  "serviceAmount": 0.0,  "greenDepositAmount": 0.0,  "vanApprovalCompanyCode": "NHN",  "vanApprovalCompanyName": "NHN"  },  {  "paymentMethodCode": "00",  "paymentMethodName": "신용카드",  "approvalNo": "10480265",  "approvalDatetime": "20230629140517",  "approvalAmount": 0.0,  "approvalCompanyCode": "NHN",  "approvalCompanyName": "NHN",  "approvalCardNo": null,  "sourcePaymentMethdCode": "37",  "installmentPeriod": null,  "taxfreeAmount": 0.0,  "taxableAmount": 0.0,  "vatAmount": 0.0,  "serviceAmount": 0.0,  "greenDepositAmount": 0.0,  "vanApprovalCompanyCode": "NHN",  "vanApprovalCompanyName": "NHN"  }  ],  "extras": {  "buyCompanyCode": "",  "buyTypeName": "",  "buyCompanyName": "",  "cardMerchantNo": "",  "nocvmYN": ""  },  "tradeRequestNo": "2023062910480265",  "membershipCardNo": "",  "mainPaymentMethodCode": "10",  "tradeMethod": "VAN",  "businessName": "KIS테스트",  "encOriginalPinCode": "qhpDczWyxxQuRmYdtzFEtKzmnyIet7pNtpeMXgyqrp0="  },  "resultCode": 0,  "sourceResultCode": "0",  "sourceMessage": "성공"  } | | |
+
+PAYCO(식권쿠폰) 결제 승인 요청문(Request)
+
+|  |  |
+| --- | --- |
+| |  | | --- | | {  "tradeRequestNo":"2023062910480266",  "authDatetime":"20230629143659",  "tradeMethod":"VAN",  "deviceAuthType":"BAR",  "deviceType":"KIOSK",  "serviceType":"PAYCO",  "registrationNumber":"1168143939",  "vanCorpCode":"KIS",  "vanPosTid":"90071085",  "pinCode":"10808633206474279581",  "totalAmount":"1000",  "directCardApprovalYN":"N",  "currency":"KRW",  "productName":"키위티셔츠외 1건",  "approvalTargetList":[  {  "paymentMethodCode":"00",  "installmentPeriod":"00",  "approvalAmount":"0"  },  {  "paymentMethodCode":"10",  "approvalAmount":"0"  },  {  "paymentMethodCode":"20",  "approvalAmount":"1000"  }  ],  "settlementYmd":"20230630"  } | |
+
+PAYCO(식권쿠폰) 결제 승인 응답문(Response)
+
+|  |  |
+| --- | --- |
+| |  | | --- | | {  "message": "OK",  "result": {  "tradeNo": "300100558",  "tradeDatetime": "20230629143804",  "totalTaxfreeAmount": 0.0,  "totalTaxableAmount": 909.0,  "totalVatAmount": 91.0,  "totalServiceAmount": 0.0,  "totalGreenDepositAmount": 0.0,  "approvalResultList": [  {  "paymentMethodCode": "20",  "paymentMethodName": "페이코 쿠폰",  "approvalNo": "300100558",  "approvalDatetime": "20230629143804",  "approvalAmount": 1000.0,  "approvalCompanyCode": "PBIZ",  "approvalCompanyName": "PAYCO비즈플러스",  "approvalCardNo": "",  "sourcePaymentMethdCode": "70",  "installmentPeriod": null,  "taxfreeAmount": 0.0,  "taxableAmount": 909.0,  "vatAmount": 91.0,  "serviceAmount": 0.0,  "greenDepositAmount": 0.0,  "vanApprovalCompanyCode": "NHN",  "vanApprovalCompanyName": "NHN"  },  {  "paymentMethodCode": "00",  "paymentMethodName": "신용카드",  "approvalNo": "10480266",  "approvalDatetime": "20230629143804",  "approvalAmount": 0.0,  "approvalCompanyCode": "NHN",  "approvalCompanyName": "NHN",  "approvalCardNo": null,  "sourcePaymentMethdCode": "37",  "installmentPeriod": null,  "taxfreeAmount": 0.0,  "taxableAmount": 0.0,  "vatAmount": 0.0,  "serviceAmount": 0.0,  "greenDepositAmount": 0.0,  "vanApprovalCompanyCode": "NHN",  "vanApprovalCompanyName": "NHN"  }  ],  "extras": {  "buyCompanyCode": "",  "buyTypeName": "",  "buyCompanyName": "",  "cardMerchantNo": "",  "nocvmYN": ""  },  "tradeRequestNo": "2023062910480266",  "membershipCardNo": "",  "mainPaymentMethodCode": "20",  "tradeMethod": "VAN",  "businessName": "KIS테스트",  "encOriginalPinCode": "v7AHFdKdJiV7HGFu/m70dWQH39UUyp9Xyo5Xn9sEgSc="  },  "resultCode": 0,  "sourceResultCode": "0",  "sourceMessage": "성공"  } | |
+
+## 결제취소 요청 API
+
+결제 취소 시 복합결제라 하더라도 결제수단별로 각각 취소하지 않고, 한번에 취소처리 됩니다.
+
+|  |  |
+| --- | --- |
+| **Method** | **URI** |
+| POST | /payment/v1/cancel/integration |
+
+### RequestBody
+
+|  |  |  |  |
+| --- | --- | --- | --- |
+| **Parameter** | **Type** | **Required** | **Description** |
+| tradeRequestNo | string(16) | Y | 거래요청번호 |
+| tradeMethod | string(3) | Y | 거래방식  PG : PAYCO PG망을 통해서 승인  VAN : 가맹점 VAN망을 통해서 승인 |
+| deviceAuthType | string(3) | Y | 단말기인증타입   - BAR : 바코드 |
+| deviceType | String(10) | Y | 단말기 종류(POS, KIOSK, CAT) |
+| mrcBuyingCancelYN | string(1) | N | 가맹점 매입취소 여부(Y|N)  (Y인 경우 PAYCO에서 승인취소처리를 하지 않고 결과 등록만 진행함) |
+| cardApprovalNo | string(20) | N | 승인번호  (mrcBuyingCancelYN = Y인 경우 필수) |
+| cardCancelDatetime | string(14) | N | 취소일시(yyyyMMddHHmmss)  (mrcBuyingCancelYN = Y인 경우 필수) |
+| serviceType | string(10) | Y | - 결제서비스 종류(“PAYCO” 고정) |
+| registrationNumber | string(10) | Y | 사업자등록번호 |
+| vanCorpCode | string(10) | Y | [VAN사 코드](#_VAN사_코드) |
+| vanPosTid | string(128) | Y | VAN사에서 발급한 단말기 번호 |
+| pinCode | string(21) | Y | PAYCO APP에서 스캔한 바코드   - PAYCO OTC (One Time Card, 20~21byte의 문자열) |
+| extras | object | N | 추가정보(스마트로, KPN VAN 사용시 필수) |
+| sign | object | N | 서명정보(5만원 초과결제시 필수) |
+| posTid | string(11) | Y | PAYCO가 관리하는 POS단말 고유번호  (서버간 통신의 경우 필수 아님) |
+| signature | string(44) | Y | 요청정보 검증을 위한 값  (서버간 통신의 경우 필수 아님) |
+
+#### ㄴextras(추가정보)
+
+승인 API의 추가정보 필드를 참고해 주세요
+
+#### ㄴsign(서명정보)
+
+승인 API의 서명 필드를 참고해 주세요.
+
+### ResponseBody
+
+|  |  |  |
+| --- | --- | --- |
+| **Parameter** | **Type** | **Description** |
+| tradeNo | string(20) | PG/VAN사 거래번호 |
+| tradeDatetime | string(14) | PG/VAN사 거래일시   - yyyyMMddHHmmss |
+| totalTaxfreeAmount | double | 면세금액 |
+| totalTaxableAmount | double | 과세금액 |
+| totalVatAmount | double | 부가세 |
+| totalServiceAmount | double | 봉사료 |
+| totalCancelGreenDepositAmount | double | 컵보증금 |
+| cancelResultList | list | 취소결과 list |
+| extras | object | 추가정보 |
+
+#### ㄴcancelResultList(결제 취소시 결제수단별 정보)
+
+|  |  |  |
+| --- | --- | --- |
+| **Parameter** | **Type** | **Description** |
+| paymentMethodCode | string(2) | [결제수단코드](#_결제수단_코드) |
+| paymentMethodName | string(100) | 결제수단명 |
+| cancelAmount | double | 취소금액 |
+| cancelDatetime | string(14) | 취소일시(yyyyMMddHHmmss) |
+| sourcePaymentMethdCode | String(2) | 원천사결제수단코드 (페이코 결제수단코드) |
+| taxfreeAmount | double | 면세금액 |
+| taxableAmount | double | 과세금액 |
+| vatAmount | double | 부가세 |
+| serviceAmount | double | 봉사료 |
+| cancelGreenDepositAmount | double | 컵보증금 |
+| approvalNo | string(20) | 승인번호 |
+| approvalCompanyCode | string(5) | [승인사코드](#_PG(KCP)_결제_신용카드) |
+| approvalCompanyName | string(100) | [승인사명](#_KCP_승인사/매입사_매핑) |
+
+#### ㄴextras(VAN 승인시 추가정보)
+
+**VAN 승인시 공통으로 받는 추가정보**
+
+|  |  |  |
+| --- | --- | --- |
+| **Parameter** | **Type** | **Description** |
+| buyCompanyName | string(12) | 매입사명 |
+| buyCompanyCode | string(12) | 매입사코드 |
+| cardMerchantNo | string(15) | 카드 가맹점 번호 |
+| buyTypeName | string(50) | 매입방법명 |
+| nocvmYN | string(1) | NoCVM 거래여부 |
+
+### Example
+
+PAYCO(신용카드) 결제 취소 요청문(Request)
+
+|  |  |  |
+| --- | --- | --- |
+| |  | | --- | | {  "registrationNumber" : "1168143939",  "vanPosTid" : "90071085",  "serviceType" : "PAYCO",  "vanCorpCode" : "KIS",  "tradeMethod" : "VAN",  "tradeRequestNo" : "2023032110475676",  "pinCode" : "940701002275603295080",  "mrcBuyingCancelYN":"N",  "extras":  {  "posDevCorpName":"test",  "posSolutionName":"테스트",  "posSolutionVersion" : "1.0"  },  "deviceAuthType" : "BAR",  "deviceType" : "KIOSK"  } | |  | |
+
+PAYCO(신용카드) 결제 취소 응답문(Response)
+
+|  |  |
+| --- | --- |
+| |  | | --- | | {  "message": "OK",  "result": {  "tradeNo": "21102724",  "tradeDatetime": "20230321103640",  "cancelResultList": [  {  "paymentMethodCode": "00",  "paymentMethodName": "신용카드",  "cancelAmount": 1100.0,  "cancelDatetime": "20230321103640",  "sourcePaymentMethdCode": "37",  "taxfreeAmount": 0.0,  "taxableAmount": 727.0,  "vatAmount": 73.0,  "serviceAmount": 0.0,  "cancelGreenDepositAmount": 300.0,  "approvalNo": "21102724",  "approvalCompanyCode": "CCSU",  "approvalCompanyName": "수협카드"  }  ],  "extras": {  "buyCompanyCode": "01",  "buyTypeName": "전자서명전표",  "buyCompanyName": "비씨카드",  "cardMerchantNo": "702260151",  "nocvmYN": ""  },  "totalTaxfreeAmount": 0.0,  "totalTaxableAmount": 727.0,  "totalVatAmount": 73.0,  "totalServiceAmount": 0.0,  "totalCancelGreenDepositAmount": 300.0,  "encOriginalPinCode": "RtXfddEgep4fOS5SIWsIAaOcfiVF/Jhn/TmdyPCvdrp/Ps5WM0VDCDiJUsWgO0vu"  },  "resultCode": 0,  "sourceResultCode": "0000",  "sourceMessage": "승 인"  } | |
+
+PAYCO(신용카드+쿠폰) 결제 취소 요청문(Request)
+
+|  |  |  |  |  |  |  |  |  |  |  |  |  |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| |  | | --- | | { | | "registrationNumber":"1168143939", | | "vanPosTid":"90071085", | | "serviceType":"PAYCO", | | "vanCorpCode":"KIS", | | "tradeMethod":"VAN", | | "tradeRequestNo":"2022011410442442", | | "pinCode":"940701204644113495014", | | "mrcBuyingCancelYN":"N", | | "deviceAuthType":"BAR", | | "deviceType":"KIOSK" | | } | |
+
+PAYCO(신용카드+쿠폰) 결제 취소 응답문(Response)
+
+|  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| |  | | --- | | { | | "message":"OK", | | "result":{ | | "tradeNo":"400057814", | | "tradeDatetime":"20220114122403", | | "cancelResultList":[ | | { | | "paymentMethodCode":"20", | | "paymentMethodName":"페이코 쿠폰", | | "cancelAmount":2500.0, | | "cancelDatetime":"20220114122403", | | "sourcePaymentMethdCode":"75", | | "taxfreeAmount":0.0, | | "taxableAmount":2273.0, | | "vatAmount":227.0, | | "serviceAmount":0.0, | | "approvalNo":"400057814", | | "approvalCompanyCode":"NHN", | | "approvalCompanyName":"NHN" | | }, | | { | | "paymentMethodCode":"00", | | "paymentMethodName":"신용카드", | | "cancelAmount":17500.0, | | "cancelDatetime":"20220114122403", | | "sourcePaymentMethdCode":"37", | | "taxfreeAmount":0.0, | | "taxableAmount":15909.0, | | "vatAmount":1591.0, | | "serviceAmount":0.0, | | "approvalNo":"14122258", | | "approvalCompanyCode":"CCSU", | | "approvalCompanyName":"수협카드" | | } | | ], | | "extras":{ | | "buyCompanyCode":"01", | | "buyTypeName":"전자서명전표", | | "buyCompanyName":"비씨카드", | | "cardMerchantNo":"702260151", | | "nocvmYN":"" | | }, | | "totalTaxfreeAmount":0.0, | | "totalTaxableAmount":18182.0, | | "totalVatAmount":1818.0, | | "totalServiceAmount":0.0, | | "encOriginalPinCode":"czO/JqWjOc5TbxEo5xGWwKjcnJyWgaKWCzDA3z33oBguuZUZCd7LgRT61MChM6ce" | | }, | | "resultCode":0, | | "sourceResultCode":"0000", | | "sourceMessage":"" | | } | |
+
+PAYCO(신용카드 0원 결제) 결제 취소 요청문(Request)
+
+|  |  |
+| --- | --- |
+| |  | | --- | | {  "registrationNumber":"1168143939",  "vanPosTid":"90071085",  "serviceType":"PAYCO",  "vanCorpCode":"KIS",  "tradeMethod":"VAN",  "tradeRequestNo":"2023062910480263",  "pinCode":"940701002318828195180",  "mrcBuyingCancelYN":"N",  "deviceAuthType":"BAR",  "deviceType":"KIOSK"  } | |
+
+PAYCO(신용카드 0원 결제) 결제 취소 응답문(Response)
+
+|  |
+| --- |
+| {  "message": "OK",  "result": {  "tradeNo": "300100558",  "tradeDatetime": "20230629122147",  "cancelResultList": [  {  "paymentMethodCode": "20",  "paymentMethodName": "페이코 쿠폰",  "cancelAmount": 4000.0,  "cancelDatetime": "20230629122147",  "sourcePaymentMethdCode": "78",  "taxfreeAmount": 0.0,  "taxableAmount": 3636.0,  "vatAmount": 364.0,  "serviceAmount": 0.0,  "cancelGreenDepositAmount": 0.0,  "approvalNo": "400125787",  "approvalCompanyCode": "PBIZ",  "approvalCompanyName": "PAYCO비즈플러스"  },  {  "paymentMethodCode": "00",  "paymentMethodName": "신용카드",  "cancelAmount": 0.0,  "cancelDatetime": "20230629122147",  "sourcePaymentMethdCode": "37",  "taxfreeAmount": 0.0,  "taxableAmount": 0.0,  "vatAmount": 0.0,  "serviceAmount": 0.0,  "cancelGreenDepositAmount": 0.0,  "approvalNo": "10480263",  "approvalCompanyCode": "CCSU",  "approvalCompanyName": "수협카드"  }  ],  "extras": {  "buyCompanyCode": "",  "buyTypeName": "",  "buyCompanyName": "",  "cardMerchantNo": "",  "nocvmYN": ""  },  "totalTaxfreeAmount": 0.0,  "totalTaxableAmount": 3636.0,  "totalVatAmount": 364.0,  "totalServiceAmount": 0.0,  "totalCancelGreenDepositAmount": 0.0,  "encOriginalPinCode": "jsMqxjIVnYUPCpcOCg1oys2idVIJQqF5NHwhb3lDzLrluJJr2ugRLjHI1xlhO9Sx"  },  "resultCode": 0,  "sourceResultCode": "0",  "sourceMessage": "성공"  } |
+
+PAYCO(신용카드) 직승인 결제 취소 요청문(Request)
+
+직승인 또는 매입취소 거래 건인 경우 mrcBuyingCancelYN의 값을 Y로 지정하고, cardApprovalNo, cardCancelDatetime의 항목을 추가하여 결제 취소를 요청합니다.
+
+|  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| |  | | --- | | { | | "registrationNumber":"1168143939", | | "vanPosTid":"90071085", | | "serviceType":"PAYCO", | | "vanCorpCode":"KIS", | | "tradeMethod":"VAN", | | "tradeRequestNo":"2022011710442505", | | "pinCode":"940701204761727195017", | | "mrcBuyingCancelYN":"Y", | | "cardApprovalNo":"20220116957489", | | "cardCancelDatetime":"20220116175420", | | "deviceAuthType":"BAR", | | "deviceType":"KIOSK" | | } | |
+
+PAYCO(신용카드) 직승인 결제 취소 응답문(Response)
+
+|  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| |  | | --- | | { | | "message":"OK", | | "result":{ | | "tradeNo":"85985475455214558", | | "tradeDatetime":"20220116175420", | | "cancelResultList":[ | | { | | "paymentMethodCode":"00", | | "paymentMethodName":"신용카드", | | "cancelAmount":800.0, | | "cancelDatetime":"20220116175420", | | "sourcePaymentMethdCode":"37", | | "taxfreeAmount":0.0, | | "taxableAmount":727.0, | | "vatAmount":73.0, | | "serviceAmount":0.0, | | "approvalNo":"20220116957489", | | "approvalCompanyCode":"CCSU", | | "approvalCompanyName":"수협카드" | | } | | ], | | "extras":{ | | "buyCompanyCode":"", | | "buyTypeName":"", | | "buyCompanyName":"", | | "cardMerchantNo":"", | | "nocvmYN":"" | | }, | | "totalTaxfreeAmount":0.0, | | "totalTaxableAmount":727.0, | | "totalVatAmount":73.0, | | "totalServiceAmount":0.0, | | "encOriginalPinCode":"wInTzTCHNbPz+/kyClbIIkEwz3kbJwq+IwC//sT4xSiSXCA0jOPyYRRtzOt2Pm4C" | | }, | | "resultCode":0, | | "sourceResultCode":"0000", | | "sourceMessage":"정상취소" | | } | |
+
+PAYCO(신용카드+쿠폰) 직승인 결제 취소 요청문(Request)
+
+|  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| |  | | --- | | { | | "registrationNumber":"1168143939", | | "vanPosTid":"90071085", | | "serviceType":"PAYCO", | | "vanCorpCode":"KIS", | | "tradeMethod":"VAN", | | "tradeRequestNo":"2022011710442509", | | "pinCode":"940701204767658495017", | | "mrcBuyingCancelYN":"Y", | | "cardApprovalNo":"20220116959549", | | "cardCancelDatetime":"20220116201420", | | "deviceAuthType":"BAR", | | "deviceType":"KIOSK" | | } | |
+
+PAYCO(신용카드+쿠폰) 직승인 결제 취소 응답문(Response)
+
+|  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| |  | | --- | | { | | "message":"OK", | | "result":{ | | "tradeNo":"21985475455214547", | | "tradeDatetime":"20220116201420", | | "cancelResultList":[ | | { | | "paymentMethodCode":"20", | | "paymentMethodName":"페이코 쿠폰", | | "cancelAmount":2000.0, | | "cancelDatetime":"20220117181026", | | "sourcePaymentMethdCode":"75", | | "taxfreeAmount":0.0, | | "taxableAmount":1819.0, | | "vatAmount":181.0, | | "serviceAmount":0.0, | | "approvalNo":"400057814", | | "approvalCompanyCode":"NHN", | | "approvalCompanyName":"NHN" | | }, | | { | | "paymentMethodCode":"00", | | "paymentMethodName":"신용카드", | | "cancelAmount":6000.0, | | "cancelDatetime":"20220116201420", | | "sourcePaymentMethdCode":"37", | | "taxfreeAmount":0.0, | | "taxableAmount":5454.0, | | "vatAmount":546.0, | | "serviceAmount":0.0, | | "approvalNo":"20220116959549", | | "approvalCompanyCode":"CCSU", | | "approvalCompanyName":"수협카드" | | } | | ], | | "extras":{ | | "buyCompanyCode":"", | | "buyTypeName":"", | | "buyCompanyName":"", | | "cardMerchantNo":"", | | "nocvmYN":"" | | }, | | "totalTaxfreeAmount":0.0, | | "totalTaxableAmount":7273.0, | | "totalVatAmount":727.0, | | "totalServiceAmount":0.0, | | "encOriginalPinCode":"40fLB2o9ihr3fs3YOv/BeT21IA17n6wMgGznXFoyFULuOmhnq55HQuopOKNmIfvE" | | }, | | "resultCode":0, | | "sourceResultCode":"0", | | "sourceMessage":"성공" | | } | |
+
+PAYCO(포인트) 결제 취소 요청문(Request)
+
+|  |  |  |  |  |  |  |  |  |  |  |  |  |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| |  | | --- | | { | | "registrationNumber":"1168143939", | | "vanPosTid":"90071085", | | "serviceType":"PAYCO", | | "vanCorpCode":"KIS", | | "tradeMethod":"VAN", | | "tradeRequestNo":"2022011410442462", | | "pinCode":"20136301254384649591", | | "mrcBuyingCancelYN":"N", | | "deviceAuthType":"BAR", | | "deviceType":"KIOSK" | | } | |
+
+PAYCO(포인트) 결제 취소 응답문(Response)
+
+|  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| |  | | --- | | { | | "message":"OK", | | "result":{ | | "tradeNo":"2022011423706199", | | "tradeDatetime":"20220114155304", | | "cancelResultList":[ | | { | | "paymentMethodCode":"10", | | "paymentMethodName":"페이코 포인트", | | "cancelAmount":800.0, | | "cancelDatetime":"20220114155304", | | "sourcePaymentMethdCode":"98", | | "taxfreeAmount":0.0, | | "taxableAmount":727.0, | | "vatAmount":73.0, | | "serviceAmount":0.0, | | "approvalNo":"2022011423706199", | | "approvalCompanyCode":"NHN", | | "approvalCompanyName":"NHN" | | }, | | { | | "paymentMethodCode":"00", | | "paymentMethodName":"신용카드", | | "cancelAmount":0.0, | | "cancelDatetime":"20220114155304", | | "sourcePaymentMethdCode":"37", | | "taxfreeAmount":0.0, | | "taxableAmount":0.0, | | "vatAmount":0.0, | | "serviceAmount":0.0, | | "approvalNo":"10442462", | | "approvalCompanyCode":"NHN", | | "approvalCompanyName":"NHN" | | } | | ], | | "extras":{ | | "buyCompanyCode":"", | | "buyTypeName":"", | | "buyCompanyName":"", | | "cardMerchantNo":"", | | "nocvmYN":"" | | }, | | "totalTaxfreeAmount":0.0, | | "totalTaxableAmount":727.0, | | "totalVatAmount":73.0, | | "totalServiceAmount":0.0, | | "encOriginalPinCode":"cmg0W/DG7fMJWsI8SrRFDiIQtQlL9oazoPRFryHD7OQ=" | | }, | | "resultCode":0, | | "sourceResultCode":"0", | | "sourceMessage":"성공" | | } | |
+
+PAYCO(포인트+쿠폰) 결제 취소 요청문(Request)
+
+|  |  |  |  |  |  |  |  |  |  |  |  |  |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| |  | | --- | | { | | "registrationNumber":"1168143939", | | "vanPosTid":"90071085", | | "serviceType":"PAYCO", | | "vanCorpCode":"KIS", | | "tradeMethod":"VAN", | | "tradeRequestNo":"2022011410442443", | | "pinCode":"20792904282752009598", | | "mrcBuyingCancelYN":"N", | | "deviceAuthType":"BAR", | | "deviceType":"KIOSK" | | } | |
+
+PAYCO(포인트+쿠폰) 결제 취소 응답문(Response)
+
+|  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| |  | | --- | | { | | "message":"OK", | | "result":{ | | "tradeNo":"400065806", | | "tradeDatetime":"20220114124518", | | "cancelResultList":[ | | { | | "paymentMethodCode":"10", | | "paymentMethodName":"페이코 포인트", | | "cancelAmount":17500.0, | | "cancelDatetime":"20220114124518", | | "sourcePaymentMethdCode":"98", | | "taxfreeAmount":0.0, | | "taxableAmount":15909.0, | | "vatAmount":1591.0, | | "serviceAmount":0.0, | | "approvalNo":"2022011423705057", | | "approvalCompanyCode":"NHN", | | "approvalCompanyName":"NHN" | | }, | | **{** | | "paymentMethodCode":"20", | | "paymentMethodName":"페이코 쿠폰", | | "cancelAmount":2500.0, | | "cancelDatetime":"20220114124518", | | "sourcePaymentMethdCode":"78", | | "taxfreeAmount":0.0, | | "taxableAmount":2273.0, | | "vatAmount":227.0, | | "serviceAmount":0.0, | | "approvalNo":"400065806", | | "approvalCompanyCode":"NHN", | | "approvalCompanyName":"NHN" | | **}**, | | { | | "paymentMethodCode":"00", | | "paymentMethodName":"신용카드", | | "cancelAmount":0.0, | | "cancelDatetime":"20220114124518", | | "sourcePaymentMethdCode":"37", | | "taxfreeAmount":0.0, | | "taxableAmount":0.0, | | "vatAmount":0.0, | | "serviceAmount":0.0, | | "approvalNo":"10442443", | | "approvalCompanyCode":"NHN", | | "approvalCompanyName":"NHN" | | } | | ], | | "extras":{ | | "buyCompanyCode":"", | | "buyTypeName":"", | | "buyCompanyName":"", | | "cardMerchantNo":"", | | "nocvmYN":"" | | }, | | "totalTaxfreeAmount":0.0, | | "totalTaxableAmount":18182.0, | | "totalVatAmount":1818.0, | | "totalServiceAmount":0.0, | | "encOriginalPinCode":"4hnpKb5kbGmwqfVLAHKDvCaceKPSsiW1pSAtwYxI8Ks=" | | }, | | "resultCode":0, | | "sourceResultCode":"0", | | "sourceMessage":"성공" | | } | |
+
+PAYCO(포인트 0원) 결제 취소 요청문(Request)
+
+|  |  |
+| --- | --- |
+| |  | | --- | | {  "registrationNumber":"1168143939",  "vanPosTid":"90071085",  "serviceType":"PAYCO",  "vanCorpCode":"KIS",  "tradeMethod":"VAN",  "tradeRequestNo":"2023062910480265",  "pinCode":"20248316091681289594",  "mrcBuyingCancelYN":"N",  "deviceAuthType":"BAR",  "deviceType":"KIOSK"  } | |
+
+PAYCO(포인트 0원) 결제 취소 응답문(Response)
+
+|  |
+| --- |
+| {  "message": "OK",  "result": {  "tradeNo": "2023062924494662",  "tradeDatetime": "20230629141116",  "cancelResultList": [  {  "paymentMethodCode": "10",  "paymentMethodName": "페이코 포인트",  "cancelAmount": 4000.0,  "cancelDatetime": "20230629141116",  "sourcePaymentMethdCode": "98",  "taxfreeAmount": 0.0,  "taxableAmount": 3636.0,  "vatAmount": 364.0,  "serviceAmount": 0.0,  "cancelGreenDepositAmount": 0.0,  "approvalNo": "2023062924494662",  "approvalCompanyCode": "NHN",  "approvalCompanyName": "NHN"  },  {  "paymentMethodCode": "00",  "paymentMethodName": "신용카드",  "cancelAmount": 0.0,  "cancelDatetime": "20230629141116",  "sourcePaymentMethdCode": "37",  "taxfreeAmount": 0.0,  "taxableAmount": 0.0,  "vatAmount": 0.0,  "serviceAmount": 0.0,  "cancelGreenDepositAmount": 0.0,  "approvalNo": "10480265",  "approvalCompanyCode": "NHN",  "approvalCompanyName": "NHN"  }  ],  "extras": {  "buyCompanyCode": "",  "buyTypeName": "",  "buyCompanyName": "",  "cardMerchantNo": "",  "nocvmYN": ""  },  "totalTaxfreeAmount": 0.0,  "totalTaxableAmount": 3636.0,  "totalVatAmount": 364.0,  "totalServiceAmount": 0.0,  "totalCancelGreenDepositAmount": 0.0,  "encOriginalPinCode": "qhpDczWyxxQuRmYdtzFEtKzmnyIet7pNtpeMXgyqrp0="  },  "resultCode": 0,  "sourceResultCode": "0",  "sourceMessage": "성공"  } |
+
+PAYCO(식권쿠폰) 결제 취소 요청문(Request)
+
+|  |  |
+| --- | --- |
+| |  | | --- | | {  "registrationNumber":"1168143939",  "vanPosTid":"90071085",  "serviceType":"PAYCO",  "vanCorpCode":"KIS",  "tradeMethod":"VAN",  "tradeRequestNo":"2023062910480266",  "pinCode":"10808633206474279581",  "mrcBuyingCancelYN":"N",  "deviceAuthType":"BAR",  "deviceType":"KIOSK"  } | |
+
+PAYCO(식권쿠폰) 결제 취소 응답문(Response)
+
+|  |
+| --- |
+| {  "message": "OK",  "result": {  "tradeNo": "300100558",  "tradeDatetime": "20230629150645",  "cancelResultList": [  {  "paymentMethodCode": "20",  "paymentMethodName": "페이코 쿠폰",  "cancelAmount": 1000.0,  "cancelDatetime": "20230629150645",  "sourcePaymentMethdCode": "70",  "taxfreeAmount": 0.0,  "taxableAmount": 909.0,  "vatAmount": 91.0,  "serviceAmount": 0.0,  "cancelGreenDepositAmount": 0.0,  "approvalNo": "300100558",  "approvalCompanyCode": "PBIZ",  "approvalCompanyName": "PAYCO비즈플러스"  },  {  "paymentMethodCode": "00",  "paymentMethodName": "신용카드",  "cancelAmount": 0.0,  "cancelDatetime": "20230629150645",  "sourcePaymentMethdCode": "37",  "taxfreeAmount": 0.0,  "taxableAmount": 0.0,  "vatAmount": 0.0,  "serviceAmount": 0.0,  "cancelGreenDepositAmount": 0.0,  "approvalNo": "10480266",  "approvalCompanyCode": "NHN",  "approvalCompanyName": "NHN"  }  ],  "extras": {  "buyCompanyCode": "",  "buyTypeName": "",  "buyCompanyName": "",  "cardMerchantNo": "",  "nocvmYN": ""  },  "totalTaxfreeAmount": 0.0,  "totalTaxableAmount": 909.0,  "totalVatAmount": 91.0,  "totalServiceAmount": 0.0,  "totalCancelGreenDepositAmount": 0.0,  "encOriginalPinCode": "v7AHFdKdJiV7HGFu/m70dWQH39UUyp9Xyo5Xn9sEgSc="  },  "resultCode": 0,  "sourceResultCode": "0",  "sourceMessage": "성공"  } |
+
+## 망취소 API
+
+POS에서 PAYCO로 승인 요청을 한 이후 응답을 못 받은 경우 망취소를 요청합니다.
+
+|  |  |
+| --- | --- |
+| **Method** | **URI** |
+| POST | /payment/v1/networkcancel |
+
+### RequestBody
+
+|  |  |  |  |
+| --- | --- | --- | --- |
+| **Parameter** | **Type** | **Required** | **Description** |
+| tradeRequestNo | string(16) | Y | 거래요청번호 |
+| tradeMethod | string(3) | Y | 거래방식  PG : PAYCO PG망을 통해서 승인  VAN : 가맹점 VAN망을 통해서 승인 |
+| deviceAuthType | string(3) | Y | 단말기인증타입   - BAR : 바코드 |
+| deviceType | String(10) | Y | 단말기 종류(POS, KIOSK, CAT) |
+| serviceType | string(10) | Y | - 결제서비스 종류(“PAYCO” 고정) |
+| registrationNumber | string(10) | Y | 사업자등록번호 |
+| vanCorpCode | string(10) | Y | [VAN사 코드](#_VAN사_코드) |
+| vanPosTid | string(128) | Y | VAN사에서 발급한 단말기 번호 |
+| pinCode | string(21) | Y | PAYCO APP에서 스캔한 바코드   - PAYCO OTC (One Time Card, 20~21byte 의 문자열) |
+| posTid | string(11) | Y | PAYCO가 관리하는 POS단말 고유번호  (서버간 통신의 경우 필수 아님) |
+| signature | string(44) | Y | 요청정보 검증을 위한 값  (서버간 통신의 경우 필수 아님) |
+
+### ResponseBody
+
+|  |  |  |
+| --- | --- | --- |
+| **Parameter** | **Type** | **Description** |
+| tradeNo | string(20) | PG/VAN사 거래번호 |
+| tradeDatetime | string(14) | PG/VAN사 거래일시(yyyyMMddHHmmss) |
+| totalTaxfreeAmount | double | 면세금액 |
+| totalTaxableAmount | double | 과세금액 |
+| totalVatAmount | double | 부가세 |
+| totalServiceAmount | double | 봉사료 |
+| totalCancelGreenDepositAmount | double | 컵보증금 |
+| cancelResultList | list | 취소결과 list |
+| extras | object | 추가정보 |
+
+#### ㄴcancelResultList(결제 취소시 결제수단별 정보)
+
+|  |  |  |
+| --- | --- | --- |
+| **Parameter** | **Type** | **Description** |
+| paymentMethodCode | string(2) | [결제수단코드](#_결제수단_코드) |
+| paymentMethodName | string(100) | 결제수단명 |
+| cancelAmount | double | 취소금액 |
+| cancelDatetime | string(14) | 취소일시(yyyyMMddHHmmss) |
+| sourcePaymentMethdCode | String(2) | 원천사결제수단코드 (페이코 결제수단코드) |
+| taxfreeAmount | double | 면세금액 |
+| taxableAmount | double | 과세금액 |
+| vatAmount | double | 부가세 |
+| serviceAmount | double | 봉사료 |
+| cancelGreenDepositAmount | double | 컵보증금 |
+
+#### ㄴextras(VAN 승인시 추가정보)
+
+**VAN 승인시 공통으로 받는 추가정보**
+
+|  |  |  |
+| --- | --- | --- |
+| **Parameter** | **Type** | **Description** |
+| buyCompanyName | string(12) | 매입사명 |
+| buyCompanyCode | string(10) | 매입사코드 |
+| cardMerchantNo | string(15) | 카드 가맹점 번호 |
+| buyTypeName | string(50) | 매입방법명 |
+| nocvmYN | string(1) | NoCVM 거래여부 |
+
+### Example
+
+망취소 예제의 경우 [결제취소요청 Example](#_Example) 전문 참고 바랍니다.
+
+## 공통코드
+
+### VAN사 코드
+
+|  |  |
+| --- | --- |
+| **VAN 사** | **vanCorpCode** |
+| ㈜한국사이버결제 | KCP |
+| 한국정보통신주식회사 | KICC |
+| 나이스정보통신 | NICE |
+| 한국신용카드결제㈜ | KOCES |
+| 한국결제네트웍스(구 퍼스트데이터코리아) | FDIK |
+| ㈜케이에스넷 | KSNET |
+| 금융결제원 | CMNKFTC, ORGKFTC |
+| KIS정보통신 주식회사 | KIS |
+| 주식회사 코밴 | KOVAN |
+| 나이스페이먼츠(구 제이티넷) | JTNET |
+| 주식회사 스마트로 | SMTR |
+| 다우데이타 | DAU |
+| 섹타나인(구 에스피씨) | SPC |
+| 이니시스 | INICIS |
+
+※ 금융결제원 : CMNKFTC (TID가 16자리인 경우), ORGKFTC (TID가 6자리인 경우)
+
+### 결제수단 코드
+
+|  |  |
+| --- | --- |
+| **결제수단** | **PaymentMethodCode** |
+| 신용카드 | 00 |
+| PAYCO 포인트 | 10 |
+| PAYCO 쿠폰(식권) | 20 |
+
+### 결제수단별 승인사 코드
+
+|  |  |  |
+| --- | --- | --- |
+| **결제수단** | **승인사명(ApprovalCompanyName)** | **승인사코드(ApprovalcompanyCode)** |
+| PAYCO 신용카드 | [승인/매입사 매핑테이블](#_승인사/매입사_매핑_테이블) 참고 | [승인/매입사 매핑테이블](#_KCP_승인사/매입사_매핑) 참고 |
+| PAYCO 포인트 | NHN | NHN |
+| PAYCO 쿠폰 | NHN | NHN |
+| PAYCO 식권 | PAYCO비즈플러스 | PBIZ |
+
+### PG(KCP) 결제 신용카드 승인/매입사 매핑테이블
+
+|  |  |  |
+| --- | --- | --- |
+| **승인사코드** | **승인사명** | **매입사코드** |
+| CCKM | 국민 | CCKM |
+| CCKA | 카카오뱅크카드 | CCKM |
+| CCLG | 신한카드 | CCLG |
+| CCSS | 삼성 | CCSS |
+| CCDI | 현대 | CCDI |
+| CCAM | 롯데아멕스 | CCAM |
+| CCLO | 롯데 | CCAM |
+| CCBC | 비씨 | CCBC |
+| CCCJ | 제주 | CCBC |
+| CCJB | 전북 | CCBC |
+| CCKJ | 광주 | CCBC |
+| CCPH | 우리(BC) | CCBC |
+| CCWR | 우리(독자) | CCWR |
+| CCSU | 수협 | CCBC |
+| CCHN | 하나 | CCKE |
+| CCKE | 외환 | CCKE |
+
+### 결과코드 및 에러정보
+
+|  |  |
+| --- | --- |
+| **resultCode** | **Description** |
+| 0 | 성공(기취소 건 포함) |
+| 400 | 요청 정보가 유효하지 않음 (상세메세지 확인) |
+| 1001 | 지원하지 않는 PG정보 |
+| 2001 | 인증 실패 |
+| 2002 | Invalid Signature |
+| 2003 | 허가되지 않은 POS단말 |
+| 3001 | PG 승인실패 |
+| 4001 | VAN 승인실패 |
+| 500 | Internal Server Error |