결제 승인
본 페이지에서는 결제 승인 요청에 대해 설명합니다. 결제창 연동을 통해 인증 결과를 수신 받았다면 승인 요청을 진행해 주셔야 합니다. 키인 결제는 항상 KEYIN입니다.
결제 승인 파라미터
결제 요청
URL : /payment/v1/keyin Protocol : HTTP/1.1 Method : POST Encoding : UTF-8 Content-Type : application/json
method
(10byte)
결제수단 CARD(신용카드)
mId(10byte)
상점 아이디
orderName(100byte)
상품명
orderId(40byte)
주문 번호 주문한 결제를 식별하는 역할로, 결제를 요청할 때 가맹점에서 만들어서 사용한 값입니다. 중복되지 않는 고유한 값을 발급해야 합니다.
amount(15byte)
거래 금액 숫자만 입력
customerName(30byte)
구매자명 한글/특수기호 입력가능
cpCd(2byte)
카드사 코드 카드사 코드 바로가기
cardNo(16byte)
카드 번호
cardTypeCd(2byte)
카드 타입 코드 01 : 개인 02 : 법인
cardExpirationYear(2byte)
카드 유효연도 예시) yy(24)
cardExpirationMonth(2byte)
카드 유효 월 예시) mm(03)
quotaMon(2byte)
신용 카드의 할부 개월 수 00 : 일시불
ediDate(14byte)
인증처리 일시 형태 : YYYYMMDDHHmmss 예시) 20230914135133
hashString
결제정보 검증 데이터 (mid + ediDate + amount + 가맹점KEY) 인증 데이터 정합성을 위해 가맹점에서 HASH값 비교
trxCd(1byte)
거래코드 에스크로 사용여부 0 : 일반(default) 1 : 에스크로
escwAuthTypeCd(1byte)
에스크로 인증 타입(trxCd 값이 1일 경우 필수) 1 : 휴대폰 번호 2 : 사업자 번호
escwAuthNo(20byte)
에스크로 인증 번호(trxCd 값이 1일 경우 필수)
customerMobilePhone(20byte)
구매자 연락처
customerEmail(60byte)
구매자 이메일 주소
ordIp(20byte)
구매자 아이피 유저 접속 아이피(IPv4, IPv6 지원)
mbsReserved(500byte)
상점 예약 필드에 셋팅한 값
ordAuthNo(10byte)
카드인증번호 생년월일(사업자번호)(계약에 따라 필수 여부 다름)
cardPw(2byte)
카드 비밀번호 앞 2자리(계약에 따라 필수 여부 다름)
noIntUseFlg(1byte)
가맹점 무이자 적용 여부 0 : 일반 1 : 무이자
pointFlg(1byte)
카드로 결제할 때 설정하는 카드사 포인트 사용 여부 0 : 미사용 1 : 사용
goodsSplAmt(15byte)
결제 수수료의 공급가액(부가세 설정이 전송금액 기준이면 필수)
goodsVat(15byte)
결제 수수료 부가세(부가세 설정이 전송금액 기준이면 필수)
goodsSvsAmt(15byte)
상품 봉사료(부가세 설정이 전송금액 기준이면 필수)
connCd(4byte)
접속 타입 Default: userAgent 값을 확인하여 0001/0002 세팅 0001: PC Web 0002: Smartphone
결제 승인
resultCd(4byte)
승인 결과 코드, 실패 코드
: 0000
: 0000을 제외한 나머지
resultMsg(100byte)
결과 메시지
: 정상처리
: 기타 오류 메시지
tid(30byte)
인증 거래번호
mId(10byte)
상점 아이디
method(2byte)
지불수단 (결제방식) 01 : 카드결제
spmCd(2byte)
결제 수단 Sub 코드 01 : 고정
ediDate(14byte)
인증 처리 일시 형태 : YYYYMMDDHHmmss 예시) 20230914135133
orderId(40byte)
주문 번호 주문한 결제를 식별하는 역할로, 결제를 요청할 때 가맹점에서 만들어서 사용한 값입니다. 중복되지 않는 고유한 값을 발급해야 합니다.
orderName(100byte)
결제 상품명
amount(15byte)
결제 결과 금액
customerName(30byte)
결제자 이름
mbsReserved(500byte)
상점 예약 필드에 셋팅한 값
trxCd(1byte)
거래 코드 0 : 일반 1 : 에스크로
trDt(8byte)
결제일 형태 : yyyyMMdd 예시) 20230914
trTm(6byte)
결제 시간 형태 : HHmmss 예시) 164934
fnNm(20byte)
발급 카드사명
cardNo(20byte)
마스킹된 카드번호
appNo(20byte)
승인 번호
appCardCd(2byte)
카드 발급사 코드 카드사 코드 바로가기
acqCardCd(2byte)
카드 매입사 코드 카드사 코드 바로가기
quotaMon(2byte)
카드 할부개월
noIntFlg(1byte)
무이자 여부 0 : 일반 1 : 무이자
pointFlg(1byte)
포인트 사용 여부 0 : 미사용 1 : 사용
cardTypeCd(2byte)
카드 타입 코드 데이터 없으면 공백 리턴 01 : 개인 02 : 법인
chkcardFlg(1byte)
체크 카드 여부 데이터 없으면 공백 리턴 0: 신용 1: 체크
Last updated