KIS정보통신 POSPORTAL

4.1. 윈도우 Agent 4.1.2. 거래 기능 4.1.2.3. 통합 간편 결제

검색 결과가 없습니다.

↑ ↓ Navigate

ESC Close

4.1.2.3. 통합 간편 결제

07.KisPosAgent개발가이드 통합간편결제 토대로 작성 됨. 부가정보[메서드 리스트]<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></tbody></table>[결제 요청]<table><thead><tr><th>프로퍼티명</th><th>설명</th><th>IQ</th><th>AC</th><th>RR</th><th>MaxSize</th><th>세부 설명</th></tr></thead><tbody><tr><td>inTranCode</td><td>전문구분코드</td><td>●</td><td>●</td><td>●</td><td>2</td><td>"EP" : 통합간편결제 코드</td></tr><tr><td>inTradeType</td><td>거래 구분</td><td>●</td><td>●</td><td>●</td><td>2</td><td>"AC" : 통합간편결제 승인 "RR" : 통합간편결제 취소 "IQ" : 페이코 결제 전 조회</td></tr><tr><td>inAgentIP</td><td>KIS-NAGT IP</td><td>●</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>●</td><td>4</td><td>KIS-NAGT 설치 된 PC의 PORT (디폴트 : 1515)</td></tr><tr><td>inAgencyCode</td><td>업체구분코드</td><td>◎</td><td>◎</td><td>◎</td><td>3</td><td>업체구분코드 (디폴트 : 공백)</td></tr><tr><td>inTranAmt</td><td>결제금액</td><td>◎</td><td>●</td><td>●</td><td>12</td><td>결제금액</td></tr><tr><td>inVatAmt</td><td>부가세액</td><td>◎</td><td>◎</td><td>◎</td><td>12</td><td>부가세액</td></tr><tr><td>inSvcAmt</td><td>봉사료</td><td>◎</td><td>◎</td><td>◎</td><td>12</td><td>봉사료</td></tr><tr><td>inFreeAmt</td><td>면세금액</td><td>◎</td><td>◎</td><td>◎</td><td>12</td><td>면세금액</td></tr><tr><td>inOrgAuthDate</td><td>원거래일자</td><td>Ο</td><td>Ο</td><td>●</td><td>8</td><td>취소 시 원 거래 일자 (YYYYMMDD)</td></tr><tr><td>inOrgAuthNo</td><td>원승인번호</td><td>Ο</td><td>Ο</td><td>●</td><td>32</td><td>취소 시 원 거래 승인 번호 (알리/위챗 취소 시 주문 번호)</td></tr><tr><td>inUnitUIMode</td><td>UI표시여부</td><td>Ο</td><td>◎</td><td>◎</td><td>1</td><td>"0" : UI 미표시 "1" : UI 표시</td></tr><tr><td>inCatID</td><td>단말기번호</td><td>◎</td><td>◎</td><td>◎</td><td>8</td><td>단말기 번호</td></tr><tr><td>inTranGubun</td><td>WCC</td><td>Ο</td><td>◎</td><td>◎</td><td>1</td><td>"B" : 바코드 "K" : Keyin "Q" : QR</td></tr><tr><td>inBarCodeNumber</td><td>바코드번호</td><td>Ο</td><td>◎</td><td>◎</td><td>253</td><td>간편결제 바코드 번호</td></tr><tr><td>inSignYN</td><td>전자서명구분</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>●</td><td>120</td><td>서명파일 저장 경로 (절대 경로) ※ 무서명 결제의 경우 inSignFileName : "" 로 필수로 설정</td></tr><tr><td>inInstallment</td><td>할부개월</td><td>Ο</td><td>●</td><td>●</td><td>2</td><td>할부개월 수 (신용 관련 결제 시에만 가능)</td></tr><tr><td>inDepositAmt</td><td>컵보증금</td><td>Ο</td><td>◎</td><td>◎</td><td>7</td><td>컵보증금</td></tr><tr><td>inStructVer</td><td>전문버전</td><td>◎</td><td>◎</td><td>◎</td><td>3</td><td>디폴트 : V01, 간편결제구분 세분화 및 부가정보 추가 : V02</td></tr><tr><td>inAddInfo2</td><td>부가정보2</td><td>◎</td><td>◎</td><td>◎</td><td>200</td><td>전문버전 : V02인 경우 길이(4) + 부가정보(Max 196) * 이디야 기프트카드정보 ((카드번호(16)*10) + 구분자(9) = Max 169) -&gt; "0169" + DATA</td></tr><tr><td>inPaycoYN</td><td>페이코 결제 유무</td><td>◎</td><td>◎</td><td>◎</td><td>1</td><td>페이코 결제 : "Y"</td></tr><tr><td>inPaycoTradeReqNo</td><td>페이코 거래 요청 번호</td><td>◎</td><td>◎</td><td>◎</td><td>16</td><td>페이코 거래 요청 번호</td></tr><tr><td>inPaycoOTCInfo</td><td>페이코 OTC 정보</td><td>◎</td><td>◎</td><td>◎</td><td>40</td><td>페이코 OTC 정보</td></tr><tr><td>inPaycoPointAmt</td><td>페이코 포인트 금액</td><td>◎</td><td>◎</td><td>◎</td><td>12</td><td>페이코 포인트 금액</td></tr><tr><td>inPaycoCardAmt</td><td>페이코 카드 금액</td><td>◎</td><td>◎</td><td>◎</td><td>12</td><td>페이코 카드 금액</td></tr><tr><td>inPaycoCouponAmt</td><td>페이코 쿠폰 금액</td><td>◎</td><td>◎</td><td>◎</td><td>12</td><td>페이코 쿠폰 금액</td></tr></tbody></table>[결제 응답]<table><thead><tr><th>프로퍼티명</th><th>설명</th><th>IQ</th><th>AC</th><th>RR</th><th>MaxSize</th><th>세부 설명</th></tr></thead><tbody><tr><td>outRtn</td><td>리턴값</td><td>●</td><td>●</td><td>●</td><td>1</td><td>Agent와 통신 결과 값 리턴 값 0 정상, 그 외 비정상</td></tr><tr><td>outReplyCode</td><td>응답코드</td><td>●</td><td>●</td><td>●</td><td>4</td><td>서버 응답코드 "0000" : 정상, 그 외 비정상 ★ 페이코 조회 시 "00RE" 일 경우가 성공</td></tr><tr><td>outPayType</td><td>간편결제 구분</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 "PYC" : 페이코</td></tr><tr><td>outCardNo</td><td>카드번호</td><td>◎</td><td>●</td><td>●</td><td>V(256)</td><td>결제 된 카드번호 (바코드 or QR or 카카오페이승인 결제 시 마스킹된 카드 번호)</td></tr><tr><td>outAuthNo</td><td>승인번호</td><td>◎</td><td>●</td><td>●</td><td>32</td><td>승인번호</td></tr><tr><td>ouReplyDate</td><td>거래일자</td><td>◎</td><td>●</td><td>●</td><td>14</td><td>거래일자(YYYYMMDDhhmmss)</td></tr><tr><td>outIssuerCode</td><td>발급사코드</td><td>◎</td><td>●</td><td>●</td><td>4</td><td>발급사코드</td></tr><tr><td>outIssuerName</td><td>발급사명</td><td>◎</td><td>●</td><td>●</td><td>16</td><td>발급사명</td></tr><tr><td>outAccepterCode</td><td>매입사코드</td><td>◎</td><td>●</td><td>●</td><td>4</td><td>매입사코드</td></tr><tr><td>outAccepterName</td><td>매입사명</td><td>◎</td><td>●</td><td>●</td><td>16</td><td>매입사명</td></tr><tr><td>outMerchantRegNo</td><td>가맹점번호</td><td>◎</td><td>●</td><td>●</td><td>20</td><td>가맹점번호</td></tr><tr><td>outReplyMsg1</td><td>메시지1</td><td>●</td><td>●</td><td>●</td><td>40</td><td>KIS 서버 응답메시지 1</td></tr><tr><td>outTradeNum</td><td>거래일련번호</td><td>◎</td><td>●</td><td>◎</td><td>20</td><td>거래일련번호</td></tr><tr><td>outOrderNo</td><td>주문번호</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>◎</td><td>32</td><td>알리/위챗 구매 UserID</td></tr><tr><td>outTranGubun</td><td>WCC</td><td>◎</td><td>●</td><td>●</td><td>1</td><td>"B" : 바코드 "K" : Keyin "Q" : QR</td></tr><tr><td>outPayMethod</td><td>결제수단</td><td>Ο</td><td>●</td><td>◎</td><td>5</td><td>카카오페이 결제시 : MONEY/CARD 토스페이 결제시 : MONEY/CARD/ACOOT 페이코 결제시 : MONEY/CARD/CPON (포인트/신용/쿠폰) (주결제수단)</td></tr><tr><td>outAddedPoint</td><td>발생포인트</td><td>Ο</td><td>●</td><td>◎</td><td>12</td><td>카카오페이 결제시 : 할인금액 페이코 결제시 : 쿠폰금액</td></tr><tr><td>outUsablePoint</td><td>가용포인트</td><td>Ο</td><td>●</td><td>◎</td><td>12</td><td>카카오페이 시 : 승인금액 = 결제요청금액 - 카카오페이할인금액 페이코 결제 시 : 주결제수단 금액(신용 or 포인트 금액)</td></tr><tr><td>outTotalPoint</td><td>누적포인트</td><td>Ο</td><td>●</td><td>◎</td><td>12</td><td>SSG 결제 시 잔액한도 페이코 결제 시 : 포인트 잔액</td></tr><tr><td>outToken</td><td>OTC</td><td>◎</td><td>●</td><td>◎</td><td>V(256)</td><td>Pay거래시 OTC 번호 페이코 거래 시 : OTC 번호</td></tr><tr><td>outAddInfo</td><td>부가정보</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>outCardGubun</td><td>카드구분</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>◎</td><td>1</td><td>S:DESC, C:EDC, D:DDC</td></tr><tr><td>outPaycoTradeReqNo</td><td>페이코거래요청번호</td><td>◎</td><td>◎</td><td>◎</td><td>16</td><td>페이코거래요청번호</td></tr><tr><td>outPaycoCouponAuthNo</td><td>페이코쿠폰승인번호</td><td>◎</td><td>◎</td><td>◎</td><td>20</td><td>페이코쿠폰승인번호</td></tr><tr><td>outPaycoPointAuthNo</td><td>페이코포인트승인번호</td><td>◎</td><td>◎</td><td>◎</td><td>20</td><td>페이코포인트승인번호</td></tr></tbody></table>[샘플코드 - 통합간편결제승인]axKisPosAgent1.inTranCode = "EP"; axKisPosAgent1.inTradeType= "AC"; 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.2. 현금영수증

4.1.2.4. 통합 결제

KIS정보통신(주)

개인정보처리방침