❤️신용 결제
03.KisPosAgent개발가이드 Event 버전을 토대로 작성 됨.
[메서드 리스트]
초기화
Init
모든 프로퍼티 초기화
void
[0] 성공 그 외 비정상
KIS-NAGT 결제요청
KIS_ICApproval
결제요청함수
void
[0] 결제 응답전문 수신 [-23] KIS-NAGT 접속 실패
결제종료 이벤트
OnApprovalEnd
결제완료이벤트 함수
void
상태 이벤트
OnApprovalChanged
결제 중 현재 상태를 알려주는 이벤트 함수
void
[결제 요청]
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
원거래승인번호 (취소거래 시에만 입력)
inOilInfo
유종정보
◎
◎
14
아래 유종정보 표 확인
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
컵보증금
유종정보 (inOilInfo)
면세유 공급 구분
AN
1
면세유(농협) : [1]농기계 [2]선박 [3]양식 기타(신한, 국민, 우리비씨) : [T] 신한택시면세유 외
유종코드
AN
1
면세유: [1]휘발유 [2]실내등유 [3]등유 [4]경유 [7]부탄 [8]고급유 기타 : [1]휘발유 [2]실내등유 [3]보일러등유 [4]경유 [5]윤활유 [6]중유 [7]가스
유량
N
6
Leading zero. 신한면세유(XXXX.XX) : 소수점 이하 2자리 표기 (소수점은 포함 하지 않음)
외상결제일
N
6
면세유 : YYMMDD / 신한면세유-단가(6) Leading zero
[결제 응답]
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자리 카드빈 데이터
[샘플코드 - 신용승인] axKisPosAgent1.inTranCode = "NV";
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();
Last updated