🕊️POSKIS API

AGENT 와 CAT(카드결제기)와 통신하는 API 가이드입니다

KisPosAgent개발가이드(POS-KIS) 문서 참고.

가. 함수 목록

함수명	설명	비고
Init	초기화	0 : 정상 그외 비정상
KIS_ICApproval	결제요청	0 : 결제 응답전문 수신 -23: KIS-AGENT 접속 실패 그외 비정상

Agent연동 요청 ● : 필수 ◎ : 선택 ○: 없음

항목	프로퍼티명	D1	D2	CC	CR	세부 설명
inTranCode	전문코드	●	●	●	●	UC : POS-KIS(CAT)
inTradeType	거래 구분	●	●	●	●	D1,D2,CC,CR 등
inCatId	단말기번호	◎	◎	◎	◎	단말기번호
inTranGubun	전문구분	◎	◎	◎	◎	현금 영수증 WCC
inBarCodeNumber	바코드번호	◎	◎	◎	◎	폰번호,바코드번호등등
inInstallment	할부개월	◎	◎	◎	◎	할부개월
inTranAmt	결제금액	◎	◎	◎	◎	결제금액
inVatAmt	부가세액	◎	◎	◎	◎	부가세액
inSvcAmt	봉사료	◎	◎	◎	◎	봉사료
inOrgAuthDate	원거래일자	○	●	○	●	취소 시 원거래일자 (YYMMDD)
inOrgAuthNo	원승인번호	○	●	○	●	취소 시 원거래 승인번호
inCatTranGubun	cat트랜구분	◎	◎	◎	◎	현금영수증 취소 사유. [1]거래취소, [2]오류취소, [3]기타
inTranNo	거래일련번호	◎	◎	◎	◎	단말기 번호가 상이한 경우만 설정됨
inBlockPin	간편결제 구분코드	◎	◎	◎	◎	통합간편결제 (표1.6.4 통합간편결제 )
inBusinessNo	사업자번호	◎	◎	◎	◎
inOwnerNm	대표자명	◎	◎	◎	◎
inMerchantNm	가맹점명	◎	◎	◎	◎
inMerchantAddress	가맹점주소	◎	◎	◎	◎	가맹점 주소
inMerchantTel	가맹점전화번호	◎	◎	◎	◎
inPrintYN	매출전표출력여부	◎	◎	◎	◎	[Y]:전표출력, [N]:전표출력하지 않음

🤚자세한 사항은 참고, POS-KIS 개발가이드 및 Check Pos 스펙 문서

Agent연동 응답 ● : 필수 ◎ : 선택 ○: 없음

항목	프로퍼티명	D1	D2	CC	CR	세부 설명
outTranCode	전문구분코드	●	●	●	●	"UC" : POS-KIS(CAT)
outAgentCode	Agent응답코드	●	●	●	●	"0000" 정상 그외 비정상
outCatId	단말기번호	●	●	●	●	단말기번호
outWCC	WCC	●	●	●	●	C:IC, @:현금
outCardNo	카드번호	◎	◎	◎	◎	카드BIN,마스킹번호
outInstallment	할부개월	●	●	◎	◎	할부개월
outTranAmt	합계금액	●	●	●	●
outVatAmt	부가세	◎	◎	◎	◎
outSvcAmt	봉사료	◎	◎	◎	◎
outAuthNo	승인번호	◎	◎	◎	◎	신용(8), 현금IC(13) 거절 시 공란
outTradeReqTime	거래일자	◎	◎	◎	◎	yymmddhhmmss
outOrgAuthDate	원거래일자	◎	◎	◎	◎	취소시, YYMMDD
outOrgAuthNo	원거래승인번호	●	●	●	●	취소시 신용(8),현금IC(13)
outAccepterCode	매입사코드	◎	◎	○	○
outAccepterName	매입카드사명	◎	◎	○	○	거절 시 거절메세지 설정
outIssuerCode	발급사코드	◎	◎	○	○
outIssuerName	발급카드사명	◎	◎	○	○	현금IC-발급기관명
outMerchantRegNo	가맹점번호	◎	◎	○	○	신용카드 / 현금IC
outTradeNum	거래일련번호	◎	◎	○	○	전자서명 거래일 경우 SN 구분자 추가 (예: 0001SN)
outReplyCode	응답코드	●	●	●	●	정상: 0000
outReplyMsg1	알림1	●	●	●	●	알림1
outReplyMsg2	알림2	◎	◎	◎	◎	알림2
outReplyMsg3	알림3	◎	◎	◎	◎	알림3
outReplyMsg4	알림4	◎	◎	◎	◎	알림4

🤚 자세한 사항은 참고, POS-KIS 개발가이드 및 Check Pos 스펙 문서