search

결제 승인

본 페이지에서는 결제 승인 요청에 대해 설명합니다. 결제창 연동을 통해 인증 결과를 수신 받았다면 승인 요청을 진행해 주셔야 합니다.

hashtag
결제 승인 호출 데이터 예시

# 결제 승인 API 호출 예시
Method : POST
Content-Type : application/json

{
    "nonce": "cpxczte60av3x20230913170406555",
    "tid": "123121234m0101230913a283fae003",
    "ediDate": "20230913170406",
    "mId": "123121234m",
    "amount" : "1004",
    "mbsReserved": "MallReserved",
    "hashString": "C54758756558BB9E6AA6FAAA67F121F180882D035788FE7066C466A238681762",
    "payData":     
}

hashtag
결제 승인 파라미터

chevron-right결제 승인 요청hashtag

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)

상점 예약 필드에 셋팅한 값

chevron-right결제 승인 응답 (공통)hashtag

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

chevron-right결제 승인 응답 (신용카드)hashtag

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)

간편 결제사 코드, 간편결제인 아닌 경우 공백 간편결제사 코드 바로가기

chevron-right결제 승인 응답 (계좌이체)hashtag

fnNm(20byte)

은행명

bankCd(4byte)

은행 코드

appNo(20byte)

계좌이체 승인 번호

crctReqType(1byte)

현금영수증 요청타입 0 : 미발행 1 : 소득공제 2 : 지출증빙

chevron-right결제 승인 응답 (가상계좌)hashtag

fnNm(20byte)

은행

bankCd(4byte)

은행 코드

vacntNo(20byte)

가상계좌 번호

lmtDay(8byte)

입금 기한 형태 : yyyyMMdd 예시) 20230914

crctReqType(1byte)

현금영수증 요청타입 0 : 미발행 1 : 소득공제 2 : 지출증빙

circle-info

승인 요청 후 결제 승인응답(responseBody)을 받아 가맹점 내부 처리(DB 저장 등)를 합니다. 승인 응답은 결제수단에 따라 상이하며, 승인 실패 시에는 실패에 따른 데이터만 전송됩니다.

결과 데이터는 추가될 수 있으며, 순서는 변동될 수 있습니다.

PreviousAPI 연동Next결제 취소

Last updated