결제창 호출
본 페이지에서는 장바구니 결제창 호출에 대해 설명합니다.
결제 요청 파라미터
결제 요청
URL : /payment/v1/view/request Protocol : HTTP/1.1 Method : POST Encoding : UTF-8 Content-Type : application/json
method
(10byte)
결제수단 ALL(모두), CARD(신용카드), BANK(계좌이체), VACNT(가상계좌)중 하나 선택
mId(10byte)
상점 아이디
orderName(100byte)
상품명
orderId(40byte)
주문 번호 주문한 결제를 식별하는 역할로, 결제를 요청할 때 가맹점에서 만들어서 사용한 값입니다. 중복되지 않는 고유한 값을 발급해야 합니다.
amount(15byte)
거래 금액
customerName(30byte)
구매자명
returnUrl
결제(인증) 결과 전달하는 페이지
ediDate(14byte)
인증 처리 일시 형태 : YYYYMMDDHHmmss 예시) 20230914135133
hashString
결제정보 검증 데이터 (mId + ediDate + amount + 가맹점KEY) 인증 데이터 정합성을 위해 가맹점에서 HASH값 비교
trxCd(1byte)
거래코드 에스크로 사용여부 0 : 일반(default) 1 : 에스크로
customerMobilePhone(20byte)
구매자 연락처
customerEmail(60byte)
구매자 이메일 주소
ordIp(20byte)
구매자 아이피 유저 접속 아이피(IPv4, IPv6 지원)
mbsReserved(500byte)
상점 예약 필드에 셋팅한 값
goodsSplAmt(15byte)
결제 수수료의 공급가액(부가세 설정이 전송금액 기준이면 필수)
goodsVat(15byte)
결제 수수료 부가세(부가세 설정이 전송금액 기준이면 필수)
goodsSvsAmt(15byte)
상품 봉사료(부가세 설정이 전송금액 기준이면 필수)
connCd(4byte)
접속 타입 Default: userAgent 값을 확인하여 0001/0002 세팅 0001: PC Web 0002: Smartphone
period(21byte)
제공 기간 Default: 별도 제공기간 없음
noIntUseFlg(1byte)
가맹점 무이자 적용 여부 0 : 일반 1 : 무이자
pointFlg(1byte)
카드로 결제할 때 설정하는 카드사 포인트 사용 여부 0 : 미사용 1 : 사용
flowMode(1byte)
직접호출 0: 미사용(default) 1: 사용 default는 카드, 간편결제수단이 있는 기본 결제창을 호출. 사용은 앱카드 또는 간편결제사 결제창을 직접 호출. 앱카드를 호출하려면 cardCompany를 설정, 간편결제사 결제창을 호출하려면 easyPay를 설정
cardCompany(2byte)
카드사 코드 method: 'CARD', flowMode: '1' 이면 설정한 카드사의 결제창 호출 카드사 코드 바로가기
easyPay(2byte)
간편결제사 코드 method: 'CARD', flowMode: '1', cardCompay: '00' 이면 설정한 간편결제사의 결제창 호출 간편결제사 코드 바로가기
cardInstallmentPlan(2byte)
신용 카드의 할부 개월 수 값을 넣으면 해당 할부 개월 수로 결제 진행, 값을 넣지 않으면 고객이 결제창에서 할부 개월 수를 선택 가능 00 : 일시불, 02 : 2개월, 03 : 3개월, 04 : 4개월
useCardPoint(1byte)
카드로 결제할 때 설정하는 카드사 포인트 사용 여부 0 : 미사용, 1 : 사용
crctReqType(2byte)
현금 영수증 용도 타입 0 : 미발행(default) 1 : 소득공제 2 : 지출증빙
crctPubType(20byte)
현금 영수증 발급 타입 crctReqType 값이 1 또는 2일 경우 필수 1 : 카드번호 3 : 사엽자등록번호 4 : 휴대폰 번호
crctId(20byte)
현금 영수증 발급 번호 crctReqType 값이 1 또는 2일 경우 필수 현금 영수증 발급 번호(숫자만 허용)
escwAuthTypeCd(1byte)
에스크로 인증 타입 trxCd 값이 1일 경우 필수 1 : 휴대폰 번호 2 : 사업자 번호
escwAuthNo(20byte)
에스크로 인증 번호 trxCd 값이 1일 경우 필수 에스크로 인증 번호
crctId(20byte)
현금 영수증 발급 번호 crctReqType 값이 1 또는 2일 경우 필수 현금 영수증 발급 번호(숫자만 허용)
cartData(4000byte)
장바구니 데이터 JsonString (장바구니 사용 시 필수)
결제 요청(장바구니)
id(10byte)
상점 아이디
cartOrdNo(100byte)
주문번호 cartData 내에서 unique한 값
cartGoodsAmt(15byte)
상품금액(숫자만 입력)
cartGoodsNm(30byte)
상품명
결제 요청 응답
resultCd(4byte)
인증에 대한 성공, 실패 코드
: 0000
: 0000을 제외한 나머지
resultMsg(100byte)
결과 메시지
: 정상처리
: 기타 오류 메시지
nonce(30byte)
전문 번호
tid(30byte)
인증 거래번호
mId(10byte)
상점 아이디
method(2byte)
지불수단 (결제방식) 01 : 카드결제 02 : 실시간 계좌이체 03 : 가상계좌 (무통장 입금)
orderId(40byte)
주문 번호 주문한 결제를 식별하는 역할로, 결제를 요청할 때 가맹점에서 만들어서 사용한 값입니다. 중복되지 않는 고유한 값을 발급해야 합니다.
amount(15byte)
결제 금액
mbsReserved(500byte)
상점 예약 필드에 셋팅한 값
ediDate(14byte)
인증 처리 일시 형태 : YYYYMMDDHHmmss 예시) 20230914135133
payData
결제 정보 암호화 데이터
signData
검증 데이터 (tid+mId+ediDate+amount+orderId+가맹점KEY) 인증 데이터 정합성을 위해 가맹점에서 HASH값 비교
approvalUrl
승인 요청 URL
netCancleUrl
망취소 요청 URL * 승인 요청 후 승인결과를 전달받지 못한 경우 해당 URL 을 통해 망취소 요청
Last updated