결제 승인
Last updated
Last updated
본 페이지에서는 결제 승인 요청에 대해 설명합니다. 결제창 연동을 통해 인증 결과를 수신 받았다면 승인 요청을 진행해 주셔야 합니다.
URL : /payment/v1/approval Protocol : HTTP/1.1 Method : POST Encoding : UTF-8 Content-Type : Content-Type: application/json
nonce(30byte)
전문 번호
tid(30byte)
인증 거래번호
ediDate(14byte)
인증 처리 일시 형태 : YYYYMMDDHHmmss 예시) 20230914135133
mId(10byte)
상점 아이디
amount(15byte)
결제 금액
hashString
결제정보 검증 데이터 (tid + mId + ediDate + amount + orderId + 가맹점KEY) 인증 데이터 정합성을 위해 가맹점에서 HASH값 비교
payData
결제 정보 암호화 데이터
mbsReserved(500byte)
상점 예약 필드에 셋팅한 값
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
cartData(4000byte)
장바구니 데이터 JsonString (장바구니 사용 시 필수)
tid(30byte)
장바구니 거래 아이디
mId(10byte)
카드 가맹점 아이디
ordNo(100byte)
주문번호
goodsNm(15byte)
상품명
goodsAmt(15byte)
상품가격
goodsSplAmt(15byte)
상품공급가액
goodsVat(15byte)
상품부가가치세
goodsSvsAmt(15byte)
상품봉사료
fnNm(20byte)
발급 카드사명
cardNo(20byte)
카드 번호
appNo(20byte)
승인 번호
appCardCd(2byte)
카드 발급사 코드
acqCardCd(2byte)
카드 매입사 코드
quotaMon(2byte)
카드 할부개월 할부 기간(예: 00, 02, 03, …, 12, 두자리)
noIntFlg(1byte)
무이자 여부 0 : 일반 1 : 무이자
pointFlg(1byte)
포인트 사용 여부 0 : 미사용 1 : 사용
cardTypeCd(2byte)
카드 타입 코드 데이터 없으면 공백 리턴 01 : 개인 02 : 법인
chkcardFlg(1byte)
체크 카드 여부 데이터 없으면 공백 리턴 0: 신용 1: 체크
ezpAuthCd(2byte)
간편 결제사 코드, 간편결제인 아닌 경우 공백
승인 요청 후 결제 승인응답(responseBody)을 받아 가맹점 내부 처리(DB 저장 등)를 합니다. 승인 응답은 결제수단에 따라 상이하며, 승인 실패 시에는 실패에 따른 데이터만 전송됩니다.
결과 데이터는 추가될 수 있으며, 순서는 변동될 수 있습니다.
fnNm(20byte)
bankCd(4byte)
은행 코드
appNo(20byte)
crctReqType(1byte)
fnNm(20byte)
bankCd(4byte)
vacntNo(20byte)
lmtDay(8byte)
crctReqType(1byte)
