결제 승인
본 페이지에서는 결제 승인 요청에 대해 설명합니다. 가상계좌 결제는 웹 페이지에서 카드정보를 입력해 결제를 진행합니다.
결제요청 파라미터
결제 요청
URL : /payment/v1/vacnt Protocol : HTTP/1.1 Method : POST Encoding : UTF-8 Content-Type : application/json
method
(10byte)
결제수단 ALL(모두), CARD(신용카드), BANK(계좌이체), VACNT(가상계좌)중 하나 선택
mId(10byte)
상점 아이디
amount(15byte)
거래 금액
orderId(40byte)
주문 번호 주문한 결제를 식별하는 역할로, 결제를 요청할 때 가맹점에서 만들어서 사용한 값입니다. 중복되지 않는 고유한 값을 발급해야 합니다.
orderName(100byte)
상품명
customerName(30byte)
구매자명
cpCd(4byte)
은행 코드 은행 코드 바로가기
ediDate(14byte)
인증처리 일시 형태 : YYYYMMDDHHmmss 예시) 20230914135133
hashString
결제정보 검증 데이터 (mid + ediDate + amount + 가맹점KEY) 인증 데이터 정합성을 위해 가맹점에서 HASH값 비교
trxCd(1byte)
거래코드 에스크로 사용여부 0 : 일반(default) 1 : 에스크로
customerMobilePhone(20byte)
구매자 연락처
customerEmail(60byte)
구매자 이메일 주소
ordIp(20byte)
구매자 아이피 유저 접속 아이피(IPv4, IPv6 지원)
lmtDay(8byte)
입금 기한
mbsReserved(500byte)
상점 예약 필드에 셋팅한 값
crctReqType(1byte)
현금영수증 요청타입 0 : 미발행 1 : 소득공제 2 : 지출증빙
crctPubType(2byte)
현금 영수증 발급 타입 crctReqType 값이 1 또는 2일 경우 필수 1: 카드번호 3: 사엽자등록번호 4: 휴대폰 번호
crctId(20byte)
현금 영수증 발급 번호 crctReqType 값이 1 또는 2일 경우 필수, 현금 영수증 발급 번호(숫자만 허용)
goodsSplAmt(15byte)
공급가(부가세 설정이 전송금액 기준이면 필수)
goodsVat(15byte)
부가세(부가세 설정이 전송금액 기준이면 필수)
goodsSvsAmt(15byte)
상품 봉사료(부가세 설정이 전송금액 기준이면 필수)
connCd(4byte)
접속 타입 Default: userAgent 값을 확인하여 0001/0002 세팅 0001: PC Web 0002: Smartphone
escwAuthTypeCd(1byte)
에스크로 인증 타입 trxCd 값이 1일 경우 필수 1 : 휴대폰 번호 2 : 사업자 번호
escwAuthNo(20byte)
에스크로 인증 번호 trxCd 값이 1일 경우 필수 에스크로 인증 번호
가상계좌 채번 결과 응답
resultCd(4byte)
인증에 대한 성공, 실패 코드
: 0000
: 0000을 제외한 나머지
resultMsg(100byte)
결과 메시지
: 정상처리
: 기타 오류 메시지
tid(30byte)
인증 거래번호
mId(10byte)
상점 아이디
method(2byte)
지불수단 (결제방식) 01 : 카드결제 02 : 실시간 계좌이체 03 : 가상계좌 (무통장 입금)
spmCd(2byte)
서브 결제 수단 코드 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)
발급 카드사명
bankCd(4byte)
은행 코드 은행 코드 바로가기
vacntNo(20byte)
가상계좌 번호
lmtDay(8byte)
입금 기한
crctReqType(1byte)
현금영수증 요청타입 0 : 미발행 1 : 소득공제 2 : 지출증빙
Last updated