결제 승인
본 페이지에서는 결제 승인 요청에 대해 설명합니다. 결제창 연동을 통해 인증 결과를 수신 받았다면 승인 요청을 진행해 주셔야 합니다.
결제 승인 호출 데이터 예시
# 결제 승인 API 호출 예시
Method : POST
Content-Type : application/json
{
"nonce": "cpxczte60av3x20230913170406555",
"tid": "123121234m0101230913a283fae003",
"ediDate": "20230913170406",
"mId": "123121234m",
"amount" : "1004",
"mbsReserved": "MallReserved",
"hashString": "C54758756558BB9E6AA6FAAA67F121F180882D035788FE7066C466A238681762",
"payData":
}결제 승인 파라미터
결제 승인 요청
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
결제 승인 응답 (신용카드)
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)
간편 결제사 코드, 간편결제인 아닌 경우 공백 간편결제사 코드 바로가기
Last updated