선불 결제
03.KisPosAgent개발가이드 Event 버전을 토대로 작성 됨.
아직 배포되지 않은 버전으로 곧 만나볼 수 있어요!
[메서드 리스트]
초기화
Init
모든 프로퍼티 초기화
void
[0] 성공 그 외 비정상
KIS-NAGT 결제요청
KIS_ICApproval
결제요청함수
void
[0] 결제 응답전문 수신 [-23] KIS-NAGT 접속 실패
결제종료 이벤트
OnApprovalEnd
결제완료이벤트 함수
void
상태 이벤트
OnApprovalChanged
결제 중 현재 상태를 알려주는 이벤트 함수
void
요청 취소 함수
KIS_Agent_Stop
결제요청 후 중지하고 싶을 때 호출하는 함수
short
[0] 성공 그 외 비정상
[결제 요청]
inTranCode
전문구분코드
●
●
2
"NV" : Event 버전 필수코드
inTradeType
거래 구분
●
●
2
"D1" : 신용승인 "D2" : 신용취소
inAgentIP
KIS-NAGT IP
●
●
10
KIS-NAGT 설치 된 PC의 IP (로컬 : "127.0.0.1")
inAgentPort
KIS-NAGT PORT
●
●
4
KIS-NAGT 설치 된 PC의 PORT (디폴트 : 1515)
inAddressNo1
요청 목적지 주소정보1
◎
◎
15
서버 IP (디폴트 : Agent 설정 값)
테스트:210.112.100.97 운영:210.112.100.63
inAddressNo2
요청 목적지 주소정보2
◎
◎
6
서버 PORT(디폴트:Agent 설정 값) 일반:60201 병원:60202
inCatId
단말기번호
◎
◎
10
가맹점단말기번호 (디폴트:Agent 설정 메뉴 값)
inSignYN
전자서명구분
●
●
1
"Y" : 전자서명을 Agent 통하여 입력받음 "N" : 전자서명을 Agent 통하지 않고 직접 서명데이터 넘겨줄 때 이용 "" : 무서명결제 (서명없음) ※ 5만원 이상 결제와 무관하게 보내야 함
inSignFileName
서명파일명
●
●
120
서명파일 저장 경로 (절대 경로) ※ 무서명 결제의 경우 inSignFileName : "" 로 필수로 설정
inTranGubun
거래수단구분
◎
◎
1
"K" : KEY-IN, "s" : 삼성페이 OTC, "B" : 바코드
inBarCodeNumber
바코드번호
◎
◎
40
AppCard 번호 또는 삼성페이 OTC
inInstallment
할부개월
◎
◎
2
할부개월
inTranAmt
결제금액
●
●
8
결제금액
inVatAmt
부가세액
◎
◎
8
부가세액
inSvcAmt
봉사료
◎
◎
8
봉사료
inOrgAuthDate
원거래일자
○
●
6
원거래승인일자 YYMMDD (취소거래 시에만 입력)
inOrgAuthNo
원승인번호
○
●
12
원거래승인번호 (취소거래 시에만 입력)
inVanKeyYN
VanKey 사용여부
◎
◎
1
VanKey 사용 여부 (병원 가맹점의 경우 "Y" 필수 설정) Y : 사용 N : 미사용
inVanKey
승인 시 받은 VanKey
◎
◎
16
inVanKeyYN 을 "Y"로 셋팅하여 신용승인한 건의 취소일 때 outVanKey로 전달받은 값
inHospitalYN
병원정보 사용여부
◎
◎
1
병원정보 입력 사용 여부 "Y" 인 경우 inVanKeyYN 도 "Y"로 설정 필수
inHospitalInfo
병원정보
◎
◎
Var
병원정보 데이터
inUnitMode
UI 출력모드
◎
◎
1
"0" : 미출력 "1" : 출력
inUnitLockYN
동기/비동기 선택
◎
◎
1
"N" : 비동기 "Y" : 동기
inDepositAmt
컵보증금
◎
◎
7
컵보증금
inBillionYN
선불카드 여부
◎
◎
1
사용 : "Y" 미사용 : "N"
inTranAmtNEWPOS
선불카드 총금액
◎
◎
12
EX)000000010000
inVatAmtNEWPOS
선불카드 부가세
◎
◎
12
EX)000000010000
inSvcAmtNEWPOS
선불카드 봉사료
◎
◎
12
EX)000000010000
inTradeSubType
서브 거래 구분
◎
◎
2
거래 서브 구분 코드 "C1" : KIS 선불 사용 "C2" : KIS 선불 사용 취소 "C3" : KIS 선불 판매 "C4" : KIS 선불 판매 취소 "C5" : KIS 선불 충전 "C6" : KIS 선불 충전 취소 "C7" : KIS 선불 조회 (금액 : 1원)
[결제 응답]
outRtn
리턴값
●
●
1
Agent와 통신 결과 값
outCatId
단말기번호
●
●
10
가맹점 단말기 번호
outAgentCode
Agent 응답코드
●
●
4
Agent 응답코드 "0000" : 정상, 외에는 비정상
outReplyCode
응답코드
●
●
4
서버 응답코드 "0000" : 정상, 외에는 비정상
outTranAmt
결제금액
●
●
8
결제금액
outAuthNo
승인번호
●
●
13
승인번호
ouReplyDate
거래일자
●
●
8
거래일자(YYYYMMDD)
outAccepterCode
매입사코드
●
●
2
매입사코드
outAccepterName
매입사명
●
●
20
매입사명
outIssuerCode
발급사코드
●
●
2
발급사코드
outIssuerName
발급사명
●
●
2
발급사명
outMerchantRegNo
가맹점번호
●
●
20
가맹점번호
outCardNo
카드빈
◎
◎
6
카드빈 6자리
outCardGubun
카드구분
●
●
1
0 : 신용, 1: 체크, 2:기프트
outPurchaseGubun
매입구분
●
●
1
S : DESC, C : EDC, D : DDC
outReplyMsg1
메시지1
●
●
40
메시지 1
outReplyMsg2
메시지2
●
●
80
메시지 2
outTradeNum
거래일련번호
◎
◎
8
거래일련번호
outTradeReqDate
거래요청날짜
◎
◎
8
거래요청날짜 (YYYYMMDD)
outTradeReqTime
거래요청시간
◎
◎
6
거래요청시간 (hhmmss)
outWCC
거래타입
◎
◎
1
S : MSR, 삼성페이 s : 서명패드를 통한 MST 삼성페이 승인 C : IC 결제 P : 암호화 키인 K : 키인 (현금영수증 등)
outVanKey
VanKey
◎
◎
16
inVanKeyYN 이 "Y"로 신용승인 시 발생하는 Van고유번호
outBarCodeNumber
바코드
◎
◎
40
바코드 번호
outCouponInformation
EMV 9F60 Tag
◎
◎
36
EMV 9F60 Tag BCQR 결제 시4E50으로 시작 시 네이버페이로 판단
outArrivedData
상태체크
◎
◎
2
OnApprovalChanged 함수 호출 시 사용 "IC" : IC 카드 리딩 중 "FB" : FB 카드 리딩 중 "IS" : IC + 서명패드 통한 MST 삼성페이 진행 중 "TN" : IC + 서명패드 고객정보입력 "KI" : 키인 승인 중 "UQ" : BCQR 리딩 중 "PN" : 핀 입력 중 "SN" : 서명 입력 중 "NV" : 신용 승인 중
outEightCardNo
8자리 카드빈
◎
◎
8
8자리 카드빈처리 가능 리더기인 경우 8자리 카드빈 데이터
outPurchaseBal
KIS선불카드 잔액
◎
◎
12
outPurchaseRefundAmt
KIS선불 환불가능 금액
◎
◎
12
outPurchaseLimitAmt
KIS선불 신용카드 충전한도 금액
◎
◎
12
outPrepaidCardName
KIS선불카드 명칭
◎
◎
50
IS선불카드 명칭
outPrepaidCardStatus
KIS선불카드 상태
◎
◎
2
KIS선불카드 상태
(00: 정상, 01: 일시정지, 99 : 해지)
outCustmerID
고객사 회원아이디
◎
◎
20
고객사 회원 아이디
outPrepaidCardType
KIS선불카드 구분
◎
◎
2
KIS선불카드 구분 (01:충전형, 02:금액형, 03: 교환형)
[샘플코드 - 선불카드조회] 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();
Last updated