KIS정보통신 POSPORTAL

4.1. 윈도우 Agent 4.1.2. 거래 기능 4.1.2.2. 현금영수증

검색 결과가 없습니다.

↑ ↓ Navigate

ESC Close

4.1.2.2. 현금영수증

03.KisPosAgent개발가이드 Event 버전을 토대로 작성 됨. [메서드 리스트]<table><thead><tr><th>기능</th><th>메서드명</th><th>기능</th><th>파라미터</th><th>리턴 값</th></tr></thead><tbody><tr><td>초기화</td><td>Init</td><td>모든 프로퍼티 초기화</td><td>void</td><td>[0] 성공 그 외 비정상</td></tr><tr><td>KIS-NAGT 결제요청</td><td>KIS_ICApproval</td><td>결제요청함수</td><td>void</td><td>[0] 결제 응답전문 수신 [-23] KIS-NAGT 접속 실패</td></tr><tr><td>결제종료 이벤트</td><td>OnApprovalEnd</td><td>결제완료이벤트 함수</td><td>void</td><td> </td></tr><tr><td>상태 이벤트</td><td>OnApprovalChanged</td><td>결제 중 현재 상태를 알려주는 이벤트 함수</td><td>void</td><td> </td></tr></tbody></table>[결제 요청]<table><thead><tr><th>프로퍼티명</th><th>설명</th><th>H1</th><th>H2</th><th>MaxSize</th><th>세부 설명</th></tr></thead><tbody><tr><td>inTranCode</td><td>전문구분코드</td><td>●</td><td>●</td><td>2</td><td>"NV" : Event 버전 필수코드</td></tr><tr><td>inTradeType</td><td>거래 구분</td><td>●</td><td>●</td><td>2</td><td>"H1" : 현금영수증 승인"H2": 현금영수증 취소</td></tr><tr><td>inAgentIP</td><td>KIS-NAGT IP</td><td>●</td><td>●</td><td>10</td><td>KIS-NAGT 설치 된 PC의 IP (로컬 : "127.0.0.1")</td></tr><tr><td>inAgentPort</td><td>KIS-NAGT PORT</td><td>●</td><td>●</td><td>4</td><td>KIS-NAGT 설치 된 PC의 PORT (디폴트 : 1515)</td></tr><tr><td>inAddressNo1</td><td>요청 목적지 주소정보1</td><td>◎</td><td>◎</td><td>15</td><td>서버 IP (디폴트 : Agent 설정 값)테스트:210.112.100.97 운영:210.112.100.63</td></tr><tr><td>inAddressNo2</td><td>요청 목적지 주소정보2</td><td>◎</td><td>◎</td><td>6</td><td>서버 PORT(디폴트:Agent 설정 값) 일반:60201 병원:60202</td></tr><tr><td>inCatId</td><td>단말기번호</td><td>◎</td><td>◎</td><td>10</td><td>가맹점단말기번호 (디폴트:Agent 설정 메뉴 값)</td></tr><tr><td>inSignYN</td><td>전자서명구분</td><td>●</td><td>●</td><td>1</td><td>"Y" : 전자서명을 Agent 통하여 입력받음 "N" : 전자서명을 Agent 통하지 않고 직접 서명데이터 넘겨줄 때 이용 "" : 무서명결제 (서명없음) ※ 5만원 이상 결제와 무관하게 보내야 함</td></tr><tr><td>inSignFileName</td><td>서명파일명</td><td>●</td><td>●</td><td>120</td><td>서명파일 저장 경로 (절대 경로) ※ 무서명 결제의 경우 inSignFileName : "" 로 필수로 설정</td></tr><tr><td>inTranGubun</td><td>거래수단구분</td><td>◎</td><td>◎</td><td>1</td><td>"C" : IC카드입력, 디폴트 : 옵션에 설정한 우선순위</td></tr><tr><td>inCashAuthId</td><td>현금영수증 개인정보</td><td>◎</td><td>◎</td><td>13</td><td>핸드폰번호 및 사업자번호 (POS 에서 입력 후 전달 시) 자진발급 : "0100001234" 로 입력</td></tr><tr><td>inInstallment</td><td>할부개월</td><td>◎</td><td>◎</td><td>2</td><td>00 : 소득공제 01 : 사업자지출증빙</td></tr><tr><td>inTranAmt</td><td>결제금액</td><td>●</td><td>●</td><td>8</td><td>결제금액</td></tr><tr><td>inVatAmt</td><td>부가세액</td><td>◎</td><td>◎</td><td>8</td><td>부가세액</td></tr><tr><td>inSvcAmt</td><td>봉사료</td><td>◎</td><td>◎</td><td>8</td><td>봉사료</td></tr><tr><td>inOrgAuthDate</td><td>원거래일자</td><td>○</td><td>●</td><td>6</td><td>원거래승인일자 YYMMDD (취소거래 시에만 입력)</td></tr><tr><td>inOrgAuthNo</td><td>원승인번호</td><td>○</td><td>●</td><td>12</td><td>원거래승인번호 (취소거래 시에만 입력)</td></tr><tr><td>inOilInfo</td><td>유종정보</td><td>◎</td><td>◎</td><td>14</td><td>아래 유종정보 표 확인</td></tr><tr><td>inVanKeyYN</td><td>VanKey 사용여부</td><td>◎</td><td>◎</td><td>1</td><td>VanKey 사용 여부 (병원 가맹점의 경우 "Y" 필수 설정) Y : 사용 N : 미사용</td></tr><tr><td>inHospitalYN</td><td>병원정보 사용여부</td><td>◎</td><td>◎</td><td>1</td><td>병원정보 입력 사용 여부 "Y" 인 경우 inVanKeyYN 도 "Y"로 설정 필수</td></tr><tr><td>inHospitalInfo</td><td>병원정보</td><td>◎</td><td>◎</td><td>Var</td><td>병원정보 데이터</td></tr><tr><td>inUnitMode</td><td>UI 출력모드</td><td>◎</td><td>◎</td><td>1</td><td>"0" : 미출력 "1" : 출력</td></tr><tr><td>inUnitLockYN</td><td>동기/비동기 선택</td><td>◎</td><td>◎</td><td>1</td><td>"N" : 비동기 "Y" : 동기</td></tr><tr><td>inDepositAmt</td><td>컵보증금</td><td>◎</td><td>◎</td><td>7</td><td>컵보증금</td></tr></tbody></table><ul><li>유종정보 (inOilInfo)</li></ul><table><thead><tr><th>항목</th><th>MODE</th><th>MaxSize</th><th>세부 설명</th></tr></thead><tbody><tr><td>면세유 공급 구분</td><td>AN</td><td>1</td><td>면세유(농협) : [1]농기계 [2]선박 [3]양식 기타(신한, 국민, 우리비씨) : [T] 신한택시면세유 외</td></tr><tr><td>유종코드</td><td>AN</td><td>1</td><td>면세유: [1]휘발유 [2]실내등유 [3]등유 [4]경유 [7]부탄 [8]고급유 기타 : [1]휘발유 [2]실내등유 [3]보일러등유 [4]경유 [5]윤활유 [6]중유 [7]가스</td></tr><tr><td>유량</td><td>N</td><td>6</td><td>Leading zero. 신한면세유(XXXX.XX) : 소수점 이하 2자리 표기 (소수점은 포함 하지 않음)</td></tr><tr><td>외상결제일</td><td>N</td><td>6</td><td>면세유 : YYMMDD / 신한면세유-단가(6) Leading zero</td></tr></tbody></table>[결제 응답]<table><thead><tr><th>프로퍼티명</th><th>설명</th><th>H1</th><th>H2</th><th>MaxSize</th><th>세부 설명</th></tr></thead><tbody><tr><td>outRtn</td><td>리턴값</td><td>●</td><td>●</td><td>1</td><td>Agent와 통신 결과 값</td></tr><tr><td>outCatId</td><td>단말기번호</td><td>●</td><td>●</td><td>10</td><td>가맹점 단말기 번호</td></tr><tr><td>outAgentCode</td><td>Agent 응답코드</td><td>●</td><td>●</td><td>4</td><td>Agent 응답코드 "0000" : 정상, 외에는 비정상</td></tr><tr><td>outReplyCode</td><td>응답코드</td><td>●</td><td>●</td><td>4</td><td>서버 응답코드 "0000" : 정상, 외에는 비정상</td></tr><tr><td>outTranAmt</td><td>결제금액</td><td>●</td><td>●</td><td>8</td><td>결제금액</td></tr><tr><td>outAuthNo</td><td>승인번호</td><td>●</td><td>●</td><td>13</td><td>승인번호</td></tr><tr><td>ouReplyDate</td><td>거래일자</td><td>●</td><td>●</td><td>8</td><td>거래일자(YYYYMMDD)</td></tr><tr><td>outMerchantRegNo</td><td>가맹점번호</td><td>●</td><td>●</td><td>20</td><td>가맹점번호</td></tr><tr><td>outCardNo</td><td>카드빈</td><td>◎</td><td>◎</td><td>6</td><td>카드빈 6자리</td></tr><tr><td>outReplyMsg1</td><td>메시지1</td><td>●</td><td>●</td><td>40</td><td>메시지 1</td></tr><tr><td>outReplyMsg2</td><td>메시지2</td><td>●</td><td>●</td><td>80</td><td>메시지 2</td></tr><tr><td>outTradeNum</td><td>거래일련번호</td><td>◎</td><td>◎</td><td>8</td><td>거래일련번호</td></tr><tr><td>outTradeReqDate</td><td>거래요청날짜</td><td>◎</td><td>◎</td><td>8</td><td>거래요청날짜 (YYYYMMDD)</td></tr><tr><td>outTradeReqTime</td><td>거래요청시간</td><td>◎</td><td>◎</td><td>6</td><td>거래요청시간 (hhmmss)</td></tr><tr><td>outWCC</td><td>거래타입</td><td>◎</td><td>◎</td><td>1</td><td>S : MSR, 삼성페이 s : 서명패드를 통한 MST 삼성페이 승인 C : IC 결제 P : 암호화 키인 K : 키인 (현금영수증 등)</td></tr><tr><td>outBarCodeNumber</td><td>바코드</td><td>◎</td><td>◎</td><td>40</td><td>바코드 번호</td></tr><tr><td>outArrivedData</td><td>상태체크</td><td>◎</td><td>◎</td><td>2</td><td>OnApprovalChanged 함수 호출 시 사용 "IC" : IC 카드 리딩 중 "FB" : FB 카드 리딩 중 "IS" : IC + 서명패드 통한 MST 삼성페이 진행 중 "TN" : IC + 서명패드 고객정보입력 "KI" : 키인 승인 중 "UQ" : BCQR 리딩 중 "PN" : 핀 입력 중 "SN" : 서명 입력 중 "NV" : 신용 승인 중</td></tr><tr><td>outEightCardNo</td><td>8자리 카드빈</td><td>◎</td><td>◎</td><td>8</td><td>8자리 카드빈처리 가능 리더기인 경우 8자리 카드빈 데이터</td></tr></tbody></table>[샘플코드 - 현금영수증승인]axKisPosAgent1.inTranCode = "NV"; axKisPosAgent1.inTradeType= "H1"; axKisPosAgent1.inTranAmt = "1004"; axKisPosAgent1.inAgentIP = "127.0.0.1"; axKisPosAgent1.inAgentPort = 1515; axKisPosAgent1.KIS_ICApproval();

4.1.2.1. 신용 결제

4.1.2.3. 통합 간편 결제

KIS정보통신(주)

개인정보처리방침