통합 간편 결제
07.KisPosAgent개발가이드 통합간편결제 토대로 작성 됨.
부가정보[메서드 리스트]
초기화
Init
모든 프로퍼티 초기화
void
[0] 성공 그 외 비정상
KIS-NAGT 결제요청
KIS_ICApproval
결제요청함수
void
[0] 결제 응답전문 수신 [-23] KIS-NAGT 접속 실패
결제종료 이벤트
OnApprovalEnd
결제완료이벤트 함수
void
[결제 요청]
inTranCode
전문구분코드
●
●
●
2
"EP" : 통합간편결제 코드
inTradeType
거래 구분
●
●
●
2
"AC" : 통합간편결제 승인 "RR" : 통합간편결제 취소 "IQ" : 페이코 결제 전 조회
inAgentIP
KIS-NAGT IP
●
●
●
10
KIS-NAGT 설치 된 PC의 IP (로컬 : "127.0.0.1")
inAgentPort
KIS-NAGT PORT
●
●
●
4
KIS-NAGT 설치 된 PC의 PORT (디폴트 : 1515)
inAgencyCode
업체구분코드
◎
◎
◎
3
업체구분코드 (디폴트 : 공백)
inTranAmt
결제금액
◎
●
●
12
결제금액
inVatAmt
부가세액
◎
◎
◎
12
부가세액
inSvcAmt
봉사료
◎
◎
◎
12
봉사료
inFreeAmt
면세금액
◎
◎
◎
12
면세금액
inOrgAuthDate
원거래일자
Ο
Ο
●
8
취소 시 원 거래 일자 (YYYYMMDD)
inOrgAuthNo
원승인번호
Ο
Ο
●
32
취소 시 원 거래 승인 번호 (알리/위챗 취소 시 주문 번호)
inUnitUIMode
UI표시여부
Ο
◎
◎
1
"0" : UI 미표시 "1" : UI 표시
inCatID
단말기번호
◎
◎
◎
8
단말기 번호
inTranGubun
WCC
Ο
◎
◎
1
"B" : 바코드 "K" : Keyin "Q" : QR
inBarCodeNumber
바코드번호
Ο
◎
◎
253
간편결제 바코드 번호
inSignYN
전자서명구분
Ο
●
●
1
"Y" : 전자서명을 Agent 통하여 입력받음 "N" : 전자서명을 Agent 통하지 않고 직접 서명데이터 넘겨줄 때 이용 "" : 무서명결제 (서명없음) ※ 5만원 이상 결제와 무관하게 보내야 함
inSignFileName
서명파일명
Ο
●
●
120
서명파일 저장 경로 (절대 경로) ※ 무서명 결제의 경우 inSignFileName : "" 로 필수로 설정
inInstallment
할부개월
Ο
●
●
2
할부개월 수 (신용 관련 결제 시에만 가능)
inDepositAmt
컵보증금
Ο
◎
◎
7
컵보증금
inStructVer
전문버전
◎
◎
◎
3
디폴트 : V01, 간편결제구분 세분화 및 부가정보 추가 : V02
inAddInfo2
부가정보2
◎
◎
◎
200
전문버전 : V02인 경우 길이(4) + 부가정보(Max 196) * 이디야 기프트카드정보 ((카드번호(16)*10) + 구분자(9) = Max 169) -> "0169" + DATA
inPaycoYN
페이코 결제 유무
◎
◎
◎
1
페이코 결제 : "Y"
inPaycoTradeReqNo
페이코 거래 요청 번호
◎
◎
◎
16
페이코 거래 요청 번호
inPaycoOTCInfo
페이코 OTC 정보
◎
◎
◎
40
페이코 OTC 정보
inPaycoPointAmt
페이코 포인트 금액
◎
◎
◎
12
페이코 포인트 금액
inPaycoCardAmt
페이코 카드 금액
◎
◎
◎
12
페이코 카드 금액
inPaycoCouponAmt
페이코 쿠폰 금액
◎
◎
◎
12
페이코 쿠폰 금액
[결제 응답]
outRtn
리턴값
●
●
●
1
Agent와 통신 결과 값 리턴 값 0 정상, 그 외 비정상
outReplyCode
응답코드
●
●
●
4
서버 응답코드 "0000" : 정상, 그 외 비정상 ★ 페이코 조회 시 "00RE" 일 경우가 성공
outPayType
간편결제 구분
◎
●
●
3
간편결제 구분 "KKO" : 카카오페이 "SGP" : SSGPAY "ZRP" : 제로페이 "ALP" : 알리페이 "WEP" : 위챗페이 "LPY" : Lpay "APP" : 앱카드 "EMQ" : EMVQR(네이버페이, BC페이북 등) -> inStructVer : V01인 경우 "EMQ" :BC페이북 -> inStructVer : V02인 경우 "NVP" : 네이버페이-> inStructVer : V02인 경우 "HNQ" : 하나원Q페이 -> inStructVer : V02인 경우 "SPY" : 서울페이 "TSP" : 토스페이 "SSP" : 삼성페이 "BGQ" : BC GLOBAL QR "PYC" : 페이코
outCardNo
카드번호
◎
●
●
V(256)
결제 된 카드번호 (바코드 or QR or 카카오페이승인 결제 시 마스킹된 카드 번호)
outAuthNo
승인번호
◎
●
●
13
승인번호
ouReplyDate
거래일자
◎
●
●
14
거래일자(YYYYMMDDhhmmss)
outIssuerCode
발급사코드
◎
●
●
4
발급사코드
outIssuerName
발급사명
◎
●
●
16
발급사명
outAccepterCode
매입사코드
◎
●
●
4
매입사코드
outAccepterName
매입사명
◎
●
●
16
매입사명
outMerchantRegNo
가맹점번호
◎
●
●
20
가맹점번호
outReplyMsg1
메시지1
●
●
●
40
KIS 서버 응답메시지 1
outTradeNum
거래일련번호
◎
●
◎
20
거래일련번호
outOrderNo
주문번호
Ο
●
Ο
32
알리/위챗 주문번호(고객 영수증에 출력 후 취소 결제 시 사용)
outUserID
UserID
Ο
◎
◎
32
알리/위챗 구매 UserID
outTranGubun
WCC
◎
●
●
1
"B" : 바코드 "K" : Keyin "Q" : QR
outPayMethod
결제수단
Ο
●
◎
5
카카오페이 결제시 : MONEY/CARD 토스페이 결제시 : MONEY/CARD/ACOOT 페이코 결제시 : MONEY/CARD/CPON (포인트/신용/쿠폰) (주결제수단)
outAddedPoint
발생포인트
Ο
●
◎
12
카카오페이 결제시 : 할인금액 페이코 결제시 : 쿠폰금액
outUsablePoint
가용포인트
Ο
●
◎
12
카카오페이 시 : 승인금액 = 결제요청금액 - 카카오페이할인금액 페이코 결제 시 : 주결제수단 금액(신용 or 포인트 금액)
outTotalPoint
누적포인트
Ο
●
◎
12
SSG 결제 시 잔액한도 페이코 결제 시 : 포인트 잔액
outToken
OTC
◎
●
◎
V(256)
Pay거래시 OTC 번호 페이코 거래 시 : OTC 번호
outAddInfo
부가정보
◎
◎
◎
100
*SSGPAY SSGPAY 마스킹 실 카드번호 : '실카드: ' +0000---0000 SSG계좌 가상계좌출력번호 : '가상계좌: ' + 123456789012345 *LPAY LPAY에 등록된 결제요청ID (20) : 가맹점에서 LPAY와 대사 필요 시 가맹점 저장
outCardGubun
카드구분
◎
◎
◎
1
0:신용, 1:체크, 2:기프트
outPurchaseGubun
매입구분
◎
◎
◎
1
S:DESC, C:EDC, D:DDC
outPaycoTradeReqNo
페이코거래요청번호
◎
◎
◎
16
페이코거래요청번호
outPaycoCouponAuthNo
페이코쿠폰승인번호
◎
◎
◎
20
페이코쿠폰승인번호
outPaycoPointAuthNo
페이코포인트승인번호
◎
◎
◎
20
페이코포인트승인번호
[샘플코드 - 통합간편결제승인] 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();
Last updated