KIS정보통신 POSPORTAL

4.1. 윈도우 Agent 4.1.2. 거래 기능 4.1.2.5. 선불 결제

검색 결과가 없습니다.

↑ ↓ Navigate

ESC Close

4.1.2.5. 선불 결제

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><tr><td>요청 취소 함수</td><td>KIS_Agent_Stop</td><td>결제요청 후 중지하고 싶을 때 호출하는 함수</td><td>short</td><td>[0] 성공 그 외 비정상</td></tr></tbody></table>[결제 요청]<table><thead><tr><th>프로퍼티명</th><th>설명</th><th>D1</th><th>D2</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>"D1" : 신용승인 "D2" : 신용취소</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>"K" : KEY-IN, "s" : 삼성페이 OTC, "B" : 바코드</td></tr><tr><td>inBarCodeNumber</td><td>바코드번호</td><td>◎</td><td>◎</td><td>40</td><td>AppCard 번호 또는 삼성페이 OTC</td></tr><tr><td>inInstallment</td><td>할부개월</td><td>◎</td><td>◎</td><td>2</td><td>할부개월</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>inVanKeyYN</td><td>VanKey 사용여부</td><td>◎</td><td>◎</td><td>1</td><td>VanKey 사용 여부 (병원 가맹점의 경우 "Y" 필수 설정) Y : 사용 N : 미사용</td></tr><tr><td>inVanKey</td><td>승인 시 받은 VanKey</td><td>◎</td><td>◎</td><td>16</td><td>inVanKeyYN 을 "Y"로 셋팅하여 신용승인한 건의 취소일 때 outVanKey로 전달받은 값</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><tr><td>inBillionYN</td><td>선불카드 여부</td><td>◎</td><td>◎</td><td>1</td><td>사용 : "Y" 미사용 : "N"</td></tr><tr><td>inTranAmtNEWPOS</td><td>선불카드 총금액</td><td>◎</td><td>◎</td><td>12</td><td>EX)000000010000</td></tr><tr><td>inVatAmtNEWPOS</td><td>선불카드 부가세</td><td>◎</td><td>◎</td><td>12</td><td>EX)000000010000</td></tr><tr><td>inSvcAmtNEWPOS</td><td>선불카드 봉사료</td><td>◎</td><td>◎</td><td>12</td><td>EX)000000010000</td></tr><tr><td>inTradeSubType</td><td>서브 거래 구분</td><td>◎</td><td>◎</td><td>2</td><td>거래 서브 구분 코드 "C1" : KIS 선불 사용 "C2" : KIS 선불 사용 취소 "C3" : KIS 선불 판매 "C4" : KIS 선불 판매 취소 "C5" : KIS 선불 충전 "C6" : KIS 선불 충전 취소 "C7" : KIS 선불 조회 (금액 : 1원)</td></tr></tbody></table>[결제 응답]<table><thead><tr><th>프로퍼티명</th><th>설명</th><th>D1</th><th>D2</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>outAccepterCode</td><td>매입사코드</td><td>●</td><td>●</td><td>2</td><td>매입사코드</td></tr><tr><td>outAccepterName</td><td>매입사명</td><td>●</td><td>●</td><td>20</td><td>매입사명</td></tr><tr><td>outIssuerCode</td><td>발급사코드</td><td>●</td><td>●</td><td>2</td><td>발급사코드</td></tr><tr><td>outIssuerName</td><td>발급사명</td><td>●</td><td>●</td><td>2</td><td>발급사명</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>outCardGubun</td><td>카드구분</td><td>●</td><td>●</td><td>1</td><td>0 : 신용, 1: 체크, 2:기프트</td></tr><tr><td>outPurchaseGubun</td><td>매입구분</td><td>●</td><td>●</td><td>1</td><td>S : DESC, C : EDC, D : DDC</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>outVanKey</td><td>VanKey</td><td>◎</td><td>◎</td><td>16</td><td>inVanKeyYN 이 "Y"로 신용승인 시 발생하는 Van고유번호</td></tr><tr><td>outBarCodeNumber</td><td>바코드</td><td>◎</td><td>◎</td><td>40</td><td>바코드 번호</td></tr><tr><td>outCouponInformation</td><td>EMV 9F60 Tag</td><td>◎</td><td>◎</td><td>36</td><td>EMV 9F60 Tag BCQR 결제 시4E50으로 시작 시 네이버페이로 판단</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><tr><td>outPurchaseBal</td><td>KIS선불카드 잔액</td><td>◎</td><td>◎</td><td>12</td><td> </td></tr><tr><td>outPurchaseRefundAmt</td><td>KIS선불 환불가능 금액</td><td>◎</td><td>◎</td><td>12</td><td> </td></tr><tr><td>outPurchaseLimitAmt</td><td>KIS선불 신용카드 충전한도 금액</td><td>◎</td><td>◎</td><td>12</td><td> </td></tr><tr><td>outPrepaidCardName</td><td>KIS선불카드 명칭</td><td>◎</td><td>◎</td><td>50</td><td>IS선불카드 명칭</td></tr><tr><td>outPrepaidCardStatus</td><td>KIS선불카드 상태</td><td>◎</td><td>◎</td><td>2</td><td>KIS선불카드 상태(00: 정상, 01: 일시정지, 99 : 해지)</td></tr><tr><td>outCustmerID</td><td>고객사 회원아이디</td><td>◎</td><td>◎</td><td>20</td><td>고객사 회원 아이디</td></tr><tr><td>outPrepaidCardType</td><td>KIS선불카드 구분</td><td>◎</td><td>◎</td><td>2</td><td>KIS선불카드 구분 (01:충전형, 02:금액형, 03: 교환형)</td></tr></tbody></table>[샘플코드 - 선불카드조회]axKisPosAgent1.inTranCode = "NV"; axKisPosAgent1.inTradeType= "D1"; axKisPosAgent1.inTranAmtNEPWOS = "1"; axKisPosAgent1.inBillionYN = "Y"; axKisPosAgent1.inAgentIP = "127.0.0.1"; axKisPosAgent1.inAgentPort = 1515; axKisPosAgent1.inTradeSubType = "C7"; axKisPosAgent1.KIS_ICApproval();

4.1.2.4. 통합 결제

4.1.3. 기타 설정

KIS정보통신(주)

개인정보처리방침