KIS정보통신 POSPORTAL

4.1. 윈도우 Agent 4.1.2. 거래 기능 4.1.2.4. 통합 결제

검색 결과가 없습니다.

↑ ↓ Navigate

ESC Close

4.1.2.4. 통합 결제

03.KisPosAgent개발가이드 Event 버전을 토대로 작성 됨. Payco 결제는 현재 통합 간편결제를 통해서만 가능해요 :-) [메서드 리스트]<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>"IP" : Event 버전 필수코드</td></tr><tr><td>inTradeType</td><td>거래 구분</td><td>●</td><td>●</td><td>2</td><td>"D1" : 신용or간편결제승인 "D2" : 신용or간편결제취소</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>"B" : 바코드, "C" : IC카드입력</td></tr><tr><td>inBarCodeNumber</td><td>바코드번호</td><td>◎</td><td>◎</td><td>40</td><td>바코드번호 or QR코드</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>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>inDepositAmt</td><td>컵보증금</td><td>◎</td><td>◎</td><td>7</td><td>컵보증금</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>outPayType</td><td>간편결제 구분</td><td>●</td><td>●</td><td>3</td><td>간편결제 구분 "KKO" : 카카오페이 "SGP" : SSGPAY "ZRP" : 제로페이 "ALP" : 알리페이 "WEP" : 위챗페이 "LPY" : Lpay "APP" : 앱카드 "EMQ" : EMVQR(네이버페이, BC페이북 등) -&gt; inStructVer : V01인 경우 "EMQ" :BC페이북 -&gt; inStructVer : V02인 경우 "NVP" : 네이버페이-&gt; inStructVer : V02인 경우 "HNQ" : 하나원Q페이 -&gt; inStructVer : V02인 경우 "SPY" : 서울페이 "TSP" : 토스페이 "SSP" : 삼성페이 "BGQ" : BC GLOBAL QR</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>V(14)</td><td>거래일자(YYYYMMDD) 간편결제 시(YYYYMMDDhhmmss)</td></tr><tr><td>outAccepterCode</td><td>매입사코드</td><td>●</td><td>●</td><td>4</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>4</td><td>발급사코드</td></tr><tr><td>outIssuerName</td><td>발급사명</td><td>●</td><td>●</td><td>20</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>V(256)</td><td>카드빈 6자리 특수 바코드번호 결제 : OTC 결제된 카드 번호 (KKO)</td></tr><tr><td>outOrderNo</td><td>주문번호</td><td>●</td><td>Ο</td><td>32</td><td>알리/위챗 주문번호(고객 영수증에 출력 후 취소 결제 시 사용)</td></tr><tr><td>outUserID</td><td>UserID</td><td>◎</td><td>◎</td><td>32</td><td>알리/위챗 구매 UserID</td></tr><tr><td>outCardGubun</td><td>카드구분</td><td>●</td><td>●</td><td>1</td><td>0 : 신용, 1: 체크, 2:기프트</td></tr><tr><td>outMemberShipBarcode</td><td>멤버쉽바코드번호</td><td>◎</td><td>◎</td><td>20</td><td>멤버쉽바코드번호</td></tr><tr><td>outMerchantMemberShipNo</td><td>가맹점멤버번호</td><td>◎</td><td>◎</td><td>20</td><td>가맹점멤버번호</td></tr><tr><td>outTranGubun</td><td>WCC</td><td>●</td><td>●</td><td>1</td><td>"B" : 바코드 "K" : Keyin "Q" : QR</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>20</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>outAddedPoint</td><td>발생포인트</td><td>●</td><td>◎</td><td>12</td><td>카카오페이 결제 시 : 할인금액</td></tr><tr><td>outUsablePoint</td><td>가용포인트</td><td>●</td><td>◎</td><td>12</td><td>카카오 페이 시 : 승인금액 = 결제요청금액 - 카카오페이할인금액</td></tr><tr><td>outTotalPoint</td><td>누적포인트</td><td>●</td><td>◎</td><td>12</td><td>SSG 결제 시 : 잔액한도</td></tr><tr><td>outPayMethod</td><td>결제 수단</td><td>●</td><td>◎</td><td>5</td><td>카카오페이 결제 시 : MONEY/CARD 토스페이 결제 시 : MONEY/CARD/ACCOT</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>outAddInfo</td><td>부가정보</td><td>◎</td><td>◎</td><td>100</td><td>*SSGPAY SSGPAY 마스킹 실 카드번호 : '실카드: ' +0000---0000 SSG계좌 가상계좌출력번호 : '가상계좌: ' + 123456789012345 *LPAY LPAY에 등록된 결제요청ID (20) : 가맹점에서 LPAY와 대사 필요 시 가맹점 저장</td></tr><tr><td>outBarCodeNumber</td><td>바코드</td><td>◎</td><td>◎</td><td>40</td><td>바코드 번호</td></tr><tr><td>outToken</td><td>OTC</td><td>●</td><td>◎</td><td>V(256)</td><td>Pay 거래 시 OTC 번호</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 = "IP"; axKisPosAgent1.inTradeType= "D1"; axKisPosAgent1.inTranAmt = "1004"; axKisPosAgent1.inAgentIP = "127.0.0.1"; axKisPosAgent1.inAgentPort = 1515; axKisPosAgent1.inSignYN = "Y"; axKisPosAgent1.inSignFileName = "C:\\sign.bmp"; axKisPosAgent1.KIS_ICApproval();

4.1.2.3. 통합 간편 결제

4.1.2.5. 선불 결제

KIS정보통신(주)

개인정보처리방침