@nhnpayco-dev/mcp-devcenter 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (68) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +197 -0
  3. package/dist/data/api-specs.json +8135 -0
  4. package/dist/data/error-codes.json +2212 -0
  5. package/dist/data/guides/calculate.md +164 -0
  6. package/dist/data/guides/calculate.meta.json +22 -0
  7. package/dist/data/guides/membership-api.md +967 -0
  8. package/dist/data/guides/membership-api.meta.json +27 -0
  9. package/dist/data/guides/membership-check.md +30 -0
  10. package/dist/data/guides/membership-check.meta.json +24 -0
  11. package/dist/data/guides/membership-code.md +59 -0
  12. package/dist/data/guides/membership-code.meta.json +22 -0
  13. package/dist/data/guides/membership-sample.md +23 -0
  14. package/dist/data/guides/membership-sample.meta.json +22 -0
  15. package/dist/data/guides/membership-start.md +74 -0
  16. package/dist/data/guides/membership-start.meta.json +26 -0
  17. package/dist/data/guides/membership-vmem.md +512 -0
  18. package/dist/data/guides/membership-vmem.meta.json +24 -0
  19. package/dist/data/guides/offline-api.md +743 -0
  20. package/dist/data/guides/offline-api.meta.json +50 -0
  21. package/dist/data/guides/offline-authapi.md +1170 -0
  22. package/dist/data/guides/offline-authapi.meta.json +81 -0
  23. package/dist/data/guides/offline-check.md +33 -0
  24. package/dist/data/guides/offline-check.meta.json +24 -0
  25. package/dist/data/guides/offline-code.md +138 -0
  26. package/dist/data/guides/offline-code.meta.json +22 -0
  27. package/dist/data/guides/offline-sample.md +34 -0
  28. package/dist/data/guides/offline-sample.meta.json +22 -0
  29. package/dist/data/guides/offline-start.md +99 -0
  30. package/dist/data/guides/offline-start.meta.json +25 -0
  31. package/dist/data/guides/offline-vcat.md +370 -0
  32. package/dist/data/guides/offline-vcat.meta.json +35 -0
  33. package/dist/data/guides/online-autopay.md +495 -0
  34. package/dist/data/guides/online-autopay.meta.json +50 -0
  35. package/dist/data/guides/online-check.md +57 -0
  36. package/dist/data/guides/online-check.meta.json +24 -0
  37. package/dist/data/guides/online-code.md +367 -0
  38. package/dist/data/guides/online-code.meta.json +22 -0
  39. package/dist/data/guides/online-easypay.md +530 -0
  40. package/dist/data/guides/online-easypay.meta.json +50 -0
  41. package/dist/data/guides/online-etc.md +167 -0
  42. package/dist/data/guides/online-etc.meta.json +36 -0
  43. package/dist/data/guides/online-extra.md +190 -0
  44. package/dist/data/guides/online-extra.meta.json +35 -0
  45. package/dist/data/guides/online-extradata.md +103 -0
  46. package/dist/data/guides/online-extradata.meta.json +54 -0
  47. package/dist/data/guides/online-sample.md +23 -0
  48. package/dist/data/guides/online-sample.meta.json +22 -0
  49. package/dist/data/guides/online-start.md +122 -0
  50. package/dist/data/guides/online-start.meta.json +25 -0
  51. package/dist/data/guides/order-check.md +35 -0
  52. package/dist/data/guides/order-check.meta.json +24 -0
  53. package/dist/data/guides/order-code.md +143 -0
  54. package/dist/data/guides/order-code.meta.json +22 -0
  55. package/dist/data/guides/order-sample.md +31 -0
  56. package/dist/data/guides/order-sample.meta.json +22 -0
  57. package/dist/data/guides/order-start.md +94 -0
  58. package/dist/data/guides/order-start.meta.json +25 -0
  59. package/dist/data/guides/order-vorder.md +326 -0
  60. package/dist/data/guides/order-vorder.meta.json +24 -0
  61. package/dist/data/index.json +782 -0
  62. package/dist/data/sitemap.json +302 -0
  63. package/dist/data.js +42 -0
  64. package/dist/excel.js +320 -0
  65. package/dist/index.js +25 -0
  66. package/dist/tools.js +929 -0
  67. package/dist/validation-buffer.js +29 -0
  68. package/package.json +58 -0
@@ -0,0 +1,370 @@
1
+ # VCAT 연동하기
2
+
3
+ > **원본:** https://devcenter.payco.com/guide/offline/vcat/flow?id=2204010231
4
+ > **카테고리:** `offline-vcat`
5
+ > **포함 단계 (LNB):**
6
+ > - ② DLL 사용하기 (`/guide/offline/vcat/dll?id=2204010233`)
7
+ > - VCAT 연동하기 (`/guide/offline/vcat/flow?id=2204010231`)
8
+ > - ① VCAT 알아보기 (`/guide/offline/vcat/vcat?id=2204010232`)
9
+
10
+ ---
11
+
12
+ ## VCAT 연동하기
13
+
14
+ VCAT을 통한 결제 연동 상세 내용을 안내합니다.
15
+
16
+ ### 연동 프로세스 이해하기
17
+
18
+ ![VCAT flow 이미지](/img/@offline_vcat_flow.f63386f3.png)
19
+
20
+ 1. #### VCAT 알아보기
21
+
22
+ VCAT 파일 구성도를 참고하여 각 파일 별 기능을 확인해 보세요.
23
+ ※ PAYCO VCAT은 Visual Studio 6.0 MFC DLL로 제작되었으며, DLL 연동을 위한 [윈도우용 샘플소스](/guide/offline/sample?id=220401027) 를 제공하고 있습니다.
24
+      샘플소스에서 비동기 연동 방식을 참고하여 연동해 주세요.
25
+
26
+ ![VCAT 파일 구성도 이미지](/img/@offline_vcat_info.0b746392.png)
27
+
28
+ - ##### VCAT 파일 구성
29
+
30
+ VCAT 파일 구성
31
+
32
+ | 파일명 | 설명 |
33
+ | --- | --- |
34
+ | [PaycoNfc.dll](/guide/offline/vcat/PaycoNfcDll?id=2204010233) | 결제 연동 DLL 파일 입니다. |
35
+ | Payco.exe | 결제를 수행하는 메인 프로그램 입니다. |
36
+ | PaycoUpdate.exe | 패키지 업데이트 수행 프로그램 입니다. |
37
+ | PaycoLogMgr.exe | 패키지 로그관리 프로그램 입니다. |
38
+ | PaycoNfcLib.dll | 동글연동 DLL 파일 입니다. |
39
+ | PaycoSignPadCtrl.dll | 서명패드 연동 DLL 파일 입니다. |
40
+ | [PAYCO_ENV.ini](/guide/offline/vcat/env?id=2204010233) | 프로그램 환경설정 파일 입니다. |
41
+ | PAYCO_SHOPINFO.ini | 결제 발생할 가맹점정보 파일 입니다. 처음 실행하여 가맹점정보를 입력하면 생성됩니다. |
42
+ | QrGen.dll | QR코드 이미지 생성 DLL 파일 입니다. |
43
+
44
+ * VCAT 패키지 설치를 위해서는 DLL 파일([PaycoNfc.dll](https://paycoscdn.toastoven.net/payco/offline/pos/real/dll/PaycoNfc.dll))이 설치되어야 합니다.
45
+ * 관련 프로그램들은 DLL 함수 호출 시에 자동 설치가 됩니다. 함수 호출방법은 [DLL 함수사용](/guide/offline/vcat/dll?id=2204010233)에서 자세히 확인해 보세요.
46
+ - ##### PAYCO_ENV.ini 상세
47
+
48
+ VCAT 구동에 필수적으로 참조하는 환경설정 파일입니다. 개발환경 샘플 환경설정 파일은 [여기](https://paycoscdn.toastoven.net/payco/offline/pos/env/alpha/PAYCO_ENV.ini) 를 눌러 받아주세요.
49
+
50
+ **잠깐만요!**
51
+
52
+ 운영환경 배포시에 반드시 ENV_MODE(개발, 운영환경 여부)를 확인해서 배포해 주세요.
53
+
54
+ PAYCO_ENV.ini 상세
55
+
56
+ | 옵션 | 설명 | 옵션값 |
57
+ | --- | --- | --- |
58
+ | ENV_MODE | 개발,운영 환경 모드 구분 설정 값입니다. | T : 개발환경 R : 운영환경 |
59
+ | KIOSK_POS | POS, KIOSK모드 구분 설정 값입니다. | N : POS Y : KIOSK |
60
+ | ONLY_BARCODE_YN | 바코드 사용 여부 설정 값입니다. | Y : 바코드만 사용 N : 바코드/QR(KIOSK) 사용 |
61
+ | POS_APPROVAL_AUTO | 인증 요청과 승인 요청 제어 설정 값입니다. | Y : 별도 제어 없음 |
62
+ | PAY_COMPLETE_AUTO | 결제 완료 팝업 제거 설정 값입니다. | N : 확인버튼을 눌러 수동 종료(기본값) Y : 3초 후 자동 종료 X : 화면 제거 |
63
+ - ##### KIOSK 단말기의 경우 아래 옵션값도 추가해 주세요.
64
+
65
+ PAYCO_ENV.ini 상세
66
+
67
+ | 옵션 | 설명 | 옵션값 |
68
+ | --- | --- | --- |
69
+ | ONLY_QR_YN | QR 결제 모드 설정 값입니다. | Y : QR결제만 사용 D : QR+BARCODE 결제 사용 |
70
+ | KIOSK_RESOLUTION | 해상도별 키오스크 UI 설정 값입니다. | S:600*600 H:1024*768(기본값) E:848*1104 |
71
+ | KIOSK_NFC_TIME | PAYCO 바코드 리딩 대기화면의 대기 시간 설정 값입니다. 시간 초과시 결제대기창 종료됩니다. | 195(기본값) |
72
+ | KIOSK_BAR_TIME | 수동입력 바코드 결제대기 화면 대기 시간 설정 값입니다. | 135(기본값) |
73
+ | KIOSK_QR_TIME | QR 결제대기 화면 대기 시간 설정 값입니다. | 180(기본값) |
74
+ | KIOSK_COMPLETE_AUTO | 결제 완료 팝업 제거 설정 값입니다. | Y:5초 후 자동 종료 X:화면 제거(기본값) |
75
+ - ##### 윈도우 이벤트
76
+
77
+ VCAT에서 결제 도중에 단말기로 윈도우 이벤트를 전달합니다. 각 이벤트 별 설명을 확인하시고 상황에 맞게 개발해 주세요.
78
+
79
+ 윈도우 이벤트
80
+
81
+ | EventID | cbData | 설명 |
82
+ | --- | --- | --- |
83
+ | EndEvent | Len(lpData+1) | 결제 종료시 발생하는 이벤트입니다. |
84
+ | EndEvent+1 | Len(lpData+1) | 카드디텍 및 수동 바코드입력 선택 시 발생하는 이벤트입니다. |
85
+ | EndEvent+2 | Len(lpData+1) | 결제수단 인증완료 이벤트입니다. |
86
+ | EndEvent+3 | Len(lpData+1) | 사인패드 연동 요청 이벤트입니다. 요청 후에 20초(default) 동안 NfcSendSignData 함수 미호출 시 PAYCO에서는 무서명 으로 결제가 진행됩니다. 사인 연동 중에 결제종료 이벤트(EndEvent) 수신 시 사인 연동을 종료해 주세요. |
87
+ | EndEvent+4 | Len(lpData+1) | 승인진행 시 사인패드 연동 중 타임아웃(20초) 발생 시 전달되는 이벤트입니다. |
88
+ | EndEvent+10 | Len(lpData+1) | 페이코 결제창이 나타나는 시점의 이벤트입니다. |
89
+ - ##### 사인패드 화면 구성
90
+
91
+ 사인패드 화면 구성
92
+
93
+ | VAN사 | 사인패드 SET | 예시 |
94
+ | --- | --- | --- |
95
+ | FDIK | 메시지 라인의 수|msg1|msg2|단말기번호(8자리)|거래일련번호(6자리)|카드번호(16자리) | 2|60000원|서명해 주세요.|단말기번호|거래일련번호|카드번호 |
96
+ | 그 외 VAN사 | 메시지 라인의 수|msg1|msg2 | 2|60000원|서명해주세요 |
97
+ 2. #### DLL 함수 사용하기
98
+
99
+ DLL에서 제공하는 함수를 사용하여 결제를 연동해 보세요.
100
+
101
+ **잠깐만요!**
102
+
103
+ 결제마다 DLL 연결, 해제를 반복하게 되면 결제 속도가 늦어 질 수 있습니다.
104
+ 단말기 프로그램 시작, 종료시에 DLL연결, 해제를 해주세요.
105
+
106
+ - ##### PaycoNfc.dll 상세
107
+
108
+ 라이브러리 함수 목록입니다. 필수로 사용해야 하는 함수들로 구성되어 있으니 사용순서와 결제 환경에 맞게 사용해 주세요.
109
+
110
+ 사인패드 화면 구성
111
+
112
+ | 함수명 | 리턴값 | 파라미터 | 설명 |
113
+ | --- | --- | --- | --- |
114
+ | NfcDailyRun | void | | 개점 업무 처리 함수입니다. 단말기 프로그램 구동 시에 실행해주세요. |
115
+ | NfcInit | void | | 페이코POS 실행 전 값을 전달해 주는 변수를 초기화 해주는 함수입니다. SetPaycoData 함수 전에 호출해 주세요. |
116
+ | [SetPaycoData](/guide/offline/vcat/set?id=2204010233) | void | String, String | 페이코 결제 데이터를 설정하는 함수입니다. NfcASyncRun 함수 전에 호출해 주세요. |
117
+ | NfcASyncRun | void | Window Handle | 페이코 서비스를 시작하는 함수입니다. 시작전에 필요한 값들을 SetPaycoData 함수로 셋팅해 주세요. |
118
+ | [GetPaycoData](/guide/offline/vcat/get?id=2204010233) | void | String | 페이코 결제 결과를 받아오는 함수 입니다. |
119
+ | NfcSendASyncEnd | void | | NfcASyncRun 함수와 쌍이 되는 페이코 서비스를 종료하는 함수입니다. 결제종료시에만 실행해 주세요. |
120
+ - ##### 추가로 사용할 수 있는 함수들도 같이 확인해 보세요.
121
+
122
+ 사인패드 화면 구성
123
+
124
+ | 함수명 | 리턴값 | 파라미터 | 설명 |
125
+ | --- | --- | --- | --- |
126
+ | NfcSendBarcode | void | String | 바코드 번호를 전달하는 함수 입니다. OPOS 혹은 Serial 타입 바코드 리더기를 사용하는 경우에 사용해 주세요. |
127
+ | [NfcSendSignData](/guide/offline/vcat/nfc?id=2204010233) | void | String, String, String, String,String | 사인패드 연동 후 SignPad Data를 전송하는 함수입니다. 서명거래시 사용해 주세요. |
128
+ | NfcSendNetworkCancel | int | | 승인완료후 후처리 오류 시 망취소요청 함수입니다. |
129
+ - ##### SetPaycoData 상세
130
+
131
+ 결제정보를 셋팅하는 함수 입니다. 각 KEY별 정보를 셋팅하여 결제 요청하세요.
132
+
133
+ SetPaycoData 상세
134
+
135
+ | KEY | 필수여부 | 설명 |
136
+ | --- | --- | --- |
137
+ | RegistrationNumber | Y | 사용하시는 사업자번호 입니다. 미설정 시 직접 입력 받는 화면이 노출됩니다. 등록 후에는 ‘PAYCO_SHOPINFO.ini’ 파일 참조하여 결제가 발생합니다. ex) 1448115557 |
138
+ | VanPosId | Y | 사용하시는 VAN POS TID 입니다. 미설정 시 직접 입력 받는 화면이 노출됩니다. 등록 후에는 ‘PAYCO_SHOPINFO.ini’ 파일 참조하여 결제가 발생합니다. ex) 1002189853 |
139
+ | VanCode | Y | [VAN사 코드](/guide/offline/code/vancode?id=220401025) ex) KCP |
140
+ | TradeMethod | Y | 거래 구분 (승인요청:APPROVAL, 취소요청:CANCEL) ex) APPROVAL |
141
+ | TotalAmount | Y | 결제 총 금액(컵보증금 포함) ex) 1000 |
142
+ | TotalTaxfreeAmount | N | 면세 금액 ex) 0 |
143
+ | TotalTaxableAmount | N | 과세 금액 ex) 910 |
144
+ | TotalVatAmount | N | 부가세 금액 ex) 90 |
145
+ | TotalServiceAmount | N | 봉사료 금액 ex) 0 |
146
+ | TotalGreenDepositAmount | N | 컵보증금 ex) 0 |
147
+ | ProductName | Y | 대표 상품명 입니다. 고객에게 상품정보 노출하기 위해 값을 설정해 주세요. 상품이 2건 이상인 경우 대표상품명 외 @건으로 표기해 주세요. ex) 아메리카노 외1건 |
148
+ | [ProductList](/guide/offline/vcat/prodlist?id=2204010233) | Y | 상품 상세 LIST 입니다.(시작 구분 값:0x02, 상품 구분 값:0x01, 종료 구분 값:0x03 ex) (0x02)20124(0x01)라떼(0x01)3500(0x01)2(0x01)Y(0x03) |
149
+ | ProductListFieldCount | Y | 상품개수가 아닌 상품 리스트의 필드 개수 입니다. 5개로 설정해 주세요. ex) 5 |
150
+ | WindowTopMostYN | Y | PAYCO 결제창을 최상단 창으로 노출여부 설정 값입니다. ex) Y |
151
+ | AutoPosRegisterYN | Y | 가맹점정보가 변경될 경우 별도 입력화면 없이 ‘PAYCO_SHOPINFO.ini’ 파일에 적용여부 설정 값입니다. ex) Y |
152
+ | SendNetworkCancelYN | Y | 망취소 사용여부 설정 값입니다. ex) Y |
153
+ | NocvmYN | Y | no CVM 설정 값입니다. 5만원 초과 시 ‘N’, 5만원 이하 거래시 ‘Y’ 값으로 설정해 주세요. ex) Y |
154
+ | SignpadYN | Y | 사인패드 장착여부 설정 값입니다. ex) Y |
155
+ | SignEventUseYN | Y | 사인패드를 Event로 POS에서 처리가 가능여부 설정 값입니다. ‘Y’ 값으로 설정하지 않을 경우 무서명으로 진행됩니다. ex) Y |
156
+ | ServiceType | Y | 서비스 타입입니다. “PAYCO” 값으로 설정해 주세요. ex) PAYCO |
157
+ | PosDevCorpName | N | POS개발사 명을 설정해 주세요. ex) NHN PAYCO |
158
+ | PosSolutionName | N | POS솔루션 명을 설정해 주세요. ex) PAYCO KIOSK |
159
+ | PosSolutionVersion | N | POS 솔루션 버전을 설정해 주세요. ex) 2.1.2.0 |
160
+ | ASyncEndEventID | N | 윈도우 이벤트 EndEvent 값입니다. 기본 값은 35000 입니다. |
161
+ | ApprovalNo | Y(취소거래 시 필수) | 취소거래 시 승인번호를 설정해 주세요. ex) 9424606 |
162
+ | ApprovalDatetime | Y(취소거래 시 필수) | 취소거래 시 승인일시를 설정해 주세요. ex) 20160928115339 |
163
+ | ApprovalAmount | Y(취소거래 시 필수) | 취소거래 시 포인트 및 쿠폰 금액을 제외한 신용카드 결제금액을 설정해 주세요. ex) 500 |
164
+ - ##### 스마트로 VAN
165
+
166
+ VAN사 별 추가 필수 KEY 값도 셋팅해 주세요.
167
+
168
+ 스마트로 VAN
169
+
170
+ | KEY | VAN사 | 설명 |
171
+ | --- | --- | --- |
172
+ | MerchantCode | 스마트로 | 가맹점코드 ex) SPOS |
173
+ | PosEntryMode | 스마트로 | PEM ex) 0 |
174
+ - ##### FDIK VAN
175
+
176
+ FDIK VAN
177
+
178
+ | KEY | VAN사 | 설명 |
179
+ | --- | --- | --- |
180
+ | MerchantPosNo | FDIK | 발급받은 Serial번호 ex) 123456 |
181
+ - ##### ProductList 상세
182
+
183
+ **잠깐만요!**
184
+
185
+ 프로모션여부는 페이코 식권, 쿠폰 등의 사용을 위해서 ‘Y’값으로 설정해 주세요.
186
+
187
+ ProductList 상세
188
+
189
+ | 필드 | 예시 |
190
+ | --- | --- |
191
+ | 상품코드 | 20123 |
192
+ | 상품명 | 아메리카노 |
193
+ | 상품단가 | 2500 |
194
+ | 상품개수 | 1 |
195
+ | 프로모션여부 | Y |
196
+ - ##### SetPaycoData – 호출 Sample
197
+
198
+ **결제 승인 요청**
199
+
200
+ ```
201
+ SetPaycoData("RegistrationNumber", "1448115557")
202
+ SetPaycoData("VanPosId", "1002189853")
203
+ SetPaycoData("VanCode", "KCP")
204
+ SetPaycoData("TradeMethod", "APPROVAL")
205
+ SetPaycoData("TotalAmount", "61600")
206
+ SetPaycoData("ProductName", "사과 외 2건")
207
+ SetPaycoData("ProductList", "(0x02)20123(0x01)사과(0x01)2500(0x01)1(0x01)Y(0x01)20124(0x01)귤(0x01)3500(0x01)2(0x01)Y(0x03))
208
+ SetPaycoData("ProductListFiledCount", "5")
209
+ SetPaycoData("WindowTopMostYN", "Y")
210
+ SetPaycoData("AutoPosRegisterYN", "Y")
211
+ SetPaycoData("SendNetworkCancelYN", "Y")
212
+ SetPaycoData("NocvmYN", "N")
213
+ SetPaycoData("SignpadYN", "Y")
214
+ SetPaycoData("SignEventUseYN", "Y")
215
+ SetPaycoData("ServiceType", "PAYCO")
216
+ SetPaycoData("PosDevCorpName", "NHN PAYCO")
217
+ SetPaycoData("PosSolutionName", "vCAT데몬 Solution")
218
+ SetPaycoData("PosSolutionVersion", "Ver 1.0.0.0")
219
+ ```결제 취소 요청**
220
+
221
+ ```
222
+ SetPaycoData("TradeMethod", "CANCEL")
223
+ SetPaycoData("ApprovalNo", "13252104")
224
+ SetPaycoData("ApprovalDatetime", "20180813132521")
225
+ SetPaycoData("TotalAmount", "61600")
226
+ SetPaycoData("ApprovalAmount", "61600")
227
+ SetPaycoData("NocvmYN", "N")
228
+ SetPaycoData("VanCode", "KCP")
229
+ SetPaycoData("SignpadYN", "Y")
230
+ SetPaycoData("SignEventUseYN", "Y")
231
+ SetPaycoData("ASyncEndEventID", "1000")
232
+ SetPaycoData("ServiceType", "PAYCO")
233
+ SetPaycoData("WindowTopMostYN", "Y")
234
+ ```- ##### NfcSendSignData 상세
235
+
236
+ 서명데이터를 전달하는 함수입니다. 각 파라미터에 알맞은 정보를 셋팅하여 요청해 주세요.
237
+
238
+ NfcSendSignData 상세
239
+
240
+ | 파라미터 | 설명 |
241
+ | --- | --- |
242
+ | 연동결과 | 서명 연동결과 값을 입력해 주세요. ex) SUCCESS : 서명 연동 진행 EXCEPTION : 무서명으로 진행 SIGN_CANCEL : 서명 입력란에서 결제 취소 |
243
+ | 사인데이터길이 | 사인데이터의 길이를 입력해 주세요. ex) 192 |
244
+ | 사인데이터 | 사인패드로 입력받은 사인데이터를 입력해 주세요. ex) CBD5DE7324D53DCDD34A6EE97B43B84EBB… |
245
+ | 이미지경로 | 사인 이미지의 절대경로를 입력해주세요. ex) C:\POS\sign |
246
+ | 추가데이터 | 특정 VAN사에서 인증/복호화등 작업에 사용하는 데이터를 입력해 주세요 |
247
+ - ##### GetPaycoData 상세
248
+
249
+ 결제정보를 받아오는 함수 입니다. 각 KEY별 필요한 정보를 받아 사용하세요.
250
+ [영수증 노출 요소](/guide/offline/vcat/receipt?id=2204010233)를 참고하여 필요한 결제정보를 받아 사용해 보세요.
251
+
252
+ NfcSendSignData 상세
253
+
254
+ | KEY | 설명 |
255
+ | --- | --- |
256
+ | ResCd | 응답코드 0 인 경우 승인성공, 그 외의 값은 승인실패 입니다. |
257
+ | ResMsg | 응답메세지 |
258
+ | SourceResultCode | 원천사(PG/VAN) 응답코드 |
259
+ | SourceMessage | 원천사(PG/VAN) 응답메세지 |
260
+ | TradeMethod | 거래방식(예 : VAN, PG) |
261
+ | TradeNo | PG/VAN 거래번호 |
262
+ | ServiceType | 서비스타입. POS 매출 집계에 표시할 때 사용합니다. (예 : PAYCO) |
263
+ | PaymentMethodCode | 오프라인 결제수단코드 |
264
+ | PaymentMethodName | 결제수단명 |
265
+ | MainPaymentMethodCode | 주 오프라인 결제수단코드 |
266
+ | MerchantKey | 가맹점키 |
267
+ | MerchantName | 가맹점명 |
268
+ | PointName | 사용한 포인트명 |
269
+ | PointAmt | 사용한 포인트 금액 |
270
+ | CouponName | 사용한 쿠폰명 |
271
+ | CouponAmt | 사용한 쿠폰금액 |
272
+ | CardNo | 카드번호 |
273
+ | InstallmentPeriod | 할부기간 |
274
+ | ApprovalNo | 승인번호 |
275
+ | ApprovalDatetime | 승인일시 |
276
+ | ApprovalAmount | 포인트 및 쿠폰금액을 제외한 승인금액 |
277
+ | ApprovalCompanyName | 승인사명 |
278
+ | ApprovalCompanyCode | 승인사코드 |
279
+ | VanApprovalCompanyName | VAN사에서 정의한 승인사(발급사) 명 |
280
+ | VanApprovalCompanyCode | VAN사에서 정의한 승인사(발급사) 코드 |
281
+ | SourcePaymentMethodCode | 결제수단코드 |
282
+ | TradeRequestNo | 거래요청번호 |
283
+ | CancelDatetime | 취소일시 |
284
+ | TotalTaxfreeAmount | 면세금액 |
285
+ | TotalTaxableAmount | 과세금액 |
286
+ | TotalVatAmount | 부가세 |
287
+ | TotalServiceAmount | 봉사료 |
288
+ | TotalGreenDepositAmount | 컵보증금 |
289
+ | DeviceAuthType | 단말기 인증타입(예 : BAR) |
290
+ | MembershipCardNo | 멤버쉽 카드 번호(페이코와 멤버십 연동이 되어있고, 자동 적립을 사용 할 경우에만 사용됩니다.) |
291
+ | NocvmYN | NoCVM 거래 여부(5만원 초과시 : N , 5만원 이하 : Y) |
292
+ | SignImgFilePath | 서명 이미지의 전체경로 |
293
+ | CardMerchantNo | 카드 가맹점번호 |
294
+ | BuyCompanyName | 매입사명 |
295
+ | BuyCompanyCode | 매입사코드 |
296
+ | BuyTypeName | 매입방법명 |
297
+ | restGiftShopAmount | 기프트샵 금액형 잔액 |
298
+ | AddPayAmount | 기프트샵 결제시 결제 잔액 |
299
+ | maxGiftShopAmount | 기프트샵 쿠폰 사용가능 금액 |
300
+ - ##### GetPaycoData - 호출 Sample
301
+
302
+ **결제 승인 응답**
303
+
304
+ ```
305
+ GetPaycoData("ResCd")
306
+ GetPaycoData("ResMsg")
307
+ GetPaycoData("SourceResultCode")
308
+ GetPaycoData("SourceMessage")
309
+ GetPaycoData("TradeMethod")
310
+ GetPaycoData("TradeNo")
311
+ GetPaycoData("TradeRequestNo")
312
+ GetPaycoData("PaymentMethodCode")
313
+ GetPaycoData("PaymentMethodName")
314
+ GetPaycoData("MainPaymentMethodCode")
315
+ GetPaycoData("ServiceType")
316
+ GetPaycoData("ApprovalNo")
317
+ GetPaycoData("ApprovalDatetime")
318
+ GetPaycoData("ApprovalAmount")
319
+ GetPaycoData("ApprovalCompanyCode")
320
+ GetPaycoData("VanApprovalCompanyName")
321
+ GetPaycoData("VanApprovalCompanyCode")
322
+ GetPaycoData("SourcePaymentMethodCode")
323
+ GetPaycoData("CardNo")
324
+ GetPaycoData("CouponAmt")
325
+ GetPaycoData("PointAmt")
326
+ GetPaycoData("CouponName")
327
+ GetPaycoData("PointName"")
328
+ GetPaycoData("BuyCompanyName")
329
+ GetPaycoData("BuyTypeName")
330
+ ```결제 취소 응답**
331
+
332
+ ```
333
+ GetPaycoData ("ResCd")
334
+ GetPaycoData ("ResMsg")
335
+ GetPaycoData ("SourceResultCode")
336
+ GetPaycoData ("SourceMessage")
337
+ GetPaycoData ("TradeMethod")
338
+ GetPaycoData ("TradeRequestNo")
339
+ GetPaycoData ("ServiceType")
340
+ GetPaycoData ("ApprovalNo")
341
+ GetPaycoData ("ApprovalDatetime")
342
+ GetPaycoData ("ApprovalAmount")
343
+ GetPaycoData ("InstallmentPeriod")
344
+ GetPaycoData ("ApprovalCompanyName")
345
+ GetPaycoData ("ApprovalCompanyCode")
346
+ GetPaycoData ("VanApprovalCompanyName")
347
+ GetPaycoData ("VanApprovalCompanyCode")
348
+ GetPaycoData ("SourcePaymentMethodCode")
349
+ GetPaycoData ("CardNo")
350
+ GetPaycoData ("CardMerchantNo")
351
+ GetPaycoData ("BuyCompanyName")
352
+ GetPaycoData ("BuyTypeName")
353
+ ```### 영수증 노출 요소
354
+
355
+ 영수증에 노출해야 될 정보들을 확인해 주세요.
356
+
357
+ - #####
358
+ - ##### PAYCO 신용카드 결제 전표
359
+
360
+ ![vcat 영수증 이미지](/img/@offline_vcat_approvalreceipt.87d02161.jpg)
361
+ - ##### PAYCO 포인트 결제 전표
362
+
363
+ ![vcat 영수증 이미지](/img/@offline_vcat_pointreceipt.e5dfa632.jpg)
364
+
365
+ **잠깐만요!**
366
+
367
+ - 신용거래 영수증에서 가맹점번호, 매입사, 매입처는 PAYCO VAN 방식 결제일 경우 표기해 주세요.
368
+ - 쿠폰이 같이 사용된 경우(복합결제) 쿠폰금액도 같이 표기해 주세요.
369
+ - 취소거래의 경우 CancelDatetime 값을 추가하여 취소일시를 표기해 주세요.
370
+ - 취소거래의 경우 금액에 마이너스(-) 부호를 추가해 주세요.
@@ -0,0 +1,35 @@
1
+ {
2
+ "slug": "offline-vcat",
3
+ "id": "2204010231",
4
+ "url": "https://devcenter.payco.com/guide/offline/vcat/flow?id=2204010231",
5
+ "path": "/guide/offline/vcat/flow",
6
+ "title": "VCAT 연동하기",
7
+ "menu_text": "VCAT 연동하기",
8
+ "sections": [
9
+ {
10
+ "label": "② DLL 사용하기",
11
+ "path": "/guide/offline/vcat/dll",
12
+ "id": "2204010233"
13
+ },
14
+ {
15
+ "label": "VCAT 연동하기",
16
+ "path": "/guide/offline/vcat/flow",
17
+ "id": "2204010231"
18
+ },
19
+ {
20
+ "label": "① VCAT 알아보기",
21
+ "path": "/guide/offline/vcat/vcat",
22
+ "id": "2204010232"
23
+ }
24
+ ],
25
+ "h2_sections": [
26
+ "VCAT 연동하기"
27
+ ],
28
+ "h3_sections": [
29
+ "연동 프로세스 이해하기",
30
+ "영수증 노출 요소"
31
+ ],
32
+ "table_count": 13,
33
+ "code_block_count": 4,
34
+ "text_length": 10571
35
+ }